The following parameters apply to the updateObject method:
|
Parameter |
Type |
Description |
|---|---|---|
|
SID |
Integer |
Identifies the session retrieved from logging in. |
|
objectHandle |
String |
Identifies the handle of a CA SDM object to update. |
|
attrVals |
String[] |
Identifies the name-value pairs for the update. |
|
attributes |
String[] |
Identifies the sequence of attribute names from the object for which to return values. Dot-notation is permitted. If this field is empty, all attribute values are returned. |
Description
Updates one or more attributes for the specified object.
To set values for the object, the caller passes a single-dimensional array of attribute name-value pairs. The first half of the pair is an attribute name; the second is the actual value. Dotted-names are not permitted.
To update an attribute that is a Pointer type (for example, the customer field on a request) a handle must be used for the value. For Integer, Date, and Duration types, pass the string representation of an integer.
For example, to update a request with a new assignee, description and priority, the array would appear as follows:
[0] - “assignee”
[1] - “cnt:555A043EDDB36D4F97524F2496B35E75” (a contact Handle)
[2] - “description”
[3] - “My new description”
[4] - “priority”
[5] - “pri:38903” (a priority Handle)
If the update fails for any reason, the entire operation aborts and no changes occur.
Note: When updating a task, set the status value last in the attribute array.
Returns
A <UDSObject> element containing the updated object’s handle, along with attribute values specified in the attributes parameter. If the attributes parameter is empty, all of the attribute values are returned. List and LREL types are also returned, but as empty elements.
The following parameters apply to the getArtifact method:
|
Parameter |
Type |
Description |
|---|---|---|
|
SID |
Integer |
Identifies the session retrieved from logging in. |
|
contact |
String |
Identifies the name of the user associated with the returned ARTIFACT. Note: This is the system login name, not the contact name for CA Service Desk Manager. |
|
password |
String |
Identifies the password. |
Description
Facilitates the building of Web Interface URLs, which may be used to launch the Web Interface in the context of a given user without a login challenge. The URL may look similar to the following:
http://host/CAisd/pdmweb.exe?USERNAME=xxxxx+ARTIFACT=nnnnn+OP=xxxx....
To launch the Web Interface in the context of a given user (for example, an analyst), a calling application must first construct a Web Interface URL, which includes an CA EEM ARTIFACT token (a web-interface security token). Failure to provide a CA EEM ARTIFACT token may result in an interactive login challenge when attempting to launch the Web Interface in the chosen context (such as, a detail view of a given ticket). The getArtifact method allows the CA EEM ARTIFACT to be generated in the context of the user provided by the contact parameter.
Note: Service Desk needs to be integrated with CA EEM to perform this operation.
Returns
An CA EEM ARTIFACT based on the name of the user entered. You can use the ARTIFACT to launch the Web Interface only once.
|
Copyright © 2013 CA.
All rights reserved.
|
|