Technical Reference Manual - InduSoft

Appendix: Built-in Scripting Language
Syntax
DBCursorNext( numCur, "optStrErrorTag" )
numCur
The cursor handle of the result set. The cursor handle is returned by DBCursorOpen or
DBCursorOpenSQL.
optStrErrorTag
The name of a String tag that will receive detailed error messages, if errors occur during
runtime.
Note: The tag name must be enclosed in quotes, as shown in the syntax
diagram, or else the project will try to get the value of the named tag.
This is an optional parameter.
Returned value
In case of error, returns a negative number. Otherwise, returns 0.
Examples
As used in a Math worksheet:
Tag Name
Expression
nErrorCode DBCursorNext( nCursor )
DBCursorOpen
Selects a set of rows and columns in a database table, initializes the cursor at the first row of the result set,
copies that row's values to mapped tags, and then returns a cursor handle that can be referenced by other
DB/ERP functions.
Function Group Execution Windows Embedded Thin Client
DBCursorOpen Database/ERP Synchronous Supported Supported Supported
Note: This feature emulates SQL (Structured Query Language) database operations. You should be
familiar with how SQL commands are formed and executed before you use this feature.
Syntax
DBCursorOpen( strDBConn, strTable, optStrCondition, optStrColumns, optStrTags, optStrOrder,
"optStrErrorTag" )
strDBConn
strTable
The name of the database connection. Connections are configured in the Database/ERP folder.
The name of the table in the database.
optStrCondition
A string specifying which rows of the table to select. This is equivalent to the SQL WHERE
clause, and the string should follow the same syntax.
This is an optional parameter. If no rows are specified, then all rows of the table will be selected.
InduSoft Web Studio Page 743