Services configured with the Create template create entries in the AR System database.

At design time, you identify the AR System form that the Create adapter service is to use. Based on the form you select, Remedy Adapter loads the appropriate fields into the adapter service template. You select the fields that are needed for the entries that the service will create. The input signature of the Create adapter service is based on the form fields that you select. The output signature of the Create adapter service is the entry ID of the newly created entry; you cannot modify the output signature.

At run time, the Create adapter service uses the AR System Java APIs to create a new entry in the AR System database. The new entry has the format that is defined by an AR System form, which you identified when you configured the Create adapter service. The form identifies the fields that make up the entry. The Create adapter service retrieves the values for the fields from the pipeline.

If the Create operation is successful, the adapter service returns a String that contains the entry ID for the newly created entry. If the operation is unsuccessful, the adapter service throws an AdapterException or AdapterConnectionException. For more information about how the adapter handles exceptions, see Adapter Logging and Exception Handling.