Support Files : Catalogues : Catalogue Control File
 

Catalogue Control File

The Catalogue Control File links dictionaries and profiles to related products. This file (cataloguecontrol.xml) is located in C:\Program Files\CARIS\<application>\<version>\system.

The structure of the file is shown below.

The file must contain the following header information.

<?xml version="1.0" encoding="UTF-8" ?>
<CatalogueControlFactory Version="1.0">

Products are listed with corresponding dictionaries and profiles. An entry for Digital Nautical Charts (DNC) is shown below.

<CatalogueControlFactory Version="1.0">

...

   <Product Name="VPF DNC" Id="1000" Version="1.0">

      <Profile Type="XML" Name="%VPFConfig%\system\vpfDNCProfile.xml"/>

      <Dictionary Type="XML" Name="%VPFConfig%\system\vpfDNCPool.xml"/>

   </Product>

...

</CatalogueControlFactory>

When a DNC file is opened in CARIS, chart features and attributes are defined through vpfDNCPool.xml and vpfDNCProfile.xml.

Below is a Contour Layer Bathymetry (CLB) AML 3.0 product specification.

<CatalogueControlFactory Version="1.0">

...

   <Product Name="S-57 CLB 3.0" Id="57" Version="3.0" ProductSpecDescription="CLB">

      <Profile Type="XML" Name="%S57Config%\system\AML_3_0_CLB_Profile.xml"/>

      <Dictionary Type="XML" Name="%S57Config%\system\s5731Pool.xml"/>

      <Dictionary Type="XML" Name="%S57Config%\system\AML_3_0_ExtensionDict.xml"/>

   </Product>

...

</CatalogueControlFactory>

Two dictionaries are used to define an AML 3.0 CLB chart (s5731Pool.xml and AML_3_0_ExtensionDict.xml). The chart is further defined by the ProductSpecDescription (product specification description or PSDN) attribute.1

This table lists the tags and associated attributes in a catalogue control file.

Tags

Description

<CatalogueControlFactory>

The root element for all other tags in this file.

Attributes:

Version: Version of the catalogue file. The version is set to 1.0.

Example:

<CatalogueControlFactory Version="1.0"

<Product>

The parent tag for the product profile and dictionary tags. When an product or external file is opened, the metadata from the file is compared to the Name, ID, Version or (if necessary) Product Specification Description attributes.

Attributes:

Name: The product type for the profile and dictionary.

ID: The ID is the product specification (PRSP) value.

Version: The application profile ID (PROF) value.

ProductSpecDescription: The product specification description (PSDN) value. This attribute is necessary only for AML 3.0 products.

Example:

<Product Name="S-57 ENC 3.1" Id="1" Version="2.0">

<Profile>

Path and name for the product profile.

Attributes:

Type: Format of the file. In all cases it is XML.

Name: Path and name of the profile file.

Example:

<Profile Type="XML" Name="%S57Config%\system\enc31Profile.xml"/>

<Dictionary>

The tag that contains the path and name of the product dictionary.

Attributes:

Type: The format of the file. In all cases it is XML.

Name: Path and name of the dictionary file.

Example:

<Dictionary Type="XML" Name="%S57Config%\system\s5731Pool.xml" />

<Schema>

Path and name of the schema definition file for S-100 dictionaries.

Example:

<Schema>%S100Config%\system\S100FC.xsd</Schema>

1 Product Specification Description is used only for AML 3.0 products.