This request allows you to update the roles for a project to reflect changes made to the Microsoft user groups upon which the group or role is based, or changes made to the access rights for a role.
Use the POST method to refresh a user list with the following input:
-
Service Root URI: https://<Server Name>/<IIS Application Name>/sem/v3
-
Resource path: /Sites('<Site Name>')/Plants('<Plant Name>')/Projects('<Project Name>')/Com.Ingr.Sem.V2.RefreshUsers/
-
Resource path strings are case-sensitive.
-
The backslash at the end of the resource path is mandatory.
Sample URI
POST
https://WebApiServer1.APIServerDomain.com/sem-webapi/sem/v3/Sites('WebAPISite01')/Plants('WebAPIPlant01')/Projects('P1')/Com.Ingr.Sem.V2.RefreshUsers/
Sample JSON request
The role's Id value can be obtained by running the View project roles request.
{
"Roles":
[
{
"Id": [ "0C85E220061D446A8A209F24C44DE1E4"]
}
]
}
Sample JSON response
A typical response to the request is:
{
"@odata.context": "https://localhost/sem-webapi/sem/v3/$metadata#Com.Ingr.Sem.V2.RefreshUsersResult",
"Roles":
[
{
"RoleId": "0C85E220061D446A8A209F24C44DE1E4",
"RoleName": "Companydomain.com/Project Engineers",
"IsRefreshed": true
},
{
"RoleId": "0EC7C1552BB117047F441A114D4C89D6",
"RoleName": "Companydomain.com/Project Supervisors",
"IsRefreshed": false
}
]
}
In the above example, only the first role was refreshed, as shown by the status of
the 'IsRefreshed' parameter for each role.