pp108 : getUnitPositions

getUnitPositions

This method returns the positions within a unit. The position means the role in that particular unit.

SOAP Request

<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP:Body>
        <getUnitPositions xmlns="http://schemas.cordys.com/orgmodel/runtime/OrgModel/1.0">
            <WorkspaceID>002481F0-8E9F-11E2-EE36-A5EED1105F38</WorkspaceID>
            <unitId>001CC438-906D-11E2-EE38-EEEA14C33636</unitId>
            <unitQName>organization unit/college</unitQName>
        </getUnitPositions>
    </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

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 unit does not exist for the given UnitID, it returns the unit corresponding to the given UnitQName.

SOAP Response

<getUnitPositionsResponse xmlns="http://schemas.cordys.com/orgmodel/runtime/OrgModel/1.0">
    <getUnitPositions>
        <Positions>
            <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>
            <Position>
                <Name>principal</Name>
                <Id>001CC438-906D-11E2-EE38-EEEA14BF1636</Id>
                <isLeader>true</isLeader>
                <roleReference>cn=principal,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>principal</RoleName>
                <Assignments/>
            </Position>
        </Positions>
    </getUnitPositions>
</getUnitPositionsResponse>
Response Parameters

Parameter

Description

Positions

String containing XML that specifies positions

Name

 Name of position. The role in that particular unit.

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