Copilot を活用した Power Automate Flow作成 #3

作成した配列をテーブルに書き込む。

この例では出力ファイル名が日々変わるため、テーブルの情報を静的に取得することはできません。
事前準備として、テンプレートファイルのテーブル名を”SharePointGroups”に設定しています。テーブル名と列情報がわかれば、列情報が一致する行を追加できます。

「Excel出力用配列(SPG)」で”Output 項目”を行として設定すると、アクションコネクタはFor eachループによって囲まれます。
これは、Power Automateが自動的に解析した結果であり、「Output 項目」がOutput配列の行データであるため、連想配列として作成された項目をそれぞれ抽出する処理です。

メンバー一覧書き出し用ワークシートとテーブルを作成する

現在、書き出し用ファイルの[SharePointGroups]ワークシート内の”SharePointGroups”テーブルに1行が追加されています。次に、現在のSharePointグループ名をワークシート名とする新しいワークシートを作成し、そのワークシートにテーブルを追加する処理を行います。

項目内の[Title]を参照する値を名前として数式に設定します。
数式内の「?」は参照を意味します。

item()?['Title']

ワークシートにテーブルを正確に作成するためには、「ワークシート名!開始セル」という形式で表の範囲を指定します。

'outputs("ワークシートを作成のアクション名")?['Body/name']'!開始セル

テーブル名は任意の値を設定します。

SharePointグループのメンバーを取得しテーブルに追加する

ここからはこれまでの内容のおさらいになります。

アクション	コネクタ
SPGメンバーの取得	Send an HTTP request to SharePoint
SPGメンバー出力用JSON	Parse JSON(JSONの解析)
SPGメンバー出力用配列	Select(選択)
表にメンバーを追加	表に行を追加

設定は上記の対応表に基づきますが、SPGメンバーの取得を除き、その他は既にこの記事で説明されているため省略します。

SharePoint REST APIに対するエンドポイント(URL)の特定

インターネットで検索すると多様な方法が見つかりますが、今回はSharePointグループを取得する際のHTTPレスポンスからメンバー一覧（users）へのURLを特定する方法を探してみます。

{
  "d": {
    "results": [
      {
        "__metadata": {
          "id": "https://siteDomain/sites/EX1_365Room/_api/Web/SiteGroups/GetById(5)",
          "uri": "https://siteDomain/sites/EX1_365Room/_api/Web/SiteGroups/GetById(5)",
          "type": "SP.Group"
        },
        "Owner": {
          "__deferred": {
            "uri": "https://siteDomain/sites/EX1_365Room/_api/Web/SiteGroups/GetById(5)/Owner"
          }
        },
        "Users": {
          "__deferred": {
            "uri": "https://siteDomain/sites/EX1_365Room/_api/Web/SiteGroups/GetById(5)/Users"
          }
        },
        "Id": 5,
        "IsHiddenInUI": false,
        "LoginName": "EX1_365Room メンバー",
        "Title": "EX1_365Room メンバー",
        "PrincipalType": 8,
        "AllowMembersEditMembership": true,
        "AllowRequestToJoinLeave": false,
        "AutoAcceptRequestToJoinLeave": false,
        "Description": null,
        "OnlyAllowMembersViewMembership": false,
        "OwnerTitle": "EX1_365Room 所有者",
        "RequestToJoinLeaveEmailSetting": ""
      },
      {...}
    ]
  }
}

“__metadata”の下に”Users”が存在し、さらに”__deferred”と”uri”というメンバが含まれていることがわかります。必要なURLは”uri”メンバの’_api’以降の部分です。このGetById()関数の括弧内には、SharePointグループのIDを指定します。

この例では、For eachループを使用しており、最初にテーブルに書き込まれた行の[‘Id’]列を参照しています。実行すると、次のようなHTTPレスポンスが返されます。

{
  "d": {
    "results": [
      {
        "__metadata": {
          "id": "https://siteDomain/sites/EX1_365Room/_api/Web/GetUserById(7)",
          "uri": "https://siteDomain/sites/EX1_365Room/_api/Web/GetUserById(7)",
          "type": "SP.User"
        },
        "Alerts": {
          "__deferred": {
            "uri": "https://siteDomain/sites/EX1_365Room/_api/Web/GetUserById(7)/Alerts"
          }
        },
        "Groups": {
          "__deferred": {
            "uri": "https://siteDomain/sites/EX1_365Room/_api/Web/GetUserById(7)/Groups"
          }
        },
        "Id": 7,
        "IsHiddenInUI": false,
        "LoginName": "c:0o.c|federateddirectoryclaimprovider|GUID-Id",
        "Title": "EX1_365Room メンバー",
        "PrincipalType": 4,
        "Email": "exsample@siteDomain",
        "Expiration": "",
        "IsEmailAuthenticationGuestUser": false,
        "IsShareByEmailGuestUser": false,
        "IsSiteAdmin": false,
        "UserId": null,
        "UserPrincipalName": null
      }
    ]
  }
}

メンバー一覧は「results」という配列要素で取得されました。このデータをJSONで解析し、配列に変換した後、事前に作成したテーブルに書き込んでいきます。

これで今回の目的は達成できました。
この記事の内容は、そのままあなたの環境に適用しても問題なく動作するので、ぜひ実際に試して、Copilotの使い方をマスターしてください。