pp108 : getManagersOfUnit

getManagersOfUnit

This method returns the managers of a organization unit. A manager of a unit is defined as the user that is assigned as lead role in the unit.

SOAP Request

<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP:Body>
        <getManagersOfUnit xmlns="http://schemas.cordys.com/userassignment/UserAssignmentReader/1.0">
            <WorkspaceID>002481F0-8E9F-11E2-EE36-A5EED1105F38</WorkspaceID>
            <UnitId>001CC438-906D-11E2-EE38-EEEA14C33636</UnitId>
            <EffectiveOnly>true</EffectiveOnly>
        </getManagersOfUnit>
    </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 organization unit

Yes

GUID

EffectiveOnly

Effectiveness of assignments

Yes

If the value provided is:

  • true - command returns effective assignments only.
  • false - command returns all assignments.

This method does not accept the root ID of an assignment. It uses the default assignment root.

SOAP Response

<getManagersOfUnitResponse xmlns="http://schemas.cordys.com/userassignment/UserAssignmentReader/1.0">
    <getManagersOfUnit>
        <dataset xmlns="http://schemas.cordys.com/userassignment/UserAssignmentService/1.0">
            <Assignment xmlns="http://schemas.cordys.com/userassignment/UserAssignmentService/1.0">
                <ID>001CC438-906D-11E2-EECC-951E26303F4B</ID>
                <UserDN>cn=Jdoe,cn=organizational users,o=system,cn=cordys,cn=defaultInst,o=vanenburg.com</UserDN>
                <EffectiveDate>2013-02-13T00:00:00.0000</EffectiveDate>
                <FinishDate>2013-02-22T05:36:00.800</FinishDate>
                <IsPrincipalUnit>true</IsPrincipalUnit>
                <IsEffective>yes</IsEffective>
                <UnitID>001CC438-906D-11E2-EECC-49936ED1DF4B</UnitID>
                <QName>teams/college</QName>
                <Name>001CC438-906D-11E2-EECC-49936ED1DF4B</Name>
                <RoleDN>cn=professor,cn=organizational roles,o=system,cn=cordys,cn=defaultInst,o=vanenburg.com</RoleDN>
                <UnitRoleID>001CC438-906D-11E2-EECC-951E262FFF4B</UnitRoleID>
                <IsLeadRole>true</IsLeadRole>
                <AssignmentRoot>001CC438-906D-11E2-EECC-8FE3BE469F4B</AssignmentRoot>
            </Assignment>
        </dataset>
    </getManagersOfUnit>
</getManagersOfUnitResponse>

Response Parameters

Parameter

Description

ID

ID of an Assignment (GUID)

UserDN

DN of the user ("cn=$userName,cn=organizational users,o=system,cn=cordys,cn=$instanceName,o=$domain")

EffectiveDate

Date on which the assignment starts. If there is no start date, the effective date is taken as the default date

FinishDate

Date on which when the assignment ends. If there is no finish date, the assignment does not end

IsPrincipalUnit

Given unit is the principal unit of the user or not (true/false)

IsEffective

Assignment is effective based on the calculations from the effectiveDate and the finishDate (true/false)

UnitID

ID of the organization unit
QName Fully Qualified Name (FQN) of the organization unit
Name Name of the organization unit

RoleDN

DN of the role in the following format: cn=My_role,cn=my-isvp,cn=cordys,cn=Env1,o=cordys.com

UnitRoleID

ID of the unit-role combination

IsLeadRole

Given role is lead role of this organization unit or not (true/false)

AssignmentRoot

ID of the Assignment root