transfer

Web Services Methods › Business Methods › transfer

transfer

The following parameters apply to the transfer method:

Parameter	Type	Description
SID	Integer	Identifies the session retrieved from logging in.
creator	String	Identifies the handle of the contact responsible for the activity.
objectHandle	String	Identifies the handle for a request, issue, or change order. Any other object type is rejected.
description	String	Identifies the description for the activity, which will appear in the activity log.
setAssignee	Boolean	Used to update the assignee field with the value in newAssignee, if the value is true.
newAssigneeHandle	String	Identifies the new assignee for the object.
setGroup	Boolean	Updates the group field, if true.
newGroupHandle	String	Identifies the new group for the object.
setOrganization	Boolean	Update the organization, if the value is true.
newOrgnizationHandle	String	(Issues and Change Orders only) Identifies the new organization for the object.

Description

Performs a transfer activity on an Issue, Request or Change Order. This method corresponds to the “Activities—Transfer” command in the CA SDM interface. This method generates an activity log and optionally sets a new assignee, group, or organization.

The assignee, group or organization is not updated unless one or more of the corresponding setAssignee/setGroup/setOrganization parameters is set to true.

If the companion parameter is false, then transfer will not attempt to update the field, even if a value is passed for that field. For example, if setAssignee is passed as false, transfer will not update the assignee even if newAssignee specifies a value. If the setXXXX parameter is true, then the field is updated. Pass the empty string to set a field to empty/null.

Returns

One or more handles to the activity log objects created. The returns are under a parent element named <Logs>.

XML Element	Type	Description
<LogHandle>	String	Identifies the handle for the new activity log (zero or more of these can be returned).