DataFlux Data Management Studio 2.5: User Guide

Customize - Import from a File and Export from a QKB

Import from a file

The Import option allows you to import Data Types and Definitions from a package previously created by Export.

To import from a file, click Import. The Import from a file dialog opens.

Filename - This is the path to the file you want to import.

Click Browse to locate the file you want to import. The Import file selection dialog opens. Select the file name then click Open.

File contents

Description - This is the description for the file.

Created - This is the date and time the file was created.

The Data Type appears in the field below.

Click Next. The Import from a file - Import results dialog opens.

The contents of the package will be imported. Any problems encountered during the import (for example, the Locale not licensed) are listed when the Import process is complete.

Data Types and Definitions will be imported into their Locales of origin, regardless of what Locales are loaded in Customize at the time of Import. For example, if a Definition was from ENUSA but you only have FRFRA loaded, then ENUSA is loaded and that Definition is imported into ENUSA. (This process assumes you are licensed to use the Locale in question.)

If the import contains an item that would cause a name collision (for example, a Data Type of the same name or a Definition of the same name and type already exists in the target Locale), the imported item will be renamed with an auto-incrementing number suffix. For example, if an "Address" Data Type already exists, the imported Data Type will be called "Copy of Address 2". A subsequent Import will result in "Copy of Address 3", and so on. You can rename the item to something more meaningful after the Import.

Definitions that are automatically imported as dependencies are treated in the same way as explicitly-exported Definitions. These also are imported into their Locales of origin.

Files that are imported along with Definitions, such as Regex Libraries or Grammars, are also renamed in the same way to avoid overwriting existing files.

Note: The newly-imported Data Types and Definitions are NOT saved until you save the QKB.

Click Finish.

Export from a QKB

To export from a QKB, click File > Export. The Export from a QKB - Select items dialog opens.

The Export dialog displays a tree similar to Data Types and Definitions. When a check box is selected, that item will be exported. When a Definition check box is selected, the Data Type is automatically selected as well. Dependencies (definitions that are used by other definitions) will be determined automatically and do not need to be explicitly selected.

To export from a QKB, complete the following steps:

1. Select the QKB you want to export from.
2. Click Next.
3. Enter a name for the export file. The file will have a .qkx extension.
4. Add text describing the export and specify the location where the export package will be saved.
5. Click Save. The Export from a QKB - Select target dialog opens.
6. Click Next. Information about the Export appears in the Export from a QKB - Results dialog.
7. View what will be exported. In the right pane, the Data Types and Definitions selected for export appear. Dependencies of the explicitly-selected Definitions (for example, a Parse Definition that is needed by a selected Match Definition) will be automatically included. In the left pane, all the files that are used by the exported Definitions are shown (for example, Regex Libraries, Grammars, and so on). These will be exported in the same package.
8. Click Finish. The QKB you exported is saved.

Related Topics

• Customize - Main Screen