• SQL Events
• *like Function
• *sql_where Function
• a5_ADO_ResolveConnectionString Function
• a5_alphadao_export Function
• a5_alphadao_import Function
• a5_alphadao_search Function
• a5_alphadaoexportgenie Function
• a5_alphadaoimportgenie Function
• a5_arguments_sqllist Function
• A5_BatchPassiveLinkCreate Function
• a5_changealias_insql Function
• a5_complete_import_task Function
• a5_connectionpropstostring Function
• A5_CONNECTIONSTRING Function
• a5_connstrings_list Function
• a5_convert_delete_to_sql_delete Function
• a5_convert_deletedups_to_sql Function
• a5_convert_update_to_sql_update Function
• A5_CreateLayoutFromDataSource Function
• A5_CreatePassiveLinkTable Function
• a5_createsql_layout Function
• a5_createtable_sql_import Function
• a5_csweb_syntaxnamefromado Function
• a5_databaseexplorer Function
• a5_defineconnectionstring Function
• A5_ExcelConnString Function
• a5_exportconnectionstrings Function
• a5_getalphasqlfunction Function
• a5_getnamedconnectionstring Function
• a5_getnamedsqldatasource Function
• a5_getprimarykeysfromdaosearchresult Function
• a5_getreportsqlfilter Function
• a5_getreportsqlorder Function
• a5_getsavedadoconn_string Function
• a5_importconnectionstrings Function
• A5_ImportTablesDialog Function
• a5_invertsqlorder Function
• a5_list_tables_with_types Function
• a5_lookupsavedconnectionstring Function
• A5_MDBConString Function
• a5_mergeDataIntoTemplate Function
• a5_mergesqlarguments Function
• a5_namedconnectioncreate Function
• a5_odbc_connection Function
• a5_odbc_import_genie Function
• a5_paradoxconnstring Function
• A5_PassiveLinkTableDefine Function
• a5_preview_datasource Function
• A5_RefreshPassiveLinkTable Function
• A5_RefreshPassiveLinkTableDialog Function
• a5_sql_addcolumnstoselect Function
• a5_sql_addfilterorder Function
• a5_sql_arguments_dump Function
• a5_sql_arguments_load Function
• A5_SQL_BatchImportTables Function
• a5_sql_builder_simple Function
• a5_sql_cache_datafilename Function
• a5_sql_commandwindow Function
• a5_sql_droptables Function
• a5_sql_extractorder Function
• a5_sql_generate_select2 Function
• A5_SQL_ImportDataSource Function
• a5_sql_parsewhereclause Function
• a5_sql_parsewhereclause_datatypes Function
• a5_sql_query_genie Function
• A5_SQL_QuerySaveAs Function
• a5_sql_record_content_get Function
• a5_sql_record_xbase_content_get Function
• a5_sql_removeorder Function
• a5_sql_table_selector Function
• a5_sqlconnectionstring_unhidepassword Function
• a5_sqlexpressionbuilder Function
• a5_sqlimport_execute Function
• A5_SQLResultSetPreview Function
• a5_sqlToJSONExpandingMenu Function
• a5cs_decomposeaggregateexpression Function
• a5cs_generatenativefilter Function
• a5cs_generatenativeorder Function
• a5cs_getfunctionsinsqlexpression Function
• a5cs_getprimarykeycolumns Function
• a5cs_sql_add_filter_order Function
• a5cs_validateexpression Function
• a5gridhelper_dumpargumentstohtml Function
• a5Helper_findRecordInSQLTable Function
• a5SQLConnectionOpen Function
• a5wcb_exportstaticdatatosql Function
• argval Function
• cn_open Function
• combine_sql_arguments Function
• create_table_sql Function
• DataTransformExpression Example
• Portability Functions
• replace_arguments_in_string Function
• replace_placeholders_with_argument_values Function
• showresultset Function
• sql_argumentsdialog Function
• sql_avg Function
• sql_cacheapplyupdates Function
• sql_cacheevents Function
• sql_cachefetchpage Function
• sql_cachefetchpageeventscript Function
• sql_cacheopen Function
• sql_cacherefresh Function
• sql_cacherefreshinsertedrow Function
• sql_cacherefreshrow Function
• sql_childrelationsadded Function
• sql_childrelationsclear Function
• sql_childrelationspopulate Function
• SQL_ConnectionStringDialog Function
• SQL_ConnectString Function
• sql_count Function
• SQL_DatabaseExportDialog Function
• SQL_DATE Function
• sql_delete Function
• Sql_get_Values Function
• sql_import Function
• sql_insert Function
• SQL_InstallOracleLiteFunctions Function
• sql_linkcreate Function
• sql_listoptionsdialog Function
• SQL_Lookup Function
• SQL_lookup_multi Function
• sql_max Function
• sql_min Function
• sql_namedinstanceget Function
• sql_nameinstancegetsimple Function
• sql_primarykeydialog Function
• sql_query Function
• SQL_QUERY_BUILDER Function
• SQL_QueryImport Function
• sql_queryrenamewhereclausearrayoperators2 Function
• sql_quote Function
• SQL_Records_Get Function
• SQL_ResultSet_Preview Function
• sql_safeexecute Function
• sql_sum Function
• SQL_TableExport Function
• SQL_TableExportDialog Function
• SQL_TableImport Function
• SQL_TableImportDialog Function
• SQL_TableInfoOfDBF Function
• sql_tableinfotodbf Function
• SQL_TableInfoToOpenTable Function
• sql_tableinfotostring Function
• sql_time Function
• sql_update Function
• sql_upsert Function
• SYS_REMOVE Function

