Power Apps カスタムコネクタを使用しないGraph API #応用編

• GraphEndPoint_SharePointList

指定したidを持つレコードを返す「GetItem」メソッドと、アイテム一覧テーブルと次のアイテムリストへのトークンを含む単一レコード返す[GetItems]メソッドを持つコネクタを作成します。

今回はSharePoint Listに対するGraph API EndPointのレスポンススキーマが必要です。
レスポンススキーマの確認はGraph Explorerで行うことが出来ます。
SharePoint List Items を取得するエンドポイントの例は以下です。

https://graph.microsoft.com/v1.0/sites/{Site-Id}/lists/{List-Id}/items

↑のエンドポイントはリストアイテム一覧の最小限のプロパティを取得するものです。
カスタムフィールドの値を取得したい場合はさらにクエリパラメータを追加します。

https://graph.microsoft.com/v1.0/sites/{Site-Id}/lists/{List-Id}/items?$expand=fields

さらに、既定の取得数（=100）を超えた場合に「@odata.nextLink」プロパティを強制的に取得するために、クエリパラメータを追加します。（事前にリストに2件以上のアイテムを追加しておきます。）

https://graph.microsoft.com/v1.0/sites/{Site-Id}/lists/{List-Id}/items?$expand=fields&top=1

以下のようなレスポンスが返ります。

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#sites('{Site-Id}')/lists('{List-Id}')/items(fields())",
    "@odata.nextLink": "https://graph.microsoft.com/v1.0/sites/{Site-Id}/lists/{List-Id}/items?$expand=fields&top=1&$skiptoken=<skiptoken>",
    "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET sites('<guid>')/lists('<guid>')/items?$select=contentType,sharepointIds",
    "value": [
        {
            "@odata.etag": "\"<GUID>,2\"",
            "createdDateTime": "2024-04-15T06:10:31Z",
            "eTag": "\"<GUID>,2\"",
            "id": "1",
            "lastModifiedDateTime": "2024-04-15T06:10:32Z",
            "webUrl": "https://{SiteDomain}/sites/{SiteName}/Shared%20Documents/General",
            "createdBy": {
                "user": {
                    "email": "user@example.com",
                    "id": "<GUID>",
                    "displayName": "userName"
                }
            },
            "lastModifiedBy": {
                "application": {
                    "id": "<GUID>",
                    "displayName": "Microsoft Teams Services"
                },
                "user": {
                    "email": "user@example.com",
                    "id": "<GUID>",
                    "displayName": "userName"
                }
            },
            "parentReference": {
                "id": "<GUID>",
                "siteId": "{SiteDomain},<GUID>,<GUID>"
            },
            "contentType": {
                "id": "0x0120003BF3AF65D28FC843921B238BCDAE74AB",
                "name": "フォルダー"
            },
            "fields@odata.context": "https://graph.microsoft.com/v1.0/$metadata#sites('{Site-Id}')/lists('{List-Id}')/items('1')/fields/$entity",
            "fields": {
                "@odata.etag": "\"<GUID>,2\"",
                "Modified": "2024-04-15T06:10:32Z",
                "FileLeafRef": "General",
                "MediaServiceImageTags": [],
                "id": "1",
                "ContentType": "フォルダー",
                "Created": "2024-04-15T06:10:31Z",
                "AuthorLookupId": "9",
                "EditorLookupId": "9",
                "_CheckinComment": "",
                "LinkFilenameNoMenu": "General",
                "LinkFilename": "General",
                "ItemChildCount": "8",
                "FolderChildCount": "2",
                "_ComplianceFlags": "",
                "_ComplianceTag": "",
                "_ComplianceTagWrittenTime": "",
                "_ComplianceTagUserId": "",
                "_CommentCount": "",
                "_LikeCount": "",
                "_DisplayName": "",
                "AppAuthorLookupId": "1",
                "AppEditorLookupId": "1",
                "Edit": "0",
                "_UIVersionString": "1.0",
                "ParentVersionStringLookupId": "1",
                "ParentLeafNameLookupId": "1"
            }
        }
    ]
}

Graph Explorerで取得したレスポンススキーマに基づいてXMLスキーマを作成し、「GraphEndPoint_SharePointList.xml」ファイルに適用します。

既存リソースの複製とメソッド及びレスポンスサービスの定義を行います。

コネクタの定義は現段階で完了しており、再パッキングを行ってもエラーは発生しません。しかし、Power Appsにインポートした後でも、複製や修正を加えたコネクタは参照可能なコネクタとして認識されていないようです。

定義ファイルを見つけ出す

まずは、アンパックしたフォルダ内で該当するファイルを探してみます。各フォルダを開くと、関連がありそうなファイルが2つ見つかりました。それは[Connectors]フォルダの[Connections.json]ファイルと[DataSources]フォルダの[GraphEndPoint_MyProf.json]ファイルです。

これらの二つの定義ファイルについては、ファイル名と内容から推測して編集や追加を行います。

定義ファイルを修正・追加する

コネクター定義内では”DataSouces”を参照してることが推測できますので新規追加したレスポンススキーマ定義ファイル「GraphEndPoint_SharePointList.xml」の拡張子を除いた名前を追加します。

“DataSources”の参照先として「GraphEndPoint_SharePointList.json」を追加します。

以上で追加したコネクタ定義は完了しました。

しかし、アプリから見ると、まだ何かが足りないように感じます。コネクタの定義は存在しますが、アプリからそれをどこで参照するのかが不明なようです。そのために、適切な設定項目を探してみましょう。

数値.jsonファイル内にそれらしき設定が見つかりました。

このファイルに定義を追加していきます。

パッキングしてZipファイルに圧縮後インポートを行いコネクタが追加されたことを確認します。

リストアイテム一覧を取得するメソッドは正常に動作しています。

期待した結果が得られたことが確認できました。