...
| Code Block | ||||
|---|---|---|---|---|
| ||||
EdmiError edmiConvertModelBN(SdaiString sourceModelRepositoryName,
SdaiString sourceModelName,
SdaiString schemaMapName,
SdaiString targetModelRepositoryName,
SdaiString targetModelName,
SdaiString declarationsToLog,
SdaiString sourceLinesToLog,
SdaiString sourceInstancesToLog,
SdaiString logFile,
SdaiInteger maxLogFileSize,
SdaiString userOutputFile,
SdaiInteger options,
SdaiModel *targetModelId);
|
Invokes the EDMmodelConverter to convert an existing data model (source model) in the EDMdatabase. The result of the conversion will normally be a new data model (target model) in the EDMdatabase. Optionally the result of this operation can be added to an existing data model.
...
The underlying schema of the target model (target schema) must exist as a dictionary model in the EDMdatabase before the EDMmodelConverter is invoked by this function. Likewise the Express-X schema that defines the conversion process must exist as an Express-X dictionary model before this function can be successfully executed.
The function edmiDefineSchema can be used to create a dictionary model of an Express schema in the EDMdatabase and the function edmiDefineSchemaMap can be used to create an Express-X dictionary model in the EDMdatabase.
...
The source model will be unchanged when the conversion process is terminated.
...
The EDMmodelConverter is utilizing the EDMexpressVM to perform the conversion process. To facilitate debugging of the conversion process, many options to trace the conversion process and to log events during the conversion process have been included.
...
Express-X can be used as a programming language for creating, manipulating, and deleting data in any data model in the EDMdatabase that can be accessed by the caller, hence the specified Express-X schema can be successfully interpreted without creating in a new data model.
...
An optional filter controls the logging of the conversion process. This filter is defined by the <declarationsToLog>, <sourceLinesToLog> and <options> arguments. The filter defines the following:
- What should be logged
- Which part of the Express-X schema should be logged
It is normally important to specify an appropriate logging filter to avoid the log output to fill up your disk.
...
Arguments
...
| 1 | Type | Name | Comment |
| 2 | SdaiString | sourceModelRepositoryName | Specifies the name of the data repository that holds the source model. Repository names are case sensitive. |
| 3 | SdaiString | sourceModelName | Specifies the name of the source model. Model names are case sensitive. The source model can be open or closed. The calling EDMuser must have read access to this model. |
| 4 | SdaiString | schemaMapName | Specifies the name of an Express-X schema describing the mapping between the source model and the target model. Express-X schema names are case insensitive. |
| 5 | SdaiString | targetModelRepositoryName | Specifies the name of the data repository that will host the resulting target model. Repository names are case sensitive. |
| 6 | SdaiString | targetModelName | Specifies the name of the target model to populate with the result from the conversion. The <targetModelName> must be unique within the repository specified by the <targetModelRepositoryName> argument.
|
| 7 | SdaiString | declarationsToLog | Specifies the Express-X declarations that should be executed when logging should be performed, I.e., the part of the schema defined in the <sourceLinesToLog> argument will only be logged when those parts are executed on behalf of the declarations specified in the <declarationsToLog> argument.
An Express-X declaration can be specified by the name, i.e., map name, function name, etc., or by the line number in the source schema where the actual construct is declared. The names of the Express-X constructs are case insensitive. |
| 8 | SdaiString | sourceLinesToLog | Specifies the Express-X source line intervals that should be logged during the conversion process. A source line interval is specified either as the name of a declaration of type: map, compose, statements, function and procedure, or by a single line number or by the first line number and the last line number separated by the hyphen '-' character. Any number of intervals can be specified, the intervals are separated by a comma. The order of the intervals is not significant. |
| 9 | SdaiString | sourceInstancesToLog | This argument is purely kept to keep the signature of the edmiConvertModelBN operation compatible with previous version of EDMinterface. |
| 10 | SdaiString | logFile | Specifies the name of the file that will hold the log information. This file can be an existing file or the name of a file that will be created by the conversion process. Default file extension is ".log". |
| 11 | SdaiInteger | maxLogFileSize | Specifies an integer value that is the maximum number of bytes the specified <logFile> can hold before the logFile is closed. Specifying the value 0 (zero) means that no size limit for the l<logFile> <logFile> is defined. This argument is only effective when the <logFile> argument is specified and the [LOG_TO_FILE] option is set. |
| 12 | SdaiString | userOutputFile | Specifies the name of a file that will be used to receive the result of executing the xpxPrintf and xpxOutputValue function in the actual Express-X schema. The specified file can be an existing file or the name of a file that will be created by the EDMmodelConverter. The default file extension is ".txt". |
| 13 | SdaiInteger | options | Specifies the EDMmodelConverter options enabled in the current invocation of the EDMmodelConverter. The <options> value should be defined as a bitwise OR between the options to enable. All the option names are defined in the header file sdai.h . |
| 14 | SdaiModel | targetModelId | The address of a variable that will receive the numeric instanceID that uniquely identifies the model (target model) in the EDMdatabase populated by the edmiConvertModelBN operation. |
Return Value
...
| Insert excerpt |
|---|
|
Options
...
| 1 | Option | Comment |
| 2 | USER_OUTPUT_TO_FILE | Specifies that the result from the Express-X functions xpxPrintf and xpxOutputValue will be written to the file specified in the <userOutputFile> argument. |
| 3 | USER_OUTPUT_TO_STDOUT | Specifies that the result from the Express-X functions xpxPrintf and xpxOutputValue will be written to the EDMinterface current output device. |
| 4 | USE_EXISTING_TARGET_MODEL | The result of the conversion process will be added to the existing target model. |
| 5 | DELETING_EXISTING_MODEL | Delete the target model before operation, if it already exists. |
| 6 | FULL_LOG | Specifies that all logging options except [LOG_AGGREGATE_CONTENTS] should be activated during the conversion process. |
| 7 | LOG_CONDITIONS | Specifies that the evaluation of all logical conditions in the actual Express-X schema should be logged. |
| 8 | LOG_EXPRESSIONS | Specifies that the evaluation of all Express-X expressions should be logged. |
| 9 | LOG_PREDEF_FUNCTIONS | Specifies that the execution of all built-in Express-X functions and procedures should be logged. |
| 10 | LOG_FUNCTIONS | Specifies that the execution of all user defined functions and procedures should be logged. |
| 11 | LOG_ITERATIONS | Specifies that all iterations should be logged. |
| 12 | LOG_INSTANCE_CREATION | Specifies that all instance creation in the conversion process should be logged. |
| 13 | LOG_ASSIGNMENTS | Specifies that the execution of all assignment statements should be logged. |
| 14 | LOG_AGGREGATE_CONTENTS | Specifies that when the actual data type to be recorded is an aggregate, the value of all aggregate elements will be written in the log record, otherwise only the aggregateID would be written to the actual log record. |
| 15 | LOG_MAPPING_SCHEMA_ONLY | Log declarations in the mapping schema only, i.e. do not log evaluation of derived attributes in the source and target schemas. |
| 16 | LOG_ERRORS | Specifies that all error events detected in the actual conversion process should be logged. |
| 17 | LOG_WARNINGS | Specifies that all warning events detected in the actual conversion process should be logged. |
| 18 | LOG_TO_FILE | Specifies that the log records should be written to the file specified in the <logFile> argument. |
| 19 | LOG_TO_STDOUT | Specifies that the log records should be written to the EDMinterface current output device. |
Returns:
A completion code of datatype EdmiError is the returned function value. The completion code has the following values:
Completion code = 0: Operation successfully performed.
Completion code != 0: Error in operation. Completion code is an EDMinterface error code. Use edmiGetErrorText to get the error text corresponding to the error code.
EXAMPLE
EdmiError rstat;
SdaiModel targetModelId;
...
if (rstat = edmiConvertModelBN(
"ModelRepository",
"AP214ARM",
Example
...
| Code Block | ||
|---|---|---|
| ||
EdmiError rstat; SdaiModel targetModelId; ... if (rstat = edmiConvertModelBN( "ModelRepository", "AP214ARM", "AP214ARM_TO_AP214AIM, |
...
"ModelRepository", |
...
"Ap214AIM", |
...
NULL, |
...
NULL, |
...
NULL, |
...
"/usr/users/hkd/xpx.log", |
...
0, |
...
"/usr/users/hkd/xpx_user_output.txt", |
...
LOG_TO_FILE | USER_OUTPUT_TO_FILE | LOG_ERRORS | LOG_WARNINGS, |
...
&targetModelId)) { |
...
/* Error in operation */ |
...
printf("\nError in edmiConvertModelBN: %s", |
...
edmiGetErrorText(rstat)); |
...
goto error; |
...
}
... |
See also
| Filter by label (Content by label) | ||||||
|---|---|---|---|---|---|---|
|