Resource Mapping

General Information

"Resource mapping" is available within each REST call action. Using resource mapping, you can make REST call actions dynamic or variable in virtually any way. You can do this by inserting placeholders into the REST call action that can be populated from various sources. When the REST call is executed, the placeholders are populated with the values determined at the time of execution.

You can access Resource Mapping by clicking the " " icon.

Example - Dynamic Hostname

You have several hosts that you want to contact:

• host01.example.com

• host02.example.com

• host03.example.com

You can store the host ID or the host itself in the resource mapping. Later, you can specify the following hosts, for example:

Static - host01.example.com

Static and Dynamic - host${ID}.example.com

Dynamic - ${host}

Example - Email Address as a Dynamic Query Parameter

Your REST call requires the email address of the user executing the event source.

You can create a placeholder by selecting "User Value" as the resource and "Work Email" as the value.

You can now create a query parameter and select the placeholder you created.

When executing the REST call, Intrexx automatically determines the business email address of the user executing the call and includes it in the request.

You can use resource mapping in almost all text fields. When a REST call is triggered, Intrexx checks all fields for keys or placeholders and replaces them (if possible) with the currently valid value stored on the server. The replacement process proceeds from left to right and considers each key only once; therefore, "nesting" the keys is not possible. Keys that do not appear in the mapping are ignored. Keys that are "escaped" (\${myPlaceholder}) are not processed. Once defined in the mapping, a key can be used anywhere in a REST call action. If necessary, you can include multiple entries in a single post. Keys are valid only within a single REST call. They must be re-entered for each (new) action. However, it is possible to store values for keys in the processing context before execution and then reference them, so that multiple REST call actions can use the same values. At the same time, the values can be changed together within the processing context.

When replacing, only the value of the key is used; quotation marks and the like are ignored. No others are added. If quotation marks or similar characters are required (e.g., for JSON), they must be added manually. Escape quotes within values retrieved from the server are preserved as escape characters.

Create a Resource Key

Step-by-Step

To create a resource key, follow these steps:

1. Click the " " icon next to the corresponding text field.

   The "Resource Mapping" dialog box appears.

   

2. Click the " " icon.

   The "Add Resource" dialog box appears.

   

   Key

   Enter a name for the key.

   Resource

   Dynamic Dialogs: Please note that different input and selection fields are displayed depending on the resource selected.

   Select one of the following resources:

   • Static Text

   • Request

   • Processing Context (SharedState)

   • Data Group

   • System Data Group (System Data Group)

   • User Rating

   • Previous Request

   • Login Information Store (Login Information Store)

   • Parameter Memory (Parameter Memory)

3. Click "OK."

   You will return to the "Resource Mapping" dialog box.

   The resource key that was created is displayed.

   

Insert Resource Key

Step-by-Step

To insert a resource key, follow these steps:

1. Click the " " icon in the corresponding text field.

   

   The "Resource Mapping" dialog box appears.

   

2. Select the desired key.

3. Click "OK."

   The resource key is entered into the field with a leading dollar sign and curly braces (e.g., ${email-business}).