Sqlcursor

Submits an SQL (Structured Query Language) statement to a database server and returns a multi-row result.

Supported Script Types

Generic Email Chat Phone Voicemail Work Item SMS

Properties

Property Details
SQLQuery

The SQL statement that will be submitted to the database server. This statement should be expected to return records.

GlobalVariables Not used.
Publish

Publishes a variable and value from the last name that is retrieved. For example, if there were 3 names retrieved, only data from the last name would be published.

TimeoutSec The amount of seconds that the action will wait to execute before timing out. The value must be between 0 and 60.

Branches

Branch Details

Default

Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the other branches are not defined.
NoRecords Path taken if there are no values for the specified properties.
OnError Path taken when an action fails to execute properly.

Tips & Tricks

  • Use Sqlcursor for the same purpose as Sqlselect when multiple rows are expected.
  • This action does not retrieve all the rows at once. Instead, the dataset is opened and kept open for repetitive access.
  • As with Sqlcursor, each column is stored in a variable with the same name as the column. Initially, the first record will be fetched. To fetch consecutive records, execute Sqlnext repeatedly until Sqlnext triggers its End of Dataset branch condition.
  • If the script does not need to continue fetching all records, place the Sqlclose action after the End of Dataset branch condition. This will manually close the dataset. This ensures that the database memory is released and potential record locks will not be left active.