Purpose

Determines whether the driver creates the internal files required for a relational map of the native data model when establishing a connection.

Valid Values

NotExist | ForceNew | No | Session | OnChange

Behavior

If set to NotExist, the driver uses the current group of internal files specified by SchemaMap. If the files do not exist, the driver creates them.

If set to ForceNew, the driver deletes the group of internal files specified by SchemaMap and creates a new group of these files at the same location.

If set to No, the driver uses the current group of internal files specified by SchemaMap. If the files do not exist, the connection fails.

If set to Session, the driver uses memory to store the internal configuration information and relational map of the native data model. After the session, the view is discarded.

If set to OnChange, the driver checks for changes to the native data model for CRM apps. If changes to the schema are detected, the driver deletes the group of internal files specified by SchemaMap and creates a new group of these files at the same location. For ERP apps, OnChange is ignored, and the driver uses the current group of internal files specified by SchemaMap.

Notes

  • The internal files share the same directory as the schema map's configuration file. This directory is specified with the SchemaMap connection property.

  • You can refresh the internal files related to an existing relational view of your data with the SQL extension Refresh Map. Refresh Map runs a discovery against your native data and updates your internal files accordingly.

  • The default behavior for ERP apps is different from the default behavior for CRM apps. For ERP apps, the default setting OnChange is ignored, and the driver uses the current group of internal files specified by SchemaMap. If you are using the driver with an ERP app, the ForceNew or Session settings can be used to pick up changes made to the native data model. Alternatively, you may use the Refresh Map SQL extension to discover changes to the native data model.

Data Source Methods

public String getCreateMap()

public void setCreateMap(String)

Default Value

OnChange

Data Type

String