FRS SaaS Run QuickAction Block

Runs a QuickAction, such as calling a Web Service.

This block is for use only with SaaS application configurations. For details, refer to Ivanti Voice/SaaS Configuration.

Conditional Exits

The FRS SaaS Run QuickAction block has conditional exits to determine the action of the voice application when the following events occur:

Update failed - Due to incorrect or invalid Fields to Update or Relationships information, the QuickAction did not run.

QuickAction execution failed - The QuickAction fails to run.

Settings

The FRS SaaS Run QuickAction block has the following settings:

Label - Change the name of the block if needed to uniquely identify the use of this block in the application flowchart.

Connection (Default) - Select the name of the SaaS connection (refer to FRS SaaS Connection Configuration in the Ivanti Voice/SaaS Configuration topic).

QuickAction name - Type the name of the QuickAction the building block will execute.

Business Object Type - The type of business object to be updated. Either enter the type, or click the browse button next to the field to access the Business Object dialog box and select a type.

Business Object RecID - Type the name of the interaction property containing the business object record ID. Enclose the property name in percent (%) signs. For example: %PropertyName%.

Fields To Update Before Executing QuickAction

Determines the business object fields that will be updated before the QuickAction runs:

Field Name - Either type the name of the field to be updated, or click the browse button next to the field to access the Field Name dialog box and select a field. The fields the Field Name dialog box lists are based on the business object you selected in the Business Object Type field.

Field Value - The name of the interaction property containing the value for the field. Enclose the property name in percent (%) signs. For example: %PropertyName%

To Add Fields and Values to the Table:

Click the green + icon.

Wherever the database search syntax requires a single percent sign (%) to indicate a wildcard, use two percent signs (%%) instead of one.

Relationships To Set Before Executing QuickAction

Specify which relationships should be established for the business object, before the QuickAction runs:

Relationship name - The name of the relationship. Either type the name, or click the browse button next to the field to access the Relationship Name dialog box and select a relationship.

Child RecId - Specify the record ID of the child object in the relationship. For example, if you create an Incident and want to link the new Incident to an existing Profile, you need to specify the profile record ID in this field.

Link field name - Some business objects have one or more relationships to the same type of child object. For example, one Profile object may be linked to multiple Address objects (one person has multiple addresses). In this case, every relationship between the business object and the child object can be reflected by a unique link field, which you specify in the Link field name field. Example: When specifying the work phone for an employee, the Phone1Link field associates the phone number address record with the work phone, so you would type Phone1Link in the Link field name field.

Leave this field blank if there is no link field name for the relationship. Example: When specifying a journal entry for an employee, leave the Link field name field blank since the journal entry will appear only in the journal-related list in the tabbed information at the bottom of the screen.

To Add Fields and Values to the Table:

Click the green + icon.

Fields To Return After Executing QuickAction

This table lets you configure the block to retrieve object fields other than the record ID of objects it finds.

Field Name - The name of the field to retrieve, after the QuickAction runs. Either type the field name, or click the browse button next to the field to access the Field Name dialog box and select a field. The fields the Field Name dialog box lists are based on the business object you selected in the Objects Type field.

Property Name - The name of the interaction property in which to store the value the voice application retrieves.

To Add Fields and Values to the Table:

Click the green + icon.

When Configuration for this Block is Complete:

Click the Update button to apply the settings.