The request, change order and issue objects all have a category field, which is used to classify the nature of the ticket. A category may have property objects, which are attached to the ticket when the category is assigned. Some of these may be marked required, which means a value must be supplied before the ticket can be saved (applies to both insert and update operations).
CA SDM Web Services automatically supplies default values for any ticket created with the Web Services. The default value (currently, “-“) is obtained from the CA SDM localized message catalog.
If you need to set property values at creation time, there are three ticket creation methods: createChangeOrder, createIssue, and createRequest. Each has a parameter with which you can pass in values for any properties. To discover which properties will be attached, you must find out the properties associated with the category you intend to assign to the ticket. The easiest method to use is getPropertyInfoForCategory().
Note: For more information about the getPropertyInfoForCategory(), see the CA SDM Technical Reference Guide.
To identify the valid values for a property, first find the property validation rule for the appropriate property template. To do this, request the validation_rule attribute when calling the getPropertyInfoForCategory method. Then, retrieve the associated validation_type for that rule. If the type is dropdown, you can then use the getRelatedList method to retrieve the values associated with the rule, using the "values" BREL attribute in the prpval_rule object.
Note: For more information, see the CA SDM Technical Reference Guide.
To set property values after an update operation with updateObject(), you must query the property list after the update. getRelatedList() can help with this task.
Validation of property values through Web Service methods is not currently supported. For example, to assign property values to a validation rule with a validation type of drop-down option, you would have to write additional code to create property values while creating the drop-down option validation rule. Do not attach a property value to a check box validation rule.
Note: For more information about property validation rules, see the Administration Guide. For information about creating property validation rules through the CA SDM interface, see the Online Help.
|
Copyright © 2013 CA.
All rights reserved.
|
|