Recuperación de identificadores de funcionalidades para el manifiesto de agente declarativo

En este artículo se describen los métodos para que los desarrolladores recuperen los identificadores necesarios para incluir conectores de Graph y archivos de SharePoint/OneDrive dentro de la capabilities sección de su manifiesto de agente declarativo. Los desarrolladores pueden usar El Explorador de Microsoft Graph o PowerShell de Microsoft Graph.

Conectores de Microsoft Graph

En esta sección se describe cómo los desarrolladores pueden recuperar el valor que se va a establecer en la connection_id propiedad del objeto Connection del objeto conectores de Microsoft Graph del manifiesto.

Importante

La consulta de conectores de Microsoft Graph requiere una cuenta de administrador.

Explorador de Graph

1. Vaya al Explorador de Microsoft Graph e inicie sesión con su cuenta de administrador.

   

2. Seleccione el avatar de usuario en la esquina superior derecha y seleccione Consentimiento para permisos.

   

3. Busque ExternalConnection.Read.All y seleccione Consentimiento para ese permiso. Siga las indicaciones para conceder el consentimiento.

   

4. Escriba https://graph.microsoft.com/v1.0/external/connections?$select=id,name en el campo de solicitud y seleccione Ejecutar consulta.

   

5. Busque el conector que desea y copie su id propiedad. Por ejemplo, para usar el conector repositorios de GitHub en la siguiente respuesta, copie el githubrepos valor.

   {
     "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#connections(id,name)",
     "value": [
       {
         "id": "applianceparts",
         "name": "Appliance Parts Inventory"
       },
       {
         "id": "githubrepos",
         "name": "GitHub Repos"
       }
     ]
   }
   

PowerShell

1. Copie el código siguiente en un nuevo archivo denominado GetGraphConnectorIds.ps1.

   param(
       [Parameter(Mandatory = $false)]
       [Switch]
       $StayConnected = $false
   )
   
   # Requires an admin
   Connect-MgGraph -Scopes "ExternalConnection.Read.All" `
       -UseDeviceCode -ErrorAction Stop -NoWelcome
   
   Get-MgExternalConnection -Property "Name", "Id" | Format-Table "Name", "Id"
   
   if ($StayConnected -eq $false) {
       Disconnect-MgGraph | Out-Null
       Write-Host "Disconnected from Microsoft Graph"
   }
   else {
       Write-Host
       Write-Host -ForegroundColor Yellow `
           "The connection to Microsoft Graph is still active. To disconnect, use Disconnect-MgGraph"
   }
   

2. Abra PowerShell 7 en el directorio donde se encuentra GetGraphConnectorIds.ps1 y ejecute el script con el siguiente comando.

   .\GetGraphConnectorIds.ps1
   

3. Abra el explorador y vaya a https://microsoft.com/devicelogin. Escriba el código proporcionado por el símbolo del sistema y complete el flujo de inicio de sesión y consentimiento.

   To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code BQGGRREGN to authenticate.
   

4. Busque el conector que desea y copie su Id propiedad. Por ejemplo, para usar el conector repositorios de GitHub en la siguiente respuesta, copie el githubrepos valor.

   Name                      Id
   ----                      --
   Appliance Parts Inventory applianceparts
   GitHub Repos              githubrepos
   

Recuperación de identificadores de SharePoint

En esta sección se describe cómo los desarrolladores pueden recuperar el valor que se va a establecer en las siguientes propiedades dentro de la items_by_sharepoint_ids propiedad del OneDriveAndSharePoint objeto :

• site_id
• list_id
• web_id
• unique_id

Explorador de Graph

1. Vaya al Explorador de Microsoft Graph e inicie sesión con su cuenta de administrador.

2. Seleccione el avatar de usuario en la esquina superior derecha y seleccione Consentimiento para permisos.

3. Busque Sites.Read.All y seleccione Consentimiento para ese permiso. Siga las indicaciones para conceder el consentimiento. Repita este proceso para Files.Read.All.

   

4. Cambie la lista desplegable de métodos a POST y escriba https://graph.microsoft.com/v1.0/search/query en el campo de solicitud.

   

