テナントにある全てのフォルダーに特定のアカウントやグループを一括追加する方法を教えてください

:grey_question: Question

テナントにある全てのフォルダーに特定のアカウントやグループを追加したいのですが、フォルダー数が多く各フォルダーに追加する操作は手間がかかるので、一括追加する方法を教えてください。

:bulb: Answer

下記公開情報に記載の Orchestrator API のエンドポイント「/odata/Folders/UiPath.Server.Configuration.OData.AssignUsers」を利用することで一括追加が可能です。

下記手順に沿って追加できるか否かをお試しください。

  1. 下記公開情報を参考に Swagger へアクセスします。アクセスした際「Orchestrator API」と表示されていることを確認します。

  1. 追加したいアカウントやグループの ID を確認するため「Users」のセクションを探して「GET /odata/Users」を展開します。

  1. 「Try it out」をクリックして表示される「Execute」をクリックします。

  1. 画面下部の Code に「200」と表示されている場合は成功です。「200」の右側に表示された Response body 右下の「コピー」をクリックします。

  1. 「コピー」したテキストには全てのアカウントとグループの情報が含まれているので、追加したいアカウントやグループを探して ID を確認します。下記はフルネーム「UiPath 01」と「UiPath 02」の ID を確認する例です。
︙
      "FullName": "UiPath 01",
︙
      "Id": 8919771,
︙
      "FullName": "UiPath 02",
︙
      "Id": 8919772,
︙
  1. 追加先のフォルダーの ID を確認するため「Folders」のセクションを探して「GET /odata/Folders」を展開します。

  1. 「Try it out」をクリックして表示される「Execute」をクリックします。

  1. 画面下部の Code に「200」と表示されている場合は成功です。「200」の右側に表示された Response body 右下の「コピー」をクリックします。

  1. 「コピー」したテキストには全てのフォルダーの情報が含まれているので、追加先のフォルダーを探して ID を確認します。下記はフォルダー名「Test01」と「Test02」の ID を確認する例です。
︙
      "DisplayName": "Test01",
︙
      "Id": 5400430
︙
      "DisplayName": "Test02",
︙
      "Id": 5400431
︙
  1. 追加先のフォルダーに対してアカウントやグループに与えたいロールの ID を確認するため「Roles」のセクションを探して「GET /odata/Roles」を展開します。

  1. 「Try it out」をクリックして表示される「Execute」をクリックします。

  1. 画面下部の Code に「200」と表示されている場合は成功です。「200」の右側に表示された Response body 右下の「コピー」をクリックします。

  1. 「コピー」したテキストには全てのロールの情報が含まれているので、与えたいロールの ID を確認します。下記はロール「Folder Administrator」の ID を確認する例です。
︙
      "Name": "Folder Administrator",
      "DisplayName": "Folder Administrator",
      "Type": "Folder",
      "Groups": null,
      "IsStatic": true,
      "IsEditable": false,
      "Id": 6144536
︙
  1. これまで確認した ID を基に「POST /odata/Folders/UiPath.Server.Configuration.OData.AssignUsers」で実行するための body を下記例のように作成します。
{"assignments": {
    "UserIds": [8919771,8919772],
    "RolesPerFolder":[
        {"FolderId":5400430,"RoleIds":[6144536]},
        {"FolderId":5400431,"RoleIds":[6144536]}
    ]}
}
  1. 実行のため「Folders」のセクションを探して「POST /odata/Folders/UiPath.Server.Configuration.OData.AssignUsers」を展開します。

  1. 「Try it out」をクリックして表示される「body」に作成した body を貼り付けて「Execute」をクリックします。

  1. 画面下部の Code に「204」と表示されている場合は成功です。

image

  1. Orchestrator の「フォルダー」の「アカウントとグループ」タブにて、アカウントやグループが追加されており、指定したロールであることを確認します。

1 Like