Update Entry operation
The Update Entry operation updates a field in a BMC Remedy Action Request (AR) System record with the specified value.
You can clear the following types of BMC Remedy AR System fields if and only if the Entry Mode of the field is set to optional in the application. You can specify an empty value, for example, <field name=IntegerField></field>
or specify a "$NULL$"
string in the adapter request.
- Character ( Any field that accepts characters, like description, and so on)
- Date/Time
- Date
- Time
- Currency
- Integer
- Real
- Decimal
- Selection (List, radio button, or check box)
The following table describes the input elements for the Update Entry operation:
Input elements for the Update Entry operation
Element |
Description |
Required |
|
---|---|---|---|
|
Specifies the name of the adapter in the adapter configuration that is used to execute the operation |
No |
|
|
Specifies the BMC Remedy AR System schema in which the entry is updated |
Yes |
|
|
Specifies the ID of the record to be updated |
Yes |
|
|
Specifies the BMC Remedy AR System field name or field ID of the field to be updated |
Yes |
|
|
Specifies the value to be updated in the specified field of the designated record |
Yes |
|
The following figure shows an XML sample of the input elements for the Update Entry operation:
XML sample of the input elements for the Update Entry operation
<remedy-action>
<schema>Sample:Cities</schema>
<entry-id>000000000002893</entry-id>
<values>
<field name="City"xml:space="preserve">BMC IDD Pune</field>
</values>
</remedy-action>
The following table describes the output elements for the Update Entry operation:
Output elements for the Update Entry operation
Output |
Description |
---|---|
|
Specifies the XML document returned by the adapter request executed on BMC Remedy AR System |
The following figure illustrates an XML sample of the output elements for the Update Entry operation:
XML sample of the output elements for the Update Entry operation
<entries>
<metadata>
<entry-count>1</entry-count>
</metadata>
</entries>
The following figure shows a sample adapter request for clearing a field using an "empty" field value:
Sample adapter request with an "empty" field value
<request-data>
<remedy-action>
<query>'1'="000000000000026"</query>
<schema>TestClearSelectionFields</schema>
<values>
<field name="RealNumberField"></field>
<field name="DateTimeField"></field>
<field name="DateField"></field>
<field name="TestRadio"></field>
<field name="Time Field"></field>
<field name="IntegerField"></field>
<field name="CurrencyField"></field>
<field name="Check Box Field"></field>
<field name="DecimalNumberField"></field>
<field name="Short Description">Passing Empty String</field>
<field name="TestCharacter"></field>
</values>
</remedy-action>
</request-data>
The following figure shows a sample adapter request for clearing a field using a "$NULL$" string:
Sample adapter request with an with a "$NULL$" string
request-data>
<remedy-action>
<query>'1'="000000000000026"</query>
<schema>TestClearSelectionFields</schema>
<values>
<field name="RealNumberField">$NULL$</field>
<field name="DateTimeField">$NULL$</field>
<field name="DateField">$NULL$</field>
<field name="TestRadio">$NULL$</field>
<field name="Time Field">$NULL$</field>
<field name="IntegerField">$NULL$</field>
<field name="CurrencyField">$NULL$</field>
<field name="Check Box Field">$NULL$</field>
<field name="DecimalNumberField">$NULL$</field>
<field name="Short Description">Passing NULL String</field>
</values>
</remedy-action>
</request-data>
Comments
Log in or register to comment.