99 lines
2.8 KiB
Plaintext
99 lines
2.8 KiB
Plaintext
This directory contains the conversion tools necessary to transform our
|
|
DTDs into XSD (XML Schema Documents) suitable for integration into the
|
|
VS7 XML editing environment.
|
|
|
|
Please be aware that currently this is a non-automated process. The steps
|
|
you need to carry out to do this are as follows:
|
|
|
|
|
|
1) If you haven't done so, install MSXML 2.6 on your host; this is needed
|
|
for the final stage of the conversion. The msxmlwr.exe included in
|
|
this folder contains the latest (March 2000) web preview release of
|
|
MXSML. You'll need to run this to install MSXML.
|
|
|
|
2) If a DTD file has changed, you will need to check out the following
|
|
files from the .\DTD subdirectory
|
|
|
|
<dtdname>.xdr
|
|
<dtdname>.xds
|
|
|
|
where <dtdname> is the DTD file prefix (e.g. CIM20, WMI20).
|
|
|
|
3) Run the dtd2schema.exe utility on the DTD, to generate the XDR file.
|
|
|
|
dtd2schema -o ..\dtd\<dtdname>.xdr ..\dtd\<dtdname>.dtd
|
|
|
|
4) Hand-edit the .XDR file produced so that the following changes are
|
|
made:
|
|
|
|
- Wherever a DTD production of the form
|
|
|
|
<!ELEMENT FOO (BAR, BAR+)>
|
|
|
|
occurs (currently only the MULTIREQ and MULTIRSP elements fit
|
|
this pattern), change the output in the XDR file from
|
|
|
|
<ElementType name="FOO" content="eltOnly">
|
|
<group order="seq">
|
|
<element type="BAR"/>
|
|
<element type="BAR"/>
|
|
</group>
|
|
</ElementType>
|
|
|
|
to
|
|
|
|
<ElementType name="FOO" content="eltOnly">
|
|
<group order="seq">
|
|
<element type="BAR"/>
|
|
<element type="BAR" maxOccurs="*"/>
|
|
</group>
|
|
</ElementType>
|
|
|
|
5) Then run the convert.js utility on the XDR to generate the XDS file.
|
|
|
|
cscript convert.js ..\dtd\<dtdname>.xdr ..\dtd\<dtdname>.xds
|
|
|
|
6) Hand-edit the XDS file generated to include the correct VS7 intellisense
|
|
annotations. At the time of writing these are known to include
|
|
|
|
1) Change the opening lines of the file
|
|
|
|
<!--
|
|
[XDR-XDS] This schema automatically updated from an IE5-compatible XDR schema to W3C
|
|
XML Schema.
|
|
-->
|
|
<!DOCTYPE schema SYSTEM "xsd.dtd">
|
|
<schema xmlns="http://www.w3.org/1999/XMLSchema" version="1.0">
|
|
|
|
to
|
|
|
|
|
|
<?xml version='1.0' ?>
|
|
<schema targetNamespace='http://schemas.microsoft.com/Schemas/WMI20Ex'
|
|
xmlns='http://www.w3.org/1999/XMLSchema' version="1.0"
|
|
xmlns:wmi='http://schemas.microsoft.com/Schemas/WMI20Ex'>
|
|
|
|
but note in the above the following DTD-specific content in xmlns:wmi declaration
|
|
|
|
WMI20Ex, WMI20 or CIM20 - use this as last component of URL depending on DTD
|
|
|
|
|
|
2) All ref attributes on <element> which address CIM/WMI DTD items should
|
|
have their values prefixed with "wmi:" e.g.
|
|
|
|
<element ref="CLASSPATH">
|
|
|
|
becomes
|
|
|
|
<element ref="wmi:CLASSPATH">
|
|
|
|
3) All elements of the form
|
|
|
|
<any namespace="##other"/>
|
|
|
|
should be removed.
|
|
|
|
|
|
7) Check in the modified XDR and XDS files.
|
|
|
|
|