How the Create operation works when submitting new entries


External applications can use a Create operation to submit new entries into AR System server. When AR System server receives an incoming Create request, it performs the following actions:

  • Parses the incoming XML code based on the input mapping, and generates field values.
  • Creates an entry in the base form with these field values. The new entry creation triggers the OnSubmit filters.
  • After the Create action is completely successful, obtains field values from the newly created entry.
  • Uses the output mapping to generate XML code from these field values, and sends the XML document back as a response.

The output mapping might be different from the input mapping. The input mapping has the incoming data, but the output mapping has computed data, for example, the EntryId, the CreateDate, or any fields that are set by filters.

The Create operation is similar to the action of filling in a form, submitting it, and then searching for the same entry. All the rules for Submit also apply—required values must be entered, system fields cannot be submitted, and so on.

A Create operation can create only one entry in the base form. You can add it to a web service multiple times, each time specifying a unique name for the operation and a set of input and output mappings. Multiple Create operations are useful to make different operations available on the same base form to accommodate different connecting applications.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Helix Innovation Suite 25.1