Action Executions

Form ID: (SM204007)

You use this form to configure an action execution as a subscriber for a business event that uses a data entry form as data source.

Form Toolbar

The form toolbar includes only standard buttons. For the list of standard buttons, see Form Toolbar and More Menu.

Summary Area

In this area, you can specify the settings for a new action execution or select an existing action execution for viewing and possible modification. The elements of this area are summarized below.

Element Description
Subscriber ID The string that uniquely identifies the action execution. When you are creating a new action execution, the system generates this identifier automatically, based on the value in the Subscriber Name box.
Event Screen ID Required. The generic inquiry or data entry form whose elements are used as the source of data fields for this action execution. If you are creating a new action execution, you click the magnifier icon in the box to open the Select Screen dialog box, where you can select the form by searching for it or by filtering the screens by title, screen ID, workspace, or category.
Subscriber Name Required. The short description of the subscriber. The system uses this description as a unique ID of the subscriber.
Action Screen ID A data entry form that is used as a source of action.
Action Name An action that the system executes when related business event is triggered. All actions defined in the code or in the workflow for the primary DAC of the data entry form selected in the Action Screen ID box are available for selection in this box.

Keys Tab

On the tab, the system displays the list of key fields that are required to identify a record for which the system will execute the action on the data entry form selected in the Action Screen ID box. The system will execute the action for the record. The values for these keys will be provided by the data source (inquiry or data entry form) specified for the business event, which is shown in the Event Screen ID box of the form.

The table toolbar includes only standard buttons. For the list of standard buttons, see Table Toolbar.

Table 1. Table Columns
Column Description
Screen Key Field A key field that is required to identify a record for which the system will execute the action on the data entry form selected in the Action Screen ID box.
From Schema A check box that indicates (if selected) that the value can be selected from the predefined values of the field selected in the Screen Key Field column. If a field is selected in the Screen Key Field column and you select the From Schema check box, in the Value column, a lookup box, drop-down list, or check box (depending on the control type of the selected schema field) is displayed.
Value

A value to be used by the system to identify a record for which the system will execute the action on the data entry form selected in the Action Screen ID box.

If the From Schema check box is selected in this row, the system presents the appropriate control in the Value column, and you can select the default value or select or clear the check box (if the schema field is a check box).

If the From Schema check box is cleared in this row, in the Value column, you can enter any value of the field. For a business event of the Trigger by Action type, you can also select a value of a dialog box (such as Open.Reason) that the system displays when a user invokes an action on a form.

Field Values Tab

On the tab, you can add additional fields and their values that are required for the action execution.

The table toolbar includes only standard buttons. For the list of standard buttons, see Table Toolbar.

Table 2. Table Columns
Column Description
Object Name A name of a smart panel or a dialog box that contains additional fields that are required for the action execution.
Field A field that is required to execute the action on the data entry form selected in the Action Screen ID box.
From Schema A check box that indicates (if selected) that the value can be selected from the predefined values of the field selected in the Field column. If a field is selected in the Field column and you select the From Schema check box, in the Value column, a lookup box, drop-down list, or check box (depending on the control type of the selected schema field) is displayed.
Value

A value to be used by the system to execute the action on the data entry form selected in the Action Screen ID box.

If the From Schema check box is selected in this row, the system presents the appropriate control in the Value column, and you can select the default value or select or clear the check box (if the schema field is a check box).

If the From Schema check box is cleared in this row, in the Value column, you can enter any value of the field. For a business event of the Trigger by Action type, you can also select a value of a dialog box (such as Open.Reason) that the system displays when a user invokes an action on a form.

Executed By Events Tab

You use this tab to view existing business events that trigger the selected action execution. You can also create a needed business event by clicking Create Business Event on the table toolbar of the tab.

Table 3. Table Toolbar

The table toolbar includes standard buttons and buttons that are specific to this table. For the list of standard buttons, see Table Toolbar. The table-specific buttons are listed below.

You can add a link to an existing event by clicking Add Row on the table toolbar. The system adds the template as subscriber to the added business event.

Button Description
Create Business Event Opens the Create Business Event dialog box, where you specify the name of the new business event. You click OK in the dialog box, and the system opens the Business Events (SM302050) form in the new tab with the new business event for which the template is configured as a subscriber.
Table 4. Table Columns
Column Description
Event ID The unique identifier of the business event. You can click the link in the column to open the Business Events (SM302050) form for the selected event.
Description A description of the business event.
Active A check box that indicates (if selected) that this business event is active and the system can process the subscribers specified on the Subscribers tab if this business event has occurred.
Type
The type of the business event, which can be one of the following:
  • Trigger by Record Change: The system processes the subscribers specified on the Subscribers tab when the inquiry results or data provided by the data entry form have changed in the ways that meet the conditions specified on the Trigger Conditions tab. The option is available if an inquiry form or data entry form is specified in the Screen box. For details on this type of business event, see Business Events: Data Change Processing.
  • Trigger by Schedule: At the times and frequencies specified on the Schedules tab, the system checks the results of the inquiry and processes the subscribers specified on the Subscribers tab if the inquiry results satisfy the conditions specified on the Trigger Conditions tab. The option is available if an inquiry form is specified in the Screen box. For more information about this type of business event, see Business Events: Scheduled Event Processing.
  • Trigger by Action: The system processes the subscribers specified on the Subscribers tab when a user clicks the action specified in the Action Name box for this business event. The option is available if an inquiry form or data entry form is specified in the Screen box. For details on this type of business event, see Business Events: User-Triggered Processing of Subscribers.