Option | Description |
|---|---|
Clear messages after run | Specifies the default setting for whether message object content is cleared after executing a map or process. When selected (true), message object content is cleared after executing, including messages in sub-processes. When not selected (false), message object content is retained, and when you run the map or process a second time the message objects will have the same value they had after the previous (first) execution. When you run a map or process (by clicking the Run button), the Clear messages after run Preference setting determines whether message object content is cleared. If you want to override the use of the preference setting for a single run, use the run dropdown menu. The Run button dropdown menu provides options to Clear Messages after Run and Do Not Clear Messages after Run. Use these options to apply the opposite (to the Preference) setting to a single execution of a map or process. |
Clear log file before run | Allows you to specify which log file data you want to retain before executing a map, process or data profile. When selected, log file content is cleared before executing. When not selected, log file content is retained and new content is appended. This setting applies to all new maps, processes and data profiles. Existing maps, processes and data profiles retain their settings. The default setting is true. Specifying this option in the Configuration tab overrides the preference setting. Note: This value persists when running a package via the engine command line. However, the -cl command line option can be used to overwrite the setting stored in the artifact. |
Create unique log file name | Allows you to create log files with same name as the artifact name with the file extension as .log. This is applicable only for new artifacts. Note: If this option is selected, the file name specified in the Log File Location is ignored. |
Write log to project folder | Creates log file in the project folder. This is applicable only for new artifacts. If multiple artifacts have the same name, then the logs are included to the previous log file (that has the same name), if available unless the artifacts are in different projects. Note: If this option is selected, the path specified in the Log File Location is ignored. |
Log File Location | Allows you to: • Browse and select an existing log file or type a new log file name. The default log file name is DataConnect.log. Note: If Create unique log file name or Write log to project folder is selected, then the file name and path specified in the Log File Location is ignored. • Specify the log file execution location, and the location that browse dialogs start in, for new data profiles, maps and processes if Write log to project folder is deselected. This option sets your log file location for every new data profile, map and process to a single log file. Note: This is likely not what you want to do. DataConnect v9 artifacts used to do this so this was kept for backward compatibility. The default location is <userdirectory>/Actian/DataConnect/Logs/DataConnect.log. For information about general Browse button behavior and rules, see Browsing Files and Directories. Note: No log file is created if the log file path specified in Log File Location is incorrect or left blank. |
Error Types To Log | Allows you to select the types of error messages that must be included in the log file: • Errors: Logs errors that may cause a map or process execution to stop. • Warnings: Logs messages about data truncation in a field, field name changes, loss of precision, or other issues. • Informative Messages: Logs messages such as "Execution initialization", "Execution successful", number of records converted, deleted, updated, or inserted, time to convert, and whether the transformation was stopped. • Debug Messages: All messages generated as a result of a TraceOn action and some other messages are logged at this level. In this case, the record number, first five fields of each record, and all the events are recorded. The messages are logged up to the selected log type including the previous log types in the order of precedence. For example, if Warnings is selected, then the log file includes both Errors and Warnings messages. Similarly, if Debug Messages is selected, then the log file includes Errors, Warnings, Informative Messages, and Debug Messages. Note: In case of v9 compatible artifacts, only the selected type of error message is included in the log file. |