Specifying XML Catalogs for a Cartridge Project

To specify XML Catalogs for a cartridge project:

Caution:

XML Catalogs are system-wide entities. An XML Catalog specified in one cartridge project is used when processing requests for orders on other cartridges. Ensure URI/URL naming conventions are established across cartridges so that OSM resolves URIs as you require for each cartridge.

1. In the Package Explorer view in Design Studio, navigate to the cartridgeProject\xmlCatalogs\core\ directory.

2. Copy the XML Catalog template file cartridgeProject\xmlCatalogs\core\xmlCatalogCoreTemplate.xml into the same directory.

   Note:

   You can have multiple XML Catalog files within the xmlCatalogs\core directory if you wish to organize different sets of catalog entries by file.

3. When prompted, rename the file to any filename you want and use the suffix .xml (for example, catalog.xml).

   Note:

   You must use the file extension .xml. OSM automatically searches for files ending in .xml within the xmlCatalogs\core directory and loads any such files as XML Catalogs.

4. Open the file and enter the XML Catalog entries you require.

   You can use any standard XML Catalog entry, but the rewriteURI entry is the most commonly used for OSM. For information on how OSM uses the rewriteURI entry, see the discussion on rewriteURI entries in OSM Developer's Guide.

   Caution:

   It is important to ensure that resources are always uniquely identifiable to a single XML Catalog entry to guarantee that the correct resource is located. For information on how to avoid defining mappings that can be satisfied by more than one entry, see the discussion on defining rewriteURI entries in OSM Developer's Guide.

5. Save the file.

Related Topics

Working with XML Catalogs

Enabling and Disabling XML Catalogs for a Cartridge Project