Salt Suite User Guide (Copyright Salt )

A suite of tools The DCS Editor is designed for data category management. The Publisher adds some features for information dissemination. The converter allows you to add styles to the data categories and also to generate style sheets and schemas for conversions between different formats.

Files… The DCS file tab is the enter point of the Salt Suite. Creation of a new working file. Loading of a previous work. Preview of the current work file before saving. View of the reference file.

Admin … The user can add reference files, levels, …

Readme … Information concerning the current version

The Editor Quick Overview

The Salt Suite File tab Opens an existing file Opens a new file Shows the work file or the reference file in rdf format; Indicates the reference file and the mode (always Edition) Remark :The mode is always Edition (restrictions for other modes have to be defined).

The Salt Suite File tab Preview of the working file 3 saving modes : With the current name With an other name As a reference Remark :The mode is always Edition (restrictions for other modes have to be defined). Saves (or not) the styles Coming soon

After a « New file » choice… The ISO12620 reference file

The Editor - Selection tab Selected data categories All the data categories which are defined in the reference file Selected items from left to right Selected items from right to left All items from right to left All items from left to right Quick search fields

The Editor data categories tab

The Editor Data categories tab, more details Creation of a new data category Data category name Data category identifier

The Editor Data categories tab, more details

Definition, Source Note, Comment and Example fields are not large enough for editing text, so it is possible to open an editor window by clicking these buttons

The Editor Data categories tab, more details Add a picklist value from the reference file Check the boxes corresponding to the levels where the datcat is used. Edit or create a pick list value Remove a pick list value from the current data category pick list values Coming soonContent type

The Editor Data categories tab, more details Same as in the data categories tab main window

The Editor Preview Shows a preview of the new data category set in rdf Different saving modes Save an existing file Save as a new file Save as a reference file Preview text area Indicates the current view

The Editor Visualization tab Integrated HTML display area Selects the style sheet Applies the style sheet to the user data category set and shows it in the HTML display area. Saves the HTML file

The Editor Query tab Integrated HTML display area 2 modes, full or simplified Enter query here. Contains, begins… Starts the query Query in the reference or the work file

The Editor Help tab

The Editor Use case Scenario You have to create a new data category set based on the ISO12620 rdf reference file. You start to create a new set by selecting all the data category you need. After a preview and a visualization, the new set seems to be correct and you save it in a file. If it is not correct, you can select/remove data categories.

The Editor Use case – Jennifer at work I have to create a new data category set based on the ISO12620 rdf reference file 1. Click the “ New DCS file” button 2. A small dialog window opens. 3. Select the reference file 4. Click the OK button.

The Editor Use case After a few seconds of loading, I can start my work A view of the associated reference file

The Editor Use case Now I’m ready to select data categories from the reference Selection tab These data categories are available for selection You can use these buttons

The Editor Use case Now I have to decide which data categories I want to select I want to select all the data categories beginning with term. A few seconds later…

The Editor Use case 1. Select all data categories You want 2. Click this button 3. Selected data categories have been added to the user subset

The Editor Use case I want to see some details of my selection, so I select the « Data categories » tab Data categories tab Select the appropriate data category

The Editor Use case I’m subsetting, so I do not add or modify a field. But I remember that in this version, all modes are equivalent to Edition. So if want to change something, I can do it.

The Editor Use case Now I want to see a preview of the new rdf file corresponding to my subset 1. File tab 2. Select the “Preview” button 3. The rdf file

The Editor Use case It is easy to apply a stylesheet to my subset and to save it as an html file 1. Visualization tab 3. Select this button to update the display 2. Select the appropriate style sheet 5. Save as an html file 4. Display

The Editor Use case I can also a query in my subset in order to verifying my work in detail.

The Editor Use case Now I want to save my work. 1. File tab 2. Select the “Save” button 3. You must add information for Author and Version 4. Select the “OK” button 5. See next page… Jennifer

The Editor Use case 6. Choose the appropriate directory and a name for your subset 7. Select the “Save” button

The Editor Use case Now I can close the SALT Suite and come back later. ??? I have missed some data categories, so I restart the Salt Suite. Two hours later…

The Editor Use case 1. Select the “Open file” button 2. Find the previous file and select it. 3. Select the “Open” button

The Editor Use case The reference file and the work file have been identified

The Editor Use case The previously selected data categories Use these button to add the data categories you missed the first time Selection tab

The Editor Use case I want to add audio and checked by 1. Select audio and checked by 2. Select this button 3. The 2 data categories have been added

The Editor Use case Data categories tab audio and checked by are now in the subset.

The Editor Use case File tab audio

The Editor Use case Well, it seems to be good now. I will save it. 1. Select the “Save” button 2. You can update previous information. 3. Select the “OK” button.

The Editor Use case – Jennifer is tired I have finished my work for today. Next time i will show you how to use the converter and the publisher.

The Converter Quick Overview In progress…

The Converter - Profile Profile management, all informations needed for a specific format

The Converter - Convert Conversions between a format and GMT, in the two ways

The Converter - Schema Checking of the TML with the automatic generated schema

The Converter Use case Scenario You want to create a profile for TBX. So, You must define a TML specification for TBX in the Editor part. You must define a main stylesheet* for TBX. You must create a profile for TBX and generate the stylesheet* conversion rules. These rules must be included in the main stylesheet*. You must also generate (automatically) a schema to validate the files based on the TML specification. (*XSLT)

The Converter Use case Profile name TML specification created with the Editor Main stylesheets which you must create yourself Automatic rules generators Schema generator, based on the TML specification

The Converter Use case Loaded TBX file Generated GMT file 2 1

The Converter Use case After a conversion to GMT, you can change the profile, convert the previous GMT file to the selected TML

The Converter Use case Load a File to check Click to check Checking result