Appendix: Built-in Scripting Language numCur The cursor handle for the result set. The cursor handle is returned by DBCursorOpen or DBCursorOpenSQL . strColumn The name of the column. 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 Returns the value of the specified column. If the value is NULL or the cursor is invalid, then it returns an empty string with quality BAD. Examples As used in a Math worksheet:
DBCursorMoveTo Moves the cursor to the specified row in a SQL result set and copies that row's values to the mapped tags. If the specified row doesn't exist — that is, if it's outside the range of the result set — then the function returns an error code and doesn't change the mapped tags. 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 DBCursorMoveTo( numCur , numRow , " optStrErrorTag " ) numCur The cursor handle of the result set. The cursor handle is returned by DBCursorOpen or DBCursorOpenSQL .
numRow The row of the result set to which the cursor will be moved. 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. Page 624 InduSoft Web Studio Tag Name Expression Tag DBCursorGetValue( nCursor, "Column1" ) Function Group Execution Windows Embedded Thin Client DBCursorMoveT o Database/ERP Synchronous Supported Supported Supported