Récupération des ID de fonctionnalités pour le manifeste de l’agent déclaratif

Cet article décrit les méthodes permettant aux développeurs de récupérer les ID nécessaires pour inclure des connecteurs Graph et des fichiers SharePoint/OneDrive dans la capabilities section de leur manifeste d’agent déclaratif. Les développeurs peuvent utiliser Microsoft Graph Explorer ou Microsoft Graph PowerShell.

Connecteurs Microsoft Graph

Cette section décrit comment les développeurs peuvent récupérer la valeur à définir dans la connection_id propriété de l’objet Connection dans l’objet connecteurs Microsoft Graph du manifeste.

Importante

L’interrogation des connecteurs Microsoft Graph nécessite un compte d’administrateur.

Afficheur Graph

1. Accédez à Microsoft Graph Explorer et connectez-vous avec votre compte administrateur.

   

2. Sélectionnez votre avatar utilisateur dans le coin supérieur droit, puis sélectionnez Consentement aux autorisations.

   

3. Recherchez ExternalConnection.Read.All et sélectionnez Consentement pour cette autorisation. Suivez les invites pour accorder votre consentement.

   

4. Entrez https://graph.microsoft.com/v1.0/external/connections?$select=id,name dans le champ de requête, puis sélectionnez Exécuter la requête.

   

5. Recherchez le connecteur souhaité et copiez sa id propriété. Par exemple, pour utiliser le connecteur GitHub Repos dans la réponse suivante, copiez la githubrepos valeur .

   {
     "@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. Copiez le code suivant dans un nouveau fichier nommé 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. Ouvrez PowerShell 7 dans le répertoire où se trouveGetGraphConnectorIds.ps1 et exécutez le script avec la commande suivante.

   .\GetGraphConnectorIds.ps1
   

3. Ouvrez votre navigateur et accédez à https://microsoft.com/devicelogin. Entrez le code fourni par l’invite et terminez le flux de connexion et de consentement.

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

4. Recherchez le connecteur souhaité et copiez sa Id propriété. Par exemple, pour utiliser le connecteur GitHub Repos dans la réponse suivante, copiez la githubrepos valeur .

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

Récupération des ID SharePoint

Cette section décrit comment les développeurs peuvent récupérer la valeur à définir dans les propriétés suivantes dans la items_by_sharepoint_ids propriété de l’objetOneDriveAndSharePoint :

• site_id
• list_id
• web_id
• unique_id

Afficheur Graph

1. Accédez à Microsoft Graph Explorer et connectez-vous avec votre compte administrateur.

2. Sélectionnez votre avatar utilisateur dans le coin supérieur droit, puis sélectionnez Consentement aux autorisations.

3. Recherchez Sites.Read.All et sélectionnez Consentement pour cette autorisation. Suivez les invites pour accorder votre consentement. Répétez ce processus pour Files.Read.All.

   

4. Remplacez la liste déroulante de méthode par POST et entrez https://graph.microsoft.com/v1.0/search/query dans le champ de demande.

   

5. Ajoutez ce qui suit dans le corps de la demande, en https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx remplaçant par l’URL du fichier ou du dossier pour lequel vous souhaitez obtenir les ID.

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

6. Sélectionnez Exécuter la requête.

7. Recherchez le fichier souhaité et copiez ses listIdpropriétés , webId, siteIdet 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. Copiez le code suivant dans un nouveau fichier nommé 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. Ouvrez PowerShell 7 dans le répertoire où se trouveGetSharePointIds.ps1 et exécutez le script avec la commande suivante, en https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx remplaçant par l’URL du fichier ou du dossier pour lequel vous souhaitez obtenir les ID.

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

3. Ouvrez votre navigateur et accédez à https://microsoft.com/devicelogin. Entrez le code fourni par l’invite et terminez le flux de connexion et de consentement.

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

4. Recherchez le fichier souhaité et copiez ses valeurs.

   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}