The INTERLIS-Compiler

System Requirements

For the current version of ili2c, you will need a JRE (Java Runtime Environment) installed on your system, version 1.3 or later.

Installing ili2c

To install ili2c, choose a directory and extract the distribution file there.

Running ili2c

There is currently no launcher. ili2c can be started with


java -jar ili2c.jar [options]

If you run the compiler without any options, a GUI (Graphical User Interface) will appear.

Graphical User Interface

Input tab

Use this tab, to define options, that the compiler will read while running.

Files

This contains the list of INTERLIS schema and metadata basket files, that the compiler will read and check. The ordering of the entries is significant. Use the Move up and/or Move down buttons to reorder the list.

Add Model (.ili)...

Use this button to add a new INTERLIS schema file to the list of files, that the compiler should check.

Add Metadata basket (.xml)...

Use this button to add a new metadata basket file to the list of files, that the compiler should check. Metadata baskets are used by the compiler, to check references from the schema files to graphical symbols or (coordinate-) reference systems.

Remove

Use this button to remove the selected entry from the list of files.

Move up

Use this button to move the selected entry one line up. The ordering of the entries is significant.

Move down

Use this button to move the selected entry one line down. The ordering of the entries is significant.

Mappings

This list contains the mappings from names of metadata basket declarations (as part of an INTERLIS schema) to BIDs (Basket Identifier) of real existing metadata baskets (as part of a XML file). See also the chapter with the syntax rule MetaDataUseDef in the INTERLIS language definition.

check if referenced metaobjects exist

Select this button, if you like the compiler to check, if referenced metaobjects exist. If this button is not selected, you don't have to define mappings, and the compiler assumes that all referenced metaobjects exist.

Add mapping...

Use this button to add new mapping.

Edit mapping...

Use this button to edit the selected mapping entry.

Remove

Use this button to remove the selected entry from the list of mappings.

Output tab

Use this tab to provide options, that control the files that the compiler will generate.

Kind of output

Defines the kind of output, that the compiler will generate. If you just like to check your INTERLIS schemas, select Generate no output.

Filename

Enter the name of the file, that the compiler will write, if you didn't choose to generate no output.

Report Errors and warnings

Select this button, if you like to see errors and warnings.

Report only errors

Select this button, if you like to see only errors.

Include the predefined MODEL INTERLIS

The INTERLIS language includes a predefined base model (see Annex A in the language definition). Select this button, if you like to include it in the generated output. This option is normally not useful.

lower area

Compiler messages

If your INTERLIS schema does not follow the INTERLIS language description, you will see here messages that point you to the problems.

Run compiler

Use this button to start a new compiler run. The compiler will then check any INTERLIS schema files, that you have added to the files list and generate the output file, that you defined on the output tab.