pp108 : SetAutoDelegationsForUser

SetAutoDelegationsForUser

This method is used to set auto delegation of tasks when the user is out of office.

SOAP Request

<SetAutoDelegationsForUser xmlns="http://schemas.cordys.com/notification/autodelegation/1.0">
    <UserDN>cn=user1,cn=organizational users,o=system,cn=cordys,cn=defaultInst,o=vanenburg.com</UserDN>
    <Delegates>
        <Delegate>
            <FromDate>2011-05-06T12:30:00</FromDate>
            <ToDate>2011-05-07T12:30:00</ToDate>
            <Message>First day substitute</Message>
            <DelegatedTo>cn=user2,cn=organizational users,o=system,cn=cordys,cn=defaultInst,o=vanenburg.com</DelegatedTo>
        </Delegate>
        <Delegate>
            <FromDate>2011-05-08T00:00:00</FromDate>
            <ToDate>2011-05-10T00:00:00</ToDate>
            <Message>Second day substitute</Message>
            <DelegatedTo>cn=user3,cn=organizational users,o=system,cn=cordys,cn=defaultInst,o=vanenburg.com</DelegatedTo>
        </Delegate>
    </Delegates>
</SetAutoDelegationsForUser>

Request Parameters

Parameter

Description

Required?

UserDN

Refers to the DN of the organization of the User

Optional. If it is left empty, then the DN of the current user is assumed. If users want to set delegation for other users, they must have the Notification Admin Role.

FromDate

Refers to the date from which the delegation is set.

Mandatory. In case of setting multiple delegations for same user, if there is an overlap between from and to dates, SOAP Fault will be generated. It accepts the date in milliseconds.

ToDate

Refers to the date on which the delegation must end.

Mandatory. It accepts the date in milliseconds too.

Message

Refers to the reason for Auto delegation.

Optional.

DelegateTo

Refers to the DN of the Delegated user.

Mandatory.

SOAP Response

<SetAutoDelegationsForUsersResponse>
    <UserDN>cn=user1,cn=organizational users,o=system,cn=cordys,cn=defaultInst,o=vanenburg.com</UserDN>
    <Delegates>
        <Delegate>
            <DelegationId>001CC438-906D-11E0-ED35-B202C100140F</DelegationId>
            <FromDate>2011-05-06T12:30:00</FromDate>
            <ToDate>2011-05-07T12:30:00</ToDate>
            <Message>First month substitute</Message>
            <DelegatedTo>cn=user2,cn=organizational users,o=system,cn=cordys,cn=defaultInst,o=vanenburg.com</DelegatedTo>
            <Status>Active|Completed|Planned</Status>
            <!-- Indicates whether or not the delegate is currently Active or Completed or Planned -->
            <LastModified>1303187955294</LastModified>
        </Delegate>
        <Delegate>
            <DelegationId>001CC438-906D-11E0-ED35-FE202DS3302</DelegationId>
            <FromDate>2011-05-08T00:00:00</FromDate>
            <ToDate>2011-05-10T00:00:00</ToDate>
            <Message>Second month substitute</Message>
            <DelegatedTo>cn=user3,cn=organizational users,o=system,cn=cordys,cn=defaultInst,o=vanenburg.com</DelegatedTo>
            <Status>Active|Completed|Planned</Status>
            <!-- Indicates whether or not the delegate is currently Active or Completed or Planned -->
            <LastModified>1303187955296</LastModified>
        </Delegate>
    </Delegates>
</SetAutoDelegationsForUsersResponse>

Response Parameters

Parameter

Description

UserDN

Contains the DN of the User.

DelegationId

Contains the ID of the newly created delegation.

FromDate

Contains the date from which the delegation is set.

ToDate

Contains the date on which the delegation must end.

Message

Contains the reason for Auto delegation.

DelegateTo

Contains the DN of the Delegated user.

Status

Contains the current status of the delegation.

LastModified

Contains the last modified time of the delegation in milliseconds.