Module for the BMC Remedy AR System adapter


Each command supported by the application adapter has a corresponding process in the adapter module. Top-level processes perform high-level functions and call specialized processes in subdirectories. Each subdirectory contains process directories that correspond to the operation type for that command.

Top-level processes

The top-level processes perform high-level functions and call specialized processes in the v7.0 and v7.5 directories.

The top-level processes in the AMP-AD-BMC-Remedy-ARS adapter module in the Project Explorer window execute the following version-specific BMC Remedy AR System processes:

The following table maps the adapter processes with the required actions using the Call Adapter Activity:

Adapter processes mapped to Call Adapter actions

Adapter process

Corresponding action

Delete Entry

delete

Get Entries

query

Insert Entry

set

Query Update Entry

query-update

Reset Cache

reset-cache

Update Entry

update

Query Server Info

query-server-info

Note

  • The Delete Entry, Get Entries, Insert Entry, Query Update Entry, and the Update entry processes can add, update, retrieve, and delete an attachment.
  • The file to be attached to the form must be located on the same computer where the actor adapter is enabled.
  • Attachments retrieved using an instance of the adapter are stored on the local computer where the adapter is enabled.
  • If the attachments have same file name, the file name of the new attachment is suffixed with an index to avoid overriding the existing file at a given directory location. For example, if the file name of an attachment is attach.txt that already exists in the directory and another attached file name that has to be retrieved has the same name, then the file name is suffixed with an index indicator (attach-1.txt ), and so on.

Utilities directory

The Utilities directory contains the Translate Keys to Remedy IDs Translate Keys to Remedy IDs and Set Default Adapter Name helper and constructor processes. The functional processes require complex XML inputs. You can generate these complex XML inputs using the constructor processes in the Utilities directory.

Translate Keys to Remedy IDs

The Translate Keys to Remedy IDs process translates variable context keys to BMC Remedy Action Request System (BMC Remedy AR System) IDs. The following table describes the input parameters for the Translate Keys To Remedy IDs utility.

The [expand] macro is a standalone macro and it cannot be used inline. Click on this message for details.
The following figure shows an XML sample of the input parameters with mappings for the Translate Key To Remedy IDs utility.

The [expand] macro is a standalone macro and it cannot be used inline. Click on this message for details.
The following figure shows an XML sample of the input parameters with query mappings for the Translate Key To Remedy IDs utility.

The [expand] macro is a standalone macro and it cannot be used inline. Click on this message for details.
The following table describes the output parameters for the Translate Key To Remedy IDs utility.

Output elements for the Translate Keys to Remedy IDs process

Version directories

The v7.0 and v7.5 directories contain functional processes specific to a version of BMC Remedy AR System. A process is available for each supported operation.

  • In the v7.0 directory, the functional processes are specifically designed to interface with version 7.0 of BMC Remedy AR System.
  • In the v7.5 directory, the functional processes are specifically designed to interface with version 7.5 and later of BMC Remedy AR System.

Note

The v7.0 directory, which is the older version exists because of backward compatibility. All the processes later than BMC Remedy AR System 7.5 invoke the processes in the v7.5 directory. Therefore, for new implementations, you must use the latest version directories and mention the version number as 7.6 or later.

 

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