Получение идентификаторов возможностей для манифеста декларативного агента

Статья
11/13/2024

В этой статье описываются методы получения разработчиками необходимых идентификаторов для включения соединителей Graph и файлов SharePoint/OneDrive в capabilities раздел декларативного манифеста агента. Разработчики могут использовать Microsoft Graph Обозреватель или Microsoft Graph PowerShell.

Соединители Microsoft Graph

В этом разделе описывается, как разработчики могут получить значение, заданное в connection_id свойстве объекта Connection в объекте соединителей Microsoft Graph в манифесте.

Важно!

Для запроса соединителей Microsoft Graph требуется учетная запись администратора.

Песочница Graph
PowerShell

Перейдите в Microsoft Graph Обозреватель и войдите с помощью учетной записи администратора.
Выберите аватар пользователя в правом верхнем углу и выберите Согласие на разрешения.
Найдите ExternalConnection.Read.All и выберите Согласие для этого разрешения. Следуйте инструкциям, чтобы предоставить согласие.
Введите https://graph.microsoft.com/v1.0/external/connections?$select=id,name в поле запроса и выберите Выполнить запрос.
Найдите нужный соединитель и скопируйте его id свойство. Например, чтобы использовать соединитель GitHub Repos в следующем ответе githubrepos , скопируйте значение .
```
{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#connections(id,name)",
  "value": [
    {
      "id": "applianceparts",
      "name": "Appliance Parts Inventory"
    },
    {
      "id": "githubrepos",
      "name": "GitHub Repos"
    }
  ]
}
```

Скопируйте следующий код в новый файл с именем 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"
}

Откройте PowerShell 7 в каталоге, где находится GetGraphConnectorIds.ps1 , и запустите скрипт с помощью следующей команды.
```
.\GetGraphConnectorIds.ps1
```
Откройте браузер и перейдите по адресу https://microsoft.com/devicelogin. Введите код, предоставленный в командной строке, и завершите поток входа и согласия.
```
To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code BQGGRREGN to authenticate.
```
Найдите нужный соединитель и скопируйте его Id свойство. Например, чтобы использовать соединитель GitHub Repos в следующем ответе githubrepos , скопируйте значение .
```
Name                      Id
----                      --
Appliance Parts Inventory applianceparts
GitHub Repos              githubrepos
```

Получение идентификаторов SharePoint

В этом разделе описывается, как разработчики могут получить значение для задания в следующих свойствах в items_by_sharepoint_ids свойстве OneDriveAndSharePoint объекта:

site_id
list_id
web_id
unique_id

Песочница Graph
PowerShell

Перейдите в Microsoft Graph Обозреватель и войдите с помощью учетной записи администратора.
Выберите аватар пользователя в правом верхнем углу и выберите Согласие на разрешения.
Найдите Sites.Read.All и выберите Согласие для этого разрешения. Следуйте инструкциям, чтобы предоставить согласие. Повторите этот процесс для Files.Read.All.
Измените раскрывающийся список метода на POST и введите https://graph.microsoft.com/v1.0/search/query в поле запроса.

Добавьте следующий код в текст запроса, заменив https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx URL-адресом файла или папки, для которого вы хотите получить идентификаторы.

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

Выберите Выполнить запрос.

Найдите нужный файл и скопируйте его listIdсвойства , webId, siteIdи 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
        }
      ]
    }
  ]
}

Скопируйте следующий код в новый файл с именем 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"
}

Откройте PowerShell 7 в каталоге, где находится GetSharePointIds.ps1 , и запустите скрипт с помощью следующей команды, заменив https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx URL-адресом файла или папки, для которых вы хотите получить идентификаторы.
```
.\GetSharePointIds.ps1 -FilePath "https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx"
```
Откройте браузер и перейдите по адресу https://microsoft.com/devicelogin. Введите код, предоставленный в командной строке, и завершите поток входа и согласия.
```
To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code BQGGRREGN to authenticate.
```

Найдите нужный файл и скопируйте его значения.

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}

Поделиться через

Получение идентификаторов возможностей для манифеста декларативного агента

Соединители Microsoft Graph

Получение идентификаторов SharePoint

Обратная связь

Дополнительные ресурсы