Question
テナントにある全てのフォルダーに特定のアカウントやグループを追加したいのですが、フォルダー数が多く各フォルダーに追加する操作は手間がかかるので、一括追加する方法を教えてください。
Answer
下記公開情報に記載の Orchestrator API のエンドポイント「/odata/Folders/UiPath.Server.Configuration.OData.AssignUsers」を利用することで一括追加が可能です。
下記手順に沿って追加できるか否かをお試しください。
- 下記公開情報を参考に Swagger へアクセスします。アクセスした際「Orchestrator API」と表示されていることを確認します。
- 追加したいアカウントやグループの ID を確認するため「Users」のセクションを探して「GET /odata/Users」を展開します。
- 「Try it out」をクリックして表示される「Execute」をクリックします。
- 画面下部の Code に「200」と表示されている場合は成功です。「200」の右側に表示された Response body 右下の「コピー」をクリックします。
- 「コピー」したテキストには全てのアカウントとグループの情報が含まれているので、追加したいアカウントやグループを探して ID を確認します。下記はフルネーム「UiPath 01」と「UiPath 02」の ID を確認する例です。
︙
"FullName": "UiPath 01",
︙
"Id": 8919771,
︙
"FullName": "UiPath 02",
︙
"Id": 8919772,
︙
- 追加先のフォルダーの ID を確認するため「Folders」のセクションを探して「GET /odata/Folders」を展開します。
- 「Try it out」をクリックして表示される「Execute」をクリックします。
- 画面下部の Code に「200」と表示されている場合は成功です。「200」の右側に表示された Response body 右下の「コピー」をクリックします。
- 「コピー」したテキストには全てのフォルダーの情報が含まれているので、追加先のフォルダーを探して ID を確認します。下記はフォルダー名「Test01」と「Test02」の ID を確認する例です。
︙
"DisplayName": "Test01",
︙
"Id": 5400430
︙
"DisplayName": "Test02",
︙
"Id": 5400431
︙
- 追加先のフォルダーに対してアカウントやグループに与えたいロールの ID を確認するため「Roles」のセクションを探して「GET /odata/Roles」を展開します。
- 「Try it out」をクリックして表示される「Execute」をクリックします。
- 画面下部の Code に「200」と表示されている場合は成功です。「200」の右側に表示された Response body 右下の「コピー」をクリックします。
- 「コピー」したテキストには全てのロールの情報が含まれているので、与えたいロールの ID を確認します。下記はロール「Folder Administrator」の ID を確認する例です。
︙
"Name": "Folder Administrator",
"DisplayName": "Folder Administrator",
"Type": "Folder",
"Groups": null,
"IsStatic": true,
"IsEditable": false,
"Id": 6144536
︙
- これまで確認した ID を基に「POST /odata/Folders/UiPath.Server.Configuration.OData.AssignUsers」で実行するための body を下記例のように作成します。
{"assignments": {
"UserIds": [8919771,8919772],
"RolesPerFolder":[
{"FolderId":5400430,"RoleIds":[6144536]},
{"FolderId":5400431,"RoleIds":[6144536]}
]}
}
- 実行のため「Folders」のセクションを探して「POST /odata/Folders/UiPath.Server.Configuration.OData.AssignUsers」を展開します。
- 「Try it out」をクリックして表示される「body」に作成した body を貼り付けて「Execute」をクリックします。
- 画面下部の Code に「204」と表示されている場合は成功です。
- Orchestrator の「フォルダー」の「アカウントとグループ」タブにて、アカウントやグループが追加されており、指定したロールであることを確認します。