Technical Reference Manual - InduSoft

Background Tasks
ODBC worksheet
The ODBC interface runs in a network environment and uses the standard Windows ODBC configuration. The
ODBC task is capable of data interchange between IWS and any database supporting this interface.
Note: In addition to configuring the ODBC worksheet, you must configure the Windows ODBC
standard driver. IWS refers to the User DSN (Data Source Name), which you configure through the
Control Panel. For more information, refer to your Windows documentation.
Also, the ODBC interface is not available for projects running on Windows Embedded target
systems.
To create a new ODBC worksheet, do one of the following:
• On the Insert tab of the ribbon, in the Task Worksheets group, click ODBC;
• Right-click the ODBC folder in the Project Explorer, and then click Insert on the shortcut menu; or
• Click New on the Application menu, click the File tab, and then select ODBC Worksheet.
To edit an existing ODBC worksheet, double-click it in the Project Explorer.
A new worksheet displays, as follows.
ODBC worksheet
ODBC worksheets are executed under the ODBC Runtime task. However, creating a new worksheet does not
automatically enable the task; you must use the Execution Tasks dialog (Tasks on the Home tab of the ribbon)
to configure the task to start at runtime. For more information, please see Execution Tasks.
The ODBC worksheet is divided into two areas:
• Header area (top section), which contains information for the whole group, defines tags to start read and
write events, sets return values, handles database access parameters, and so forth; and
• Body area (bottom section), where you define each tag in the group and relate tags to fields in the current
register from the database table.
Use the Header parameters on this worksheet as follows:
• Description field: Type a description of the worksheet for documentation purposes.
• Data Source Name field: Type the same Data Source Name (DNS) specified in the Windows Control Panel
containing information about specific database access.
• User field: Type a user name to access to the database.
• Password field: Type the user's password.
• Table field: Type a table name in the database.
• Condition field: Type a search condition or filter.
• Status field: Type a return value (fill in with a tag name). The tag should report 0 for success and use
another value for an error code.
Page 312
InduSoft Web Studio