# XML file associations with DTDs and XML schemas

There are two different ways to associate XML files with DTDs or XML schemas.

1. Direct association - The XML file contains either the name of a DTD in its doctype declaration (for example, <!DOCTYPE root-element SYSTEM " dtdfile.dtd" >, where dtdfile.dtd is the name of the DTD file) or it contains the path of an XML schema in the schemaLocation attribute of the XML file root element (for example, <xsi:schemaLocation="http://www.ibm.com schema.xsd">, where schema.xsd is the name of the XML schema.
2. XML Catalog entry - You can register DTD and XML schema files in the XML Catalog and associate them with a Key that represents them. You can then refer to a DTD or XML schema file Key from an XML file instead of referring directly to the DTD or XML schema file. An XML Catalog entry contains two parts - the Key (which represents the DTD or XML schema) and a URI (which contains information about the DTD or XML schema location).

#### How an association works

Associating an XML file with a DTD
If an XML file is associated with a DTD, a DOCTYPE tag such as the following is included in the XML file:

    <!DOCTYPE root-name PUBLIC "InvoiceId" "C:\mydtds\Invoice.dtd">

InvoiceId is the public identifier of the DTD file. It is used to associate the XML file with a DTD file (in this case, the DTD file is Invoice.dtd). If the public identifier InvoiceId corresponds to the Key of the XML Catalog entry for Invoice.dtd, then the URI of the XML Catalog entry (which contains information about the location of Invoice.dtd) is used to locate the DTD. Otherwise, the DOCTYPE's system identifier ( "C:\mydtds\Invoice.dtd"), which refers directly to the file system location of the DTD, is used to locate the DTD.

Note: You can also use a system identifier as a Key in an XML Catalog entry. If you use a system identifier as a Key, a DOCTYPE tag such as the following is included in an XML file:

    <!DOCTYPE Root-name SYSTEM "MyDTD.dtd">

where MyDTD.dtd is the system identifier that corresponds to the Key of an XML Catalog entry.

Associating an XML file with an XML schema

If an XML file is associated with an XML schema, one or more schema location attributes are included in the XML file. The information in the schemaLocation is provided as a "hint" to the XML processor. Examples of schemaLocation attributes are shown below:

Example 1

    <purchaseOrder xmlns="http://www.ibm.com"
    xsi:schemaLocation="http://www.ibm.com C:\myschemas\PurchaseOrder.xsd">
    <shipTo country="US">
    ...

Example 2

    <purchaseOrder xmlns="http://www.ibm.com"
    xsi:schemaLocation="http://www.ibm.com PO.xsd">
    <shipTo country="US">
    ....

In Example 1, the schemaLocation 'hint' ('C:\myschemas\PurchaseOrder.xsd') refers directly to the file system location or URI of the XML schema. In this case, the schema file will be located by the XML processor directly.

In Example 2, the schemaLocation 'hint' ('PO.xsd') refers to an XML Catalog entry. PO.xsd corresponds to the Key of the XML Catalog entry for PurchaseOrder.xsd, and the URI of the XML Catalog entry (which contains information about the location of PurchaseOrder.xsd) will be used to located the XML schema.

In both examples, `http://www.ibm.com` in the `xsi:schemaLocation` tag is a URI that identifies the namespace for the XML schema.

You can also use a namespace as a Key for an XML Catalog entry. If you use a namespace as a Key, a schemaLocation tag such as the following is included in an XML file:

    <purchaseOrder xmlns:="www.ibm.com"
     xsi:schemaLocation="http://www.ibm.com po/xsd/PurchaseOrder.xsd ">

The schemaLocation attribute points to both the Key and the actual location of the schema.

DTD or XML schema resides on a remote server

Several functions in the XML editor, such as validation and content assist, require the availability of a DTD or an XML schema. The product documentation provides usage information for cases when the DTD or XML schema resides on your local machine. However, in many cases, the DTD or XML schema may reside on a remote server, for example:

`<!DOCTYPE Catalog PUBLIC "abc/Catalog" "http://xyz.abc.org/dtds/catalog.dtd">`

Normally, this case poses no problem, because the DTD or XML schema can be retrieved from the remote server. However, if you are behind a firewall, and do not have a SOCKSified system, the workbench currently does not provide a way for you to specify a socks server for retrieving a DTD or XML schema. If you are unable to SOCKSify your system, the workaround for this problem is to retrieve a copy of the DTD or XML schema (using a Web browser, for example) and save that copy on your local machine. Then, you can either place a local copy in the same project as your XML file, or use the XML Catalog to associate a public identifier with the DTD's (local) location.

Note: If you have an XML file associated with an XML schema or DTD that is elsewhere in the network, and you are working on a machine disconnected from the network, you can follow the steps described above if you want to use content assist or validate your XML file.

#### Advantages of XML Catalog entry associations

If you create a direct association between an XML file and an XML schema or DTD file, any time you change the location of the schema or DTD you have to track down and update all of the referencing XML files with the new location of the DTD or schema. If, however, you associate an XML file with an XML schema or DTD Key, then, when you change the location of the schema or DTD, you only have to update the XML Catalog entry, instead of each individual XML file.

For example, you have a DTD called "Building.dtd", which is associated with five XML files - Office.xml, House.xml, Apartment.xml, Bank.xml, and PostOffice.xml. You move the DTD file Building.dtd to a new location. If you have a direction association between Building.dtd and all the XML files, you will have to update the <DOCTTYPE> declaration in each XML file to reflect the new location of Building.dtd. If, however, you have an XML Catalog association, and all the XML files just refer to the Key of Building.dtd, then you only have to update the URI and all the XML files will point to the new location of Building.dtd.

#### Updating an entry in the XML Catalog

After you have updated an entry in the XML Catalog, you may need to refresh the XML editor view so that it uses the new information. To do this, click the Reload Dependencies toolbar button and the view will be updated using the current XML Catalog settings. You only need to refresh the XML editor view when you have an XML file open that references the XML Catalog entry that was updated.

For more information, refer to the related concepts and tasks below.

(c) Copyright 2001, World Wide Web Consortium (Massachusetts Institute of Technology, Institut National de Recherche en Informatique et en Automatique, Keio University).

> Adding an entry to the XML Catalog
> Updating XML files with changes made to DTDs and schemas
> If you make changes to a DTD file or XML schema associated with an XML file (that is currently open), click XML > Reload Dependencies to update the XML file with these changes.

Related concepts
XML editor

Related tasks
Editing with DTD or XML schema constraints
Editing your DOCTYPE declaration
Updating XML files with changes made to DTDs and schemas
Editing your namespace information
Editing your XML processing instructions
Editing in the Design view
Editing in the Source view

(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.