| <?xml version="1.0" encoding="utf-8"?> |
| <?xml-stylesheet type="text/xsl" href="../../../wtp.xsl"?> |
| <html> |
| <head> |
| <meta name="root" content="../../../../" /> |
| <title>XML Catalog Tutorial</title> |
| </head> |
| <body> |
| |
| <h1>XML Catalog Tutorial</h1> |
| <p> |
| <b>By Richard Mah</b><BR/> |
| Created on December 17, 2004<BR/> |
| Updated on August 10, 2005<BR/> |
| <BR/> |
| In this tutorial, we will demonstrate the use of the XML Catalog. Add the Example “Editing and validating XML files”. |
| Select File -> New -> Other -> Examples -> Editing and Validating XML files. |
| |
| To demonstrate the XML Catalog, let’s use Invoice.dtd and Invoice.xml located in the XMLExamples project. |
| |
| <ol> |
| <li> |
| Create a new folder “Invoice2” in the project “XMLExamples”. |
| </li> |
| <li> |
| Move Invoice.dtd located in XMLExamples\Invoice\ to the new location XMLExamples\Invoice2. |
| </li> |
| <li> |
| Validate Invoice.xml. See the validating XML tutorial. Notice the validation has generated a warning. This is because Invoice.dtd cannot be found. To fix this problem, we shall add an entry into the XML Catalog (demonstrated below). |
| </li> |
| </ol> |
| </p> |
| |
| <p> |
| <div align="right"> |
| <table border="0" cellpadding="2" cellspacing="0" width="100%"> |
| <tbody> |
| <tr> |
| <td colspan="2" align="left" bgcolor="#0080c0" valign="top"><b><font face="Arial,Helvetica"><font color="#ffffff">Adding and Removing from the XML Catalog</font></font></b></td> |
| </tr> |
| </tbody> |
| </table> |
| </div> |
| <BR/> |
| The XML Catalog can be accessed through the preferences. |
| <ol> |
| <li> |
| Select “Window -> Preferences” to launch the Preferences dialog. |
| </li> |
| <li> |
| Expand the “Web and XML” heading and select “XML Catalog”. |
| </li> |
| </ol> |
| The dialog should appear as in Figure 1. |
| |
| <p><b>Figure 1</b><br/> |
| <IMG border="0" src="images/XMLCatalog-Figure1.jpg"/></p> |
| |
| |
| <H4>Adding an XML Catalog Entry</H4> |
| <ol> |
| <li> |
| From the Preferences XML Catalog dialog, select “Add…”.</li> |
| <li> |
| In the “New XML Catalog Entry” dialog, fill in the values as they |
| appear Figure 2. |
| <p><b>Figure 2</b><br/> |
| <IMG border="0" src="images/XMLCatalog-Figure2.jpg"/></p> |
| </li> |
| <li> |
| Click “OK” to finish. Notice there is a new entry, InvoiceId, under |
| “User Specified Entries”.</li> |
| |
| <li> |
| Validate Invoice.xml again. Notice it is now valid.</li> |
| </ol> |
| |
| <h4>Removing and Editing an XML Catalog Entry</h4> |
| To remove or edit an entry, simply select the entry and click on “Delete” |
| or “Edit…”. |
| <BR/> |
| <BR/> |
| <div align="right"> |
| <table border="0" cellpadding="2" cellspacing="0" width="100%"> |
| <tbody> |
| <tr> |
| <td colspan="2" align="left" bgcolor="#0080c0" valign="top"><b><font face="Arial,Helvetica"><font color="#ffffff">Importing and Exporting a Catalog</font></font></b></td> |
| </tr> |
| </tbody> |
| </table> |
| </div> |
| <BR/> |
| XML Catalog entries can be saved to a file for later use. This avoids |
| users having to add entries to an XML Catalog when they have already done |
| so in a previous workspace. |
| From the “Advanced XML Catalog Preferences” dialog, the importing and |
| exporting XML Catalog options are available. See Figure 3. |
| |
| <p><b>Figure 3</b><br/> |
| <IMG border="0" src="images/XMLCatalog-Figure3.jpg"/></p> |
| |
| <h4>Exporting XML Catalog settings:</h4> |
| <ol> |
| <li> |
| Selecting the “Export…” button on the “Advanced XML Catalog Preferences” |
| dialog.</li> |
| |
| <li> |
| The “Export XML Catalog Settings” dialog will appear. See Figure |
| 4. Select the Project “Catalog” (create if ncecessary) as the location to store the XML |
| Catalog settings file. Enter “.xmlcatalog” as the file name. |
| Click “OK” to finish. The entries specified in the XML Catalog will |
| now be saved in the file.</li> |
| </ol> |
| |
| <p><b>Figure 4</b><br/> |
| <IMG border="0" src="images/XMLCatalog-Figure4.jpg"/></p> |
| |
| |
| <H4>Importing XML Catalog settings:</H4> |
| <ol> |
| <li> |
| Selecting the “Import…” button on the “Advanced XML Catalog Preferences” dialog. |
| </li> |
| <li> |
| The “Import XML Catalog Settings” dialog will appear. See Figure 5. Select the file containing the XML Catalog settings (.xmlcatalog) and click “OK” to finish. The entries specified in the file will now be in the XML Catalog. |
| </li> |
| </ol> |
| |
| <p><b>Figure 5</b><br/> |
| <IMG border="0" src="images/XMLCatalog-Figure5.jpg"/></p> |
| |
| </p> |
| </body> |
| </html> |
