Article published on the 31st of October, 2024.
The contents of this article may be subject to change due to ongoing development of WorkPoint Automate.
The Update team members step can be used to update the memberships of a Microsoft team related to an entity in WorkPoint.
Typically, this step is used in tandem with a "Team members form" step in which users can add or remove members of an entity's team, and the Update team members step is then used to apply these changes.
Under normal circumstances, the connection between the Team members form and the Update team members steps are created by feeding the output from the Team members form into the Step Input of the Update team members step. By doing so, the tweaks to the entity team membership done in the form will be applied by the Update team members step. However, it is also possible to update a team membership without the use of a form, because the Options for the Update team members step contains fields for Members and Owners. These fields can be hard-coded and when done so, the explicit need for the Team members form is gone. These two fields are explained in more detail in the table below.
The following image shows the settings in the "Options" tab of the Team members form step:
Step specific parameters
| Parameter name | Type | Required | Description |
|---|---|---|---|
| Options | |||
| Business module | String | Yes | Use this field to select the business module containing the entity for which you want to update Team memberships. Typically this is set to a specific business module which you know is teamified. |
| Entity | Integer | Yes | Use this field to select the internal ID of the entity on the selected business module for which you want to update Team membership. Typically this is set to the current entity by selecting Entity.ID from the context browser. |
| Group owners | Array | No | Use this field to specify an array of user principal names. The users associated with these user principal names will be added as owners to the entity's Team. It is important that the input in this field is an array type, e.g., [CurrentUser.UserPrincipalName, Entity.wpProjectManager.UserPrincipalName, ed@wp365test.onmicrosoft.com] |
| Group members | Array | No | Use this field to specify an array of user principal names. The users associated with these user principal names will be added as members to the entity's Team. It is important that the input in this field is an array type, e.g., [CurrentUser.UserPrincipalName, Entity.wpProjectManager.UserPrincipalName, ed@wp365test.onmicrosoft.com] |
Output
The following block shows an example output from the Update team members step:
No output
Comments
0 comments
Please sign in to leave a comment.