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
`<adapter name>`	Specifies the name of the adapter in the adapter configuration that is used to execute the operation Default value: ARSAdapter	No
`<schema name>`	Specifies the BMC Remedy AR System schema in which the entry is updated	Yes
`<entry id>`	Specifies the ID of the record to be updated	Yes
`<updated field>`	Specifies the BMC Remedy AR System field name or field ID of the field to be updated	Yes
`<value>`	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
`<adapter response>`	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>

Update Entry operation

Comments