Web Services Developer's Guide → Web Services API Reference → SBM Administrative Web Services → Administrative Calls → HasGroupRole
This service checks for a specified role by name.
A boolean is returned, showing whether the group has the role (true) or not (false). Either inherited or explicitly granted roles are taken into account. The role is checked in the context of the specified group. For example:
<ae:HasGroupRoleResponse> <ae:return>true</ae:return> </ae:HasGroupRoleResponse>
You can call GetGroupRoles for a group to return a list of available roles. You can then use these roles in the HasGroupRole call.
The <urn:group> and <urn:role> parameters uniquely identify the group and role. Providing the <urn:projectId> value in the GroupIdentifier improves performance of the call, especially for the systems with several projects.
The following XML is a snippet of the payload this is sent with HasGroupRole.
<urn:HasGroupRole> <urn:auth> <urn:userId>bill</urn:userId> <urn:password></urn:password> <urn:hostname></urn:hostname> </urn:auth> <urn:group> <urn:displayName>IDM View Only</urn:displayName> </urn:group> <urn:role> <urn:displayName>IDM Manager</urn:displayName> <urn:projectId> <urn:displayName>IDM Project</urn:displayName> </urn:projectId> </urn:role> </urn:HasGroupRole>
Copyright © 2007–2018 Serena Software, Inc., a Micro Focus company. All rights reserved.