pp108 : getPositionUsers

getPositionUsers

This method retrieves information about the users assigned to a certain role within a team.

The use of this method is deprecated. Use GetAssignments and specify parameters UnitID and RoleDN.

SOAP Request

<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP:Body>
        <getPositionUsers xmlns="http://schemas.cordys.com/userassignment/UserAssignmentReader/1.0">
            <WorkspaceID>[Workspace ID]</WorkspaceID>
            <assignmentRoot>[Assignment root ID]</assignmentRoot>
            <unitId>[Unit ID]</unitId>
            <roleDN>[Role DN]</roleDN>
        </getPositionUsers>
    </SOAP:Body>
</SOAP:Envelope>

Request Parameters Description

Parameter

Description

Data Type

Accepted Input Value

WorkspaceID

ID of CWS Workspace

String

assignmentRoot

Assignment root ID

String

GUID

unitId

ID of the unit

String

Usually GUID

roleDN

DN of the role

String

DN

SOAP Response

<getPositionUsersResponse xmlns="http://schemas.cordys.com/userassignment/UserAssignmentReader/1.0">
    <getPositionUsers>[PositionUsers]</getPositionUsers>
</getPositionUsersResponse>

Response Parameters

Parameter

Description

getPositionUsers

String containing XML with details of users. See the sample code below.

 
<Users>
  <User>
    <Name>[User name, if available; else empty]</User>
    <Description>[User description, if available; else empty]</Description>
    <UserDN>[User DN]</UserDN>
  </User>
  <User>
    ...
  </User>
  ...
</Users>