f2s_scripting_mode¶

Applies to: Oracle, MS SQL, MySql/MariaDB, PostgreSQL Drivers

Syntax

set_attribute f2s_scripting_mode {DriverID} to {variable}
get_attribute f2s_scripting_mode {DriverID} to {variable}

Parameter

Description

DriverID

The ID of the driver for which this applies. In most cases, you should use _f2s_ActiveDriverID.

variable

Boolean variable. If true, scripting mode is on, otherwise off.

Description

Scripting is used for testing and preparation. Using this attribute allows structural changes to be compiled and tested without actually making any of the changes. Any table restructuring (Structure_start/Structure_end) done between the set_attribute f2s_scripting_mode to true and set_attribute f2s_scripting_mode to false (f2s_scripting_mode block) will not actually be committed but instead will create a mock INT file and an SQL script to make the changes to the table. The script and INT file can then be retrieved (commands f2s_get_sql_script and f2s_get_int) and examined for testing purposes.

Getting this attribute returns a boolean indicating whether scripting mode is on (true) or off (false).

Examples

get_attribute

boolean bAmScripting

get_attribute f2s_scripting_mode to bAmScripting

set_attribute

In this example scripting is used to add a date field, Start_Date, to the VDFOrders table, SalesPerson. Note, an SQL script to add the field and the resulting INT file will be produced, however no changes to the table will be made.

Handle hSales
Variant sPart
UChar [] INTFile
UChar [] SQLScript
Integer iNewColumn

Move salesperson.File_Number to hSales

Set_Attribute f2s_scripting_mode of _f2s_ActiveDriverID  to True
Structure_Start hSales
    Boolean bOn
    Move 0 to iNewColumn
    Create_Field hSales at iNewColumn
    Set_Attribute DF_FIELD_NAME of hSales iNewColumn to "Start_Date"
    Set_Attribute DF_FIELD_TYPE of hSales iNewColumn to DF_DATE
Structure_End hSales
Set_Attribute f2s_scripting_mode of _f2s_ActiveDriverID  to False

Open SalesPerson

f2s_get_int INTFile
f2s_get_sql_script SQLScript

Showln (UCharArrayToString(SQLScript))

Related Attributes

  • f2s_get_sql_script

  • f2s_get_int

Replaces: Commands DISABLE_SCRIPTING and ENABLE_SCRIPTING