You open the Database collection agent configuration dialog from a workflow configuration: you can right-click the agent icon and select Configuration..., or double-click the agent icon.
Source Tab
The Source tab contains configurations related to the placement and handling of the source database table and its data, as well as the UDR type to be created and populated by the agent.
| Setting | Description | |||||
|---|---|---|---|---|---|---|
UDR Type | Type of UDR to be created and populated. | |||||
Database | Profile name of the database that the agent will connect to and retrieve data from. The list is populated each time the configuration dialog is opened. For further information about database profile setup, see Database Profile[hide]2.2[/hide] (2.2). Refresh must be selected if changes have been made in the customer database. This will update the presented information in the Source tab.
| |||||
Use Default Database Schema | Select this check box to use the default database schema for the chosen database and user.
| |||||
Table Name | Name of the working table in the selected Database, in which the data to be collected resides. The list is populated each time a new Database is selected. For further information and an example of a working table, see Working Table in Tables and Stored Procedures [hide]2.2[/hide] (2.2).
| |||||
Transaction ID Column | Name of the column in the selected Table, which is utilized for the transaction ID. The list is populated each time a Table Name is selected. The column must be of the data type number, with at least twelve digits. | |||||
Remove | If enabled, this option will remove the collected data rows from the working table. If you select this option, you can also configure the Commit Window Size in the Advanced tab, which is 1000 by default. | |||||
Mark as Collected | If enabled, this option will assign the value | |||||
Run SP | If enabled, this option executes a user defined stored procedure that is responsible for the handling, most often removal, of the collected data.
For further information and an example of such a stored procedure, see After Collection Stored Procedure in Tables and Stored Procedures [hide]2.2[/hide] (2.2). | |||||
Ignore | Select to have the collected data remain in the table even after collection. Note that while the data state remains unchanged after collection, the transaction ID value is updated. By keeping the data in the table you can collect it repeatedly while designing and testing a workflow, for example. |
Assignment Tab
The Assignment tab contains the mapping of column values to UDR fields. The content and use of this tab is described in detail in Assignments in Configuration[hide]databases[/hide] Database Configuration (2.2).
If the Source tab is correctly configured and the Assignment tab is selected, the table will automatically be populated, as if Refresh was clicked. If assignments already exist in the Assignment tab, then Refresh must be manually clicked for the assignments to be updated with the configurations in the Source tab.
...
Only the value types UDR Field, To UDR and NULL, described in Value Types in Configuration[hide]databases[/hide] Database Configuration (2.2), are available for selection.
Condition Tab
In the Condition tab, query constraints may be added to limit the selection of data. The statement must follow the standard SQL WHERE-clause syntax, except for the initial where and the final semi-colon (;) which are automatically appended to the entered condition statement. It is, for instance, possible to include an order by statement to get the rows sorted.
...
In this dialog each parameter, represented as a question mark in the condition statement, appears as one row. The value types available are MIM Entry and Constant. Since constant values are also possible to be given directly in the conditionstatement, MIM Entry is most likely to be used here.
Advanced Tab
The Advanced tab contains a setting for performance tuning and allows viewing of the generated SQL statement, based on the configuration in the Source, Assignment and Condition tabs.
...