pp108 : getUnitRoles

getUnitRoles

This method returns the distinguished name of the roles within a unit.

SOAP Request

<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP:Body>
        <getUnitRoles 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>
        </getUnitRoles>
    </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

<getUnitRolesResponse xmlns="http://schemas.cordys.com/orgmodel/runtime/OrgModel/1.0">
    <getUnitRoles>
        <Roles>
            <Role>cn=professor,cn=organizational roles,o=system,cn=cordys,o=orr.com</Role>
            <Role>cn=principal,cn=organizational roles,o=system,cn=cordys,o=orr.com</Role>
        </Roles>
    </getUnitRoles>
</getUnitRolesResponse>
Response Parameters

Parameter

Description

Roles

 String containing XML that specifies roles

Role

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