Categories
Lucid Builder v4

Lucid Builder Exporting keys using XML datasets

Applies to Matrix key projects

Lucid Builder Export Key Menu
Lucid Builder Export Key Menu

To create an XML Dataset, choose Export Key from the File menu, click the browse button in the Export Key dialog, then within the File Export dialog provide a file name, select the XML dataset file type and then click save. Finally click the export button in the Export Key dialog to complete the export.

Step 1.

Lucid Builder Export key dialog
Lucid Builder Export key dialog.

Step 2.

Lucid Builder Export Key File Browser dialog with Dataset XML type selected
Lucid Builder Export Key File Browser dialog with Dataset XML type selected.

Step 3.

Lucid Builder Key Export dialog. XML Dataset selected. Click the Export button to complete the export.

Note

The XML dataset file does not contain the key’s media, only references to where the media can be found. Therefore if you need to transfer a XML dataset file to another computer you should also copy the key's media directories.

Categories
Lucid Builder v4

Lucid Builder Importing keys using LIF and LIF3 files

Applies to Matrix key projects

Lucid Builder - Import key menu option
Lucid Builder – Import key menu option.

LIF (exported from the Lucid Version 2 Builder), and LIF3 files exported from the Lucid3/4 Builder can be imported into the Lucid4 Builder using the following steps:

  1. Create a new key (New from the File menu)

  2. Save the key (Save or Save As… from the File menu)

  3. Choose Import Key from the File menu, select the desired file type, then browse for the appropriate file and follow the prompts.

If any errors are detected when importing a key, they will be listed in a dialog box for review. The file can still be imported, but errors may result in only a partial import. For example, if an image is missing the key can be imported but the reference to the image will be removed.

Categories
Lucid Builder v4

Lucid Builder XML Dataset Files

XML Dataset files are xml documents containing all the data (Feature and Entity lists, item properties, score data and media attachment references) for a key. XML Dataset are primarily used as the data format for upload to the Lucid Key Server Player application.

See the Key deployment help topic for further information on key deployment options.

Note

A XML Dataset file for a key does not contain the key’s media, only references to where the media can be found. Therefore if you need to transfer a XML Dataset file to another computer you should also copy the key’s media directories.

Categories
Lucid Builder v4

Importing and Exporting

Lucid supports import and export via a number of file formats:

  • Lucid Interchange Format (LIF) files are simple, text-based files that are used to import keys from the Lucid Builder Version 2.

  • Lucid Interchange Format version 3 (LIF3) files are XML-based files that can store all Lucid key data, allowing you to back up your key or to exchange it with other key developers.

  • Lucid XML Dataset (XML Dataset) files are XML-based files that can store all Lucid key data. The primary use is for uploading key data to the Lucid Key Server Player application.

  • CSV (Comma separated Value) files are text files with data items separated by commas. CSV files are used to import and export key data between the Lucid Builder and spreadsheet program such as Microsoft Excel, or databases such as Microsoft Access.

  • Media List files are XML-based files that contain entities and their associated media.

  • Simple text files can be used to import and export the feature and entity trees.

Lucid Builder Data Import and Export options

FILE TYPEDATA INCLUDEDIMPORTEXPORT
LIFFull keyYESNO
LIF3Full keyYESYES
XML DatasetFull keyYESYES
CSVFeatures, entities, score dataYESYES
Media ListFeatures and Entity media referencesYESYES
TextFeatures and EntitiesYESYES

In addition, DELTA (Descriptive Language for Taxonomy) files can be imported into the Lucid Builder via LIF files created by the Lucid Translator, available from the Lucidcentral website. See the Lucidcentral topic Notes for DELTA Users for more information.

LIF (Lucid Interchange Format) Files

Keys exported as LIF files from the Lucid2 Builder can be imported into the Lucid3 Builder using LIF (Lucid Interchange Format) files. A LIF file is a simple text file with sections for the different data elements (feature and entity lists, multistate and numeric score data, and multimedia attachments).

Note: The LIF file includes references to the directories holding media (html and image files) for the original key. If you have moved the key after creating the LIF file, you may need to modify the path for each of the five media directories. Open the file in a standard text editor, search for “[..Multimedia Directories..]” and edit the media references, changing the path in each reference to an appropriate path for the folder that holds the media:

[..Multimedia Directories..]

Sounds “C:\Program Files\Lucid\My key\Sounds\”

Images “C:\Program Files\Lucid\My key\Images\”

Macros “C:\Program Files\Lucid\My key\Macros\”

Text “C:\Program Files\Lucid\My key\HTML\”

Video “C:\Program Files\Lucid\My key\Video\”

LIF3 (Lucid Interchange Format version 3) Files

LIF3 files are xml documents containing all the data (feature and entity lists, item properties, score data and media attachments) for a key. LIF3 files can be used to back up keys, and for easily transferring keys from one computer to another.

Note: The LIF3 file for a key does not contain the key’s media, only references to where the media can be found. Therefore if you need to transfer a LIF3 file to another computer you should also copy the key’s media directories

You can do this by opening the LIF3 file in a standard text editor, searching “for media base_path”, and editing the path name of the Media directory. For example:

 

should be changed to:

 

where new_computer’s_path is the full path name including drive letter of the Media directory on the new computer.

CSV structure

 Entity 1Entity 2Entity 3 ...etc
State 1ScoreScoreScore
State 2ScoreScoreScore
State 3 ...etcScoreScoreScore

Importing/Exporting Data

Lucid Builder Export Key dialog
Lucid Builder Export Key dialog.
To export a key, choose File > Export > Export Key from the menu, choose the file type and a location for the exported file, enter a name for the file and click Save. Flatten Entity Hierarchy – this option will covert the keys entity tree view into a flat list using List View names (edited or automatic). This is useful if preparing a key for the Lucid Mobile Platform, which doesn’t support tree view hierarchies or if you prefer a simpler entity list for a target user group. To export a feature or entity list, choose File > Export > Export Feature List or File > Export > Export Entity List from the menu. To import a key, choose File > Import > Import Key from the menu and browse for the appropriate file To import a feature or entity list, choose File > Import > Import Feature List or Import > Import Entity List from the menu and browse for the file.