Import Log File

Learn how to use read import log file for troubleshooting.

In order to simplify the troubleshooting of import problems, an import log containing information on which items were imported and in what order is created. The location of the log file is configured in the writer filePath element (under ImportLogging) in the Settings.xml file (default is .\log\update.cockpit.import.csv). Aside from the default log file, which is overwritten with each import, the log file is also saved under a unique name by appending a unique ID to the file name (e.g. update.cockpit.import_1836a97d-f833-4f00-a296-fda6301471c4.csv).

You can open the log file from the overview of an import, see Import/Export History.

Note: As a large number of log files may be created over time, it makes sense to periodically delete older log files.

The log file is split according to the import phases (as displayed in the import window). The log file includes the start and end of the import process and the individual phases, as well as the following information on individual items (separated by semicolons):

  • Import time stamp (e.g. 2009.07.13;16:57:48)
  • Log entry type (e.g. Import, Info)
  • The type of item (e.g. Record, Format)
  • The item's URI (e.g mm://Record/00/x0000000000000001)
  • The status of the import (e.g Success), see below
  • The type of import (e.g. New, Update, Deleted, Converted)
  • XML overview of the data, which includes additional information such as the record ID and key. The information in this column is a representation of the XML data available for items in the import logs in CRM.cockpit's import history, see Import/Export History.

The import status can have the following values:

  • None: No import necessary (e.g. core data model)
  • Success: The item was imported successfully
  • PartialSuccess: The item was imported, but is incomplete (e.g. not all catalog entries have been imported or links are missing)
  • Failure: The item was not imported successfully
  • Converted: The item's base ID/field number was converted to the vertical-specific ID/field number
  • Deleted: The format was deleted in the target database
  • Update Denied: A existing record was not updated by the import as it has been edited on the target station. This only applies to records in certain info areas, see Special Upgrade Logic for Non-template Stations .

Records that have been updated in these info areas on a non-template station (i.e. the entry in the Updated on Station field (4203) is < 10,000 and Updated in Module (4205) is not "cockpit") are not updated when importing. The affected records are written to the log file and can be viewed in the import history, see Import/Export History.

The import type can have the following values:

  • New: The item was added to the database
  • Updated: The existing item in the target database was updated with the item in the package
  • Ignore: The item existed in the target database and you chose not to overwrite it, or the item was only changed in the target database and not in the source since the last import.