A5_PassiveLinkTableDefine Function

Syntax

Arguments

Result

If DataSourceDefis a dot variable with a definition of the data source for the passive-link table, Resultwill be a dot variable with two properties.

Argument

Description

.HasError

.T. = An error occurred. .F. = No error occurred.

.ErrorText

The text of any error that was encountered.

DataSourceDef

Either "Help" (to get the syntax for the data source definition), or a dot variable that defines the data source. When defining the DataSourceDef, the only required properties are:

ds.ConnectionString= specify the connection string

ds.SQLSelectStatement= specify the SQL SELECT statment, or stored procedure name

tablefilename

The filename of the table to create. If DataSourceDefis "Help" then do not specify Tablename. Otherwise, you must specify this argument.

showProgress

Logical

allowCancel

Logical

openConnection

*

flagAddTableToDatabase

Logical

Description

The A5_PassiveLinkTableDefine() function defines a passive link table for a SQL data source. For syntax help specify "Help" as the first argument.

Example

a5_passiveLinkTableDefine("help") 
= dim ds as p 
ds.ConnectionString = 'specify the connection string 
ds.SQLSelectStatement = 'specify the SQL SELECT statment, or stored procedure name 
ds.Arguments = 'specify what arguments (if any) are used in the SQL statement. Format is a comma delimited list with :argumentName|type. e.g. :whatCity|C,:whatId|N 
ds.SQLType = 'specify the syntax type: "Portable" or "Native" 
ds.AdvancedOptions.SizeToFit = 'specify if character columns are automatically sized to fit: .T. or .F. 
ds.AdvancedOptions.ConvertTimeToDate = 'specify if Date/Time values should be convert to Date values: .T. or .F. 
ds.AdvancedOptions.DefineFieldOverrides = 'specify if column definition overrides will be supplied: .T. or .F. 
ds.AdvancedOptions.OverrideDefinitions = 'A crlf delimited list of fieldspecs to override. E.g. Customer,C,20,0 ""

In this example, we create a passive link table. Notice that we only specify the two properties for the DataSourceDef. All other properties of the DataSourceDefhave default values.

delete ds
dim ds as P
ds.ConnectionString = "{A5API='Access', A5Syntax='Access', FileName='C:\Northwind\northwind.Mdb', UserName='Admin'}" 
ds.SQLSelectStatement = "select customerid, contactname, city from customers" 
a5_passiveLinkTableDefine(ds,"c:\pl_customers.dbf")

In this example, we create a passive link table that uses arguments. Notice that the ds.Argumentsproperty is defined. All other properties of the DataSourceDefhave default values.

delete ds 
dim ds as P
ds.ConnectionString = "{A5API='Access', A5Syntax='Access', FileName='C:\Northwind\northwind.Mdb', UserName='Admin'}" 
ds.SQLSelectStatement = "select * from customers where city = :whatcity"
ds.Arguments = ":whatCity|C" 
a5_passiveLinkTableDefine(ds, "c:\pl_customers.dbf")

In this example, we create a passive link table on a table in an Excelspreadsheet. Since Exceldoes not return the size of each column, Alpha Anywhere defaults to creating all character columns with a width of 255. This is very inefficient and it slows down the import. Therefore, for Excel, we set the ds.AdvancedOptions.SizeToFitproperty to .T. .

delete ds
dim ds as P
  
ds.ConnectionString = "{A5API='Excel', A5Syntax='Excel', FileName='c:\myexceldata.xls'}"
ds.SQLSelectStatement = "select * from sheet1$"
ds.AdvancedOptions.SizeToFit = .t.
a5_passiveLinkTableDefine(ds,"c:\pl_exceldata.dbf")

In this example we define the field types for certain of the columns in the passive-link table. This overrides the default column sizes for these columns that Alpha Anywhere would otherwise use.

delete ds
dim ds as P
  
ds.ConnectionString = "{A5API='Access', A5Syntax='Access', FileName='C:\Northwind\northwind.Mdb', UserName='Admin'}" 
ds.SQLSelectStatement = "select customerid, contactname, city from customers"
ds.AdvancedOptions.DefineFieldOverrides = .t.
ds.AdvancedOptions.OverrideDefinitions = <<%txt%
customerid,c,10,0
city,c,50,0
%txt%
a5_passiveLinkTableDefine(ds, "c:\pl_customers.dbf")

See Also

• SQL Helper Functions