SQLAssociate (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Retrieving the value of a column
Transferring the content of the query into a table
Retrieving Float items on Oracle (via ODBC)
Using tabulations in the items

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

SQLAssociate (Function)

In french: SQLAssocie

Automatically associates each column of the query result with a control or with a variable of the application. Once SQLAssociate has been run, the result of the query must be browsed: the assignment of the controls or variables will be performed for each record read.

Remark: This function must be used during a "SQLFirst/SQLCol" browse. See Types of SQL browse for more details.

Example

ResExec is boolean
ResExec = SQLExec("SELECT CUSTNAME,ADDR1,ADDR2,CITY,ZC FROM INV", "QRY2")
IF ResExec = True THEN
        SQLAssociate("QRY2", CustName, Addr[1], Addr[2], City, ZipCode)
        SQLFirst("QRY2")
ELSE
        // Processes the error
END
SQLClose("QRY2")

Syntax

SQLAssociate(<Query name> , <List of operators>)

<Query name>: Character string (with or without quotes)

Name of query created and run by SQLExec (the query name must be enclosed in quotes), or run by SQLExecWDR (with or without quotes).
Only the queries created and run by SQLExec can be used in this version.

<List of operators>: Character strings (with or without quotes), separated by commas

List of control names or variable names that will be automatically associated with the corresponding columns of the query (up to 250). These operators are separated by commas. The order of these operators must correspond to the order of the query columns.

Remarks

Retrieving the value of a column

The value of a column can be retrieved individually by SQLCol.

Transferring the content of the query into a table

To transfer the entire content of the query into a table, use SQLTable.

Retrieving Float items on Oracle (via ODBC)

By default, the decimal separator used for the Float items on Oracle is the dot. However, the ODBC driver returns the value by using the comma as decimal separator. The decimal places are lost when the value is assigned to a numeric control.

To avoid this problem, you must configure the decimal separator for the current connection:

// Connection to the Oracle database
SQLConnect("MyOracleDatabase", "User", "Pass", "", "ODBC")
// Request for changing the decimal separator
SQLExec("ALTER SESSION SET NLS_NUMERIC_CHARACTERS ='. '", "TempQry")

Using tabulations in the items

The SQL functions are used to insert tabulations into the items of the data files. The management of tabulations depends on the access mode used.

1st case: Running a query in ODBC:
When running a query in ODBC, the tabulations are not retrieved by SQLAssociate. To retrieve the value of items (with TAB characters), we recommend that you use a SQLFetch/SQLGetCol browse.

Example: SQLAssociate and the tabulations in the items
The items of the records to retrieve are as follows:


	Item 1	Item 2
Record 1	John	Smith
Record 2	John + tab + Mac	Doughnut

For the first record:

SQLAssociate(Qry1, Var1, Var2): retrieves John and Smith

For the second record:

SQLAssociate(Qry1, Var1, Var2): retrieves John and Mac, but Mac does not correspond to the value of the second item
SQLAssociate(Qry1, Var1, Var2, Var3): retrieves John, Mac, Doughnut

2nd case: Running a query by OLEDB, HFSQL or Native Access
The tabulations found in the result items are automatically retrieved by SQLAssociate.

Component: wd260hf.dll