Configuring Event Handler Input Maps
The Input Maps tab inherits a list of rows which reflect all input properties configured on the process flow selected. Each input map describes data that is used and may be required for proper functionality of the process flow. Configuration of the input maps tells the system how to access the necessary data.
You can configure the input maps directly in the grid on the Input Maps tab or you can double-click the individual rows to display an Edit Mapping dialog box. Required input properties appear in red. You must provide a source value for these properties.
The Input Map populates automatically for Global Event Handlers and cannot be edited by a user. See Capturing Message Details from a Message Run for Use in a Process Flow for an example of a Global event handler using the AfterSendMessage Event.
Follow these steps to configure an input map:
- Select Source Type for the input map. Available values are:
- Static Value: The system uses the alphanumeric text entered in the Source field.
- Entity Field: The system uses the current record's value from a specified field in the entity to which the event handler is attached.
- For example, if saving a new Entities record fired the Event Handler, this option retrieves the specified field's value from that new record and adds it to the Context Object so it is available to the Process Flow.
- For example, if saving a new Entities record fired the Event Handler, this option retrieves the specified field's value from that new record and adds it to the Context Object so it is available to the Process Flow.
- SQL Statement: The system obtains a value for the input map by executing a specified SQL statement.
- GE Object: The system obtains a value for the input map from the Generic Entity (GE) object.
- For this option, the source is automatically set to the GE Object, and the user may not specify a value for the source.
This setting is suitable if a developer has created a Process Component that obtains record information from the Generic Entity interface.
Enter a Source for the input map. The format of the value for the Source field is dependent on the Source Type selected:
- Source Type of Static Value: Enter an alphanumeric text statement. To include field data from the entity record that fired the event within the text, surround the field name with field tags (<%field name%>).
- Source Type of Entity Field: Enter the name of a field within the entity to which the event is linked. The Event Handler retrieves the field value from the current record that fired the event.
- Source Type of SQL Statement: Enter a SQL statement to derive the data.
- Source Type of GE Object: The Source field is populated automatically with the GE Object entry.
- Enter Comments for each input map as necessary (optional).
- After configuring all of the input maps, click OK to save and close the record.
Copyright © 2014-2017 Aptify - Confidential and Proprietary