Previous Topic: getValidTaskTransitionsNext Topic: getDependentAttrControls


getValidTransitions

The getValidTransitions method lets you list the transitions for a ticket.

The following parameters apply:

Parameter

Type

Description

SID

Integer

Identifies the session retrieved from logging in.

handle

String

Identifies the handle for a ticket or status. If a ticket handle is provided, the method retrieves the valid transitions for the current status of the ticket.

ticketFactory

String

Identifies the factory of the ticket. Valid values are only “cr” for Request, “in” for Incident, “pr” for Problem, “chg” for Change Order and “iss” for Issue.

Description

Returns all of the possible transition values for the status of a ticket. Administrators can configure valid status transitions for all ticket types.

Returns zero or more request/incident/problem/change/issue transition objects, depending on the values passed for handle and ticketFactory. If zero objects are returned, there are no transitions on the status of the ticket.

Returns

This method has the following return:

XML Element

Type

Description

<UDSObjectList>

N/A

Identifies the outer element, which contains zero or more <UDSObject> elements.