pp108 : getManagersOfUser

getManagersOfUser

This method returns the details of the manager of a user. For different cases, the definition of the manager is as follows:

  • If the user has a lead role in the principal unit, then the manager of the parent organization unit is considered.
  • If the user has a non-lead role in the principal unit, then the user who is assigned the lead-role in this unit is considered as the manager.
  • If an organization unit has no lead role or if there is no user assigned to the lead role, the manager of the parent unit is returned. If there is no manager in the parent unit also, the details of the manager of the parent's parent unit is returned (recursively).

Note: There can be more than one user to whom the lead role is assigned.

SOAP Request

<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP:Body>
        <getManagersOfUser xmlns="http://schemas.cordys.com/userassignment/UserAssignmentReader/1.0">
            <WorkspaceID>002481F0-8E9F-11E2-EE36-A5EED1105F38</WorkspaceID>
            <UserDN>cn=Adam,cn=organizational users,o=system,o=orr.com</UserDN>
            <EffectiveOnly>false</EffectiveOnly>
        </getManagersOfUser>
    </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

UserDN

DN of the user whose manager details are requested

Yes

LDAP UserDN in the following format: cn=$userName,cn=organizational users,o=system,cn=cordys,cn=$instanceName,o=$domain

EffectiveOnly

Effectiveness of assignments

Yes

If the value provided is:

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

Note:

SOAP Response

<getManagersOfUserResponse readOnly="true"
    xmlns="http://schemas.cordys.com/userassignment/UserAssignmentReader/1.0" xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">
    <getManagersOfUser>
        <dataset xmlns="http://schemas.cordys.com/userassignment/UserAssignmentService/1.0">
            <Assignment xmlns="http://schemas.cordys.com/userassignment/UserAssignmentService/1.0">
                <ID>001CC438-906D-11E2-F18F-1D381C84B319</ID>
                <UserDN>cn=JDoe,cn=organizational users,o=system,o=orr.com</UserDN>
                <EffectiveDate>2013-03-11T00:00:00.0000</EffectiveDate>
                <FinishDate>2013-03-28T07:29:30.000</FinishDate>
                <IsPrincipalUnit>true</IsPrincipalUnit>
                <IsEffective>yes</IsEffective>
                <UnitID>001CC438-906D-11E2-F18E-E3A1805A9319</UnitID>
                <QName>teams/college</QName>
                <Name>001CC438-906D-11E2-EECC-49936ED1DF4B</Name>
                <RoleDN>cn=Manager,cn=organizational roles,o=system,o=orr.com</RoleDN>
                <UnitRoleID>001CC438-906D-11E2-F18F-1D381C847319</UnitRoleID>
                <IsLeadRole>true</IsLeadRole>
                <AssignmentRoot>001CC438-906D-11E2-F175-9C2093B9F319</AssignmentRoot>
            </Assignment>
            <Assignment xmlns="http://schemas.cordys.com/userassignment/UserAssignmentService/1.0">
                <ID>001CC438-906D-11E2-F18F-21DB8E07B319</ID>
                <UserDN>cn=Mike,cn=organizational users,o=system,o=orr.com</UserDN>
                <EffectiveDate/>
                <FinishDate/>
                <IsPrincipalUnit>false</IsPrincipalUnit>
                <IsEffective>yes</IsEffective>
                <UnitID>001CC438-906D-11E2-F18E-E3A1805A9319</UnitID>
                <QName>teams/college</QName>
                <Name>001FF438-906D-11E2-EECC-89936FD1DY4C</Name>
                <RoleDN>cn=Team Lead,cn=organizational roles,o=system,o=orr.com</RoleDN>
                <UnitRoleID>001CC438-906D-11E2-F18F-1D381C847319</UnitRoleID>
                <IsLeadRole>true</IsLeadRole>
                <AssignmentRoot>001CC438-906D-11E2-F175-9C2093B9F319</AssignmentRoot>
            </Assignment>
        </dataset>
    </getManagersOfUser>
</getManagersOfUserResponse>
Response Parameters

Parameter

Description

ID

ID of the user assignment (GUID)

UserDN

DN of the user in the following format: 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 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 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

Lead role of this organization unit or not (true/false)

AssignmentRoot

ID of the Assignment root