pp108 : getRolePosition

getRolePosition

This method returns the positions and its details of a role within a unit.

SOAP Request

<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP:Body>
        <getRolePosition xmlns="http://schemas.cordys.com/orgmodel/runtime/OrgModel/1.0">
            <WorkspaceID>002481F0-8E9F-11E2-EE36-A5EED1105F38</WorkspaceID>
            <roleDN>cn=professor,cn=organizational roles,o=system,cn=cordys,cn=defaultInst,o=vanenburg.com</roleDN>
            <unitId>001CC438-906D-11E2-EE38-EEEA14C33636</unitId>
            <unitQName>organizational unit/college</unitQName>
        </getRolePosition>
    </SOAP:Body>
</SOAP:Envelope>
Request Parameters

Parameter

Description

Mandatory

Accepted Input Value
WorkspaceID Unique and valid ID of the Collaborative Workspace (CWS) No GUID or null

RoleDN

Distinguished name of the role

 Yes

DN of the role. For example, cn=My_role,cn=my-isvp,cn=cordys,cn=Env1,o=cordys.com

UnitID

ID of the unit

Yes. Either UnitID or UnitQName.

GUID. If it is provided, returns the unit corresponding to the given UnitID.

UnitQName

Fully Qualified Name (FQN) of the unit

Yes. Either UnitID or UnitQName.

If both UnitID and UnitQName are specified, it returns the unit corresponding to the given UnitID. However, if a does not exist for the given UnitID, it returns the unit corresponding to the given UnitQName.

SOAP Response

<getRolePositionResponse xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/" xmlns="http://schemas.cordys.com/orgmodel/runtime/OrgModel/1.0" readOnly="true">
  <getRolePosition>
	<Position>
		<Name>professor</Name>
		<Id>001CC438-906D-11E2-EE38-EEEA14BF7636</Id>
		<isLeader>false</isLeader>
		<roleReference>cn=professor,cn=organizational roles,o=system,cn=cordys,cn=defaultInst,o=vanenburg.com</roleReference>
		<UnitId>001CC438-906D-11E2-EE38-EEEA14C33636</UnitId>
		<UnitQName>organization unit/college</UnitQName>
		<RoleName>professor</RoleName>
		<Assignments/>
	</Position>
  </getRolePosition>
</getRolePosition>
Response Parameters

Parameter

Description

Position

String containing XML that specifies position

Name

Name of the position

Id

ID of the position

isLeader

Position that has the leadership role of the unit

roleReference

Distinguished name of the role

RoleName

Name of the role

UnitId

ID of the GUID unit

UnitQName

Fully Qualified Name (FQN) of the unit

Assignments

Assignments for the role (unit or user)