Links
Comment on page

Configuration

This section explains each of the properties in the configuration blade.

General

Property
Description
Collection
This associates this Agent to a specific Collection and defaults to that of the current Data Stream.
Visit Collections and Stream Hosts to understand more about Collections.

Server

Property
Description
Use Connection Variables
Tick to select saved variables; or enter the text manually for the authentication properties.
Server Instance
The address of the SQL Server server instance.
User Name
The user name to use for authenticating the connection.
Use SQL Server Authentication
Enables SQL Server Authentication instead of Windows Authentication. This will allow you to specify the Password for authentication of the connection.
Password
The password to use for authenticating the connection.
Once all the Server properties are entered, the Agent will attempt to open a connection with the database server. If successful, then the Database property will be populated with a list of available databases to select.

Database

Property
Description
Database
The name of the database to connect to. Once selected, the Table property will be populated with the list of available tables in the database.
Table
The name of the table to connect to. Once selected, the Columns To Return property will be populated with the list of columns from the selected table.
Use Stored Procedure
Executes a Stored Procedure (already defined in the database) instead of writing to a table.
Stored Procedure
Displays a list of available Stored Procedures. Select the Stored Procedure that the action Agent should execute. Applies if Use Stored Procedure is ticked.
Return Result As
Choose whether the results should be appended to the input data or replace the input data as a new dataset. Applies if Use Stored Procedure is ticked.
Create New Table
Creates a new table in the database before writing data to it.
Table Name
The name of the new table that should be created. Applies if Create New Table is ticked.
Command
The operation the Agent should perform, either Insert or Update.
Fire Database Triggers on Insert (if defined)
Allows the database to execute any Insert Triggers that might be define in the database when the data is inserted into the table.
Command Timeout (secs)
A timespan to specify the timeout before a command is aborted.

Endpoints

Property
Description
Input
This Endpoint is used to receive data from the parent Agent.
Output
Events received from the parent Agent are processed and the result events are made available to the Endpoint. These events are the same as the input events unless the Agent is configured to execute a Stored Procedure, in which case the output will match the payload of the Stored Procedure.
Error
If errors are encountered during the execution of this Agent they will be published on this Endpoint.
If the events passed to the Action Agent require further processing in the Data Stream, and the Action Agent is configured to execute a Stored Procedure, split the Data Stream beforehand with a Broadcast Transformation.