5. Agregue lo siguiente en el cuerpo de la solicitud, reemplazando https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx por la dirección URL al archivo o carpeta para el que desea obtener los identificadores.

   {
     "requests": [
       {
         "entityTypes": [
           "driveItem"
         ],
         "query": {
           "queryString": "Path:\"https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx\""
         },
         "fields": [
           "fileName",
           "listId",
           "webId",
           "siteId",
           "uniqueId"
         ]
       }
     ]
   }
   

6. Seleccione Ejecutar consulta.

7. Busque el archivo que desee y copie sus listIdpropiedades , webId, siteIdy uniqueId .

   {
     "value": [
       {
         "searchTerms": [],
         "hitsContainers": [
           {
             "hits": [
               {
                 "hitId": "01AJOINAHZHINTBHPESZBISPIPSJG3D5EO",
                 "rank": 1,
                 "summary": "Reorder policy Our reorder policy for suppliers is straightforward and designed to maintain cost-efficiency and inventory control. We kindly request that no order exceeds a total",
                 "resource": {
                   "@odata.type": "#microsoft.graph.driveItem",
                   "listItem": {
                     "@odata.type": "#microsoft.graph.listItem",
                     "id": "301b3af9-e49d-4296-893d-0f924db1f48e",
                     "fields": {
                       "fileName": "YourFile.docx",
                       "listId": "12fde922-4fab-4238-8227-521829cd1099",
                       "webId": "a25fab47-f3b9-4fa3-8ed9-1acb83c12a4f",
                       "siteId": "5863dfa5-b39d-4cd1-92a6-5cf539e04971",
                       "uniqueId": "{301b3af9-e49d-4296-893d-0f924db1f48e}"
                     }
                   }
                 }
               }
             ],
             "total": 1,
             "moreResultsAvailable": false
           }
         ]
       }
     ]
   }
   

PowerShell

1. Copie el código siguiente en un nuevo archivo denominado GetSharePointIds.ps1.

   param(
       [Parameter(Mandatory = $true,
       HelpMessage = "The URL path to the file or folder to search for")]
       [String]
       $FilePath,
   
       [Parameter(Mandatory = $false)]
       [Switch]
       $StayConnected = $false
   )
   
   Connect-MgGraph -Scopes "Sites.Read.All Files.Read.All" `
       -UseDeviceCode -ErrorAction Stop -NoWelcome
   
   $searchQuery = @{
       requests = @(
           @{
               entityTypes = @("driveItem")
               query = @{
                   queryString = "Path:""" + $FilePath +  """"
               }
               fields = @(
                   "fileName"
                   "listId"
                   "webId"
                   "siteId"
                   "uniqueId"
               )
           }
       )
   }
   
   $results = Invoke-MgQuerySearch -Body $searchQuery
   
   foreach($hitContainer in $results.HitsContainers)
   {
       foreach($hit in $hitContainer.Hits)
       {
           Write-Output $hit.Resource.AdditionalProperties["listItem"]["fields"] | Format-Table
       }
   }
   
   if ($StayConnected -eq $false) {
       Disconnect-MgGraph | Out-Null
       Write-Host "Disconnected from Microsoft Graph"
   }
   else {
       Write-Host
       Write-Host -ForegroundColor Yellow `
           "The connection to Microsoft Graph is still active. To disconnect, use Disconnect-MgGraph"
   }
   

2. Abra PowerShell 7 en el directorio donde se encuentra GetSharePointIds.ps1 y ejecute el script con el siguiente comando, reemplazando https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx por la dirección URL del archivo o carpeta para el que desea obtener los identificadores.

   .\GetSharePointIds.ps1 -FilePath "https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx"
   

3. Abra el explorador y vaya a https://microsoft.com/devicelogin. Escriba el código proporcionado por el símbolo del sistema y complete el flujo de inicio de sesión y consentimiento.

   To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code BQGGRREGN to authenticate.
   

4. Busque el archivo que desee y copie sus valores.

   Key      Value
   ---      -----
   fileName YourFile.docx
   listId   12fde922-4fab-4238-8227-521829cd1099
   webId    a25fab47-f3b9-4fa3-8ed9-1acb83c12a4f
   siteId   5863dfa5-b39d-4cd1-92a6-5cf539e04971
   uniqueId {301b3af9-e49d-4296-893d-0f924db1f48e}