• 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_RefreshPassiveLinkTable Function

Syntax

Arguments

Result

A dot variable that describes the result of the operation.

Element

Type and Description

.error

L, .T. indicates that an error occurred

.errorText

C, A text description of any error that occurred.

tablename

The name of the table to refresh. The path of the current database is assumed.

FlagreportResults

Logical. Optional. Default = .F. .T. = If an error occurred, displays a message that tells you what the error was. .F. = No error reporting.

promptForOverwrite

Logical. Optional. Default = .T. .T. = displays a message that warns you that you are about to delete the current table's contents. .F. = no prompt.

arguments

Optional. Default = NULL_VALUE(). Arguments that retrieve value(s) from variable(s) or prompts for value(s) at runtime. Only applicable to SQL Reports. Refer to SQL::Arguments Object.

otherOptions

Optional. Default = NULL_VALUE(). Sets filter (WHERE) and order (ORDER BY) expressions for a query against a passive-linked table. A pointer dot variable with 2 elements. Refer to Using the Options Argument.

ElementTypeDescription

.filterCAdds to the WHERE clause in the underlying SQL expression.

.orderCReplaces the ORDER BY clause in the underlying SQL expression.

openConnection

*

suppressErrorMessages

Logical

showProgress

Logical

allowCancel

Logical

Description

The A5_RefreshPassiveLinkTable() function deletes the data in a passive-linked table, then retrieves its records from the specified SQL data source.

Example

? A5_RefreshPassiveLinkTable("northwindproducts", .t., .t.)
= error = .F.
errorText = ""

? A5_RefreshPassiveLinkTable("customer", .f., .t.)
= error = .T.
errorText = "Table is not a Passively Linked Table."

This script refreshes all passive link tables.

dim tableList as C
dim count as N
dim i as N
dim pr as P
dim table_i as C

tableList = <<%txt%
pl_cust
pl_customes
pl_vendor%txt%

count = line_count(tableList)

for i = 1 to (count)
    table_i = word(tableList,i,crlf())
    pr =a5_RefreshPassiveLinkTable(table_i,.f.,.f.)
    if pr.error = .t. then
        ui_msg_box("Error","Table data was not refreshed: '" + table_i + "'." + crlf(3) + "Error reported was: " + crlf() + pr.errorText, UI_STOP_SYMBOL)
    end if           
next i

Limitations

Desktop applications only.

See Also

• Working with Passive Linked Tables
• SQL Helper Functions