docs/org.eclipse.wst.xsdeditor.doc.user/topics/taddincl.dita

<?xml version="1.0" encoding="UTF-8"?>
<!--Arbortext, Inc., 1988-2008, v.4002-->
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN"
 "task.dtd">
<?Pub Inc?>
<task id="taddincl" xml:lang="en-us">
<title>Adding include elements</title>
<titlealts>
<searchtitle>Adding include elements</searchtitle>
</titlealts>
<shortdesc>If your schemas are large, you might choose to divide their
content among several schema documents to make them easier to maintain,
reuse, and read.  You can use the <codeph>include</codeph> element
to bring in definitions and declarations from the included schema
into the current schema. The included schema must be in the same target
namespace as the including schema. </shortdesc>
<prolog><metadata>
<keywords><indexterm>XML schema editor<indexterm>include elements</indexterm></indexterm>
<indexterm>XML schema files<indexterm>include elements</indexterm></indexterm>
</keywords>
</metadata></prolog>
<taskbody>
<context><p>The following instructions were written for the Resource
perspective, but they will also work in many other perspectives.</p><p>To
add an include element, complete the following steps:</p></context>
<steps>
<step><cmd>Open your XML schema in the XML schema editor.</cmd></step>
<step><cmd>In the Design view, right-click in the <b>Directives</b> section
and click <uicontrol>Add Include</uicontrol>.</cmd></step>
<step><cmd>In the Select XML schema file wizard, you can include an
XML schema that is located in your workspace or you can include a
schema from an HTTP Web address. The XML schema file that you select
must have the same namespace as the current schema.</cmd>
<choices>
<choice>If you want to include an XML schema located in your workspace:<ol>
<li>Select <uicontrol>Workbench projects</uicontrol> and click <uicontrol>Next</uicontrol>. </li>
<li>Select the schema that you want to import and click <uicontrol>Finish</uicontrol>.</li>
</ol></choice>
<choice>If you want to include an XML schema located at an HTTP Web
address:<ol>
<li>Select <uicontrol>HTTP</uicontrol> and click <uicontrol>Next</uicontrol>.</li>
<li>Type the URL of the XML schema and click <uicontrol>Finish</uicontrol>.<note>A
local copy of the schema is not stored in your workspace. If you validate
your schema, the schema's contents are checked from the URL that you
specify.</note></li>
</ol></choice>
</choices>
</step>
<step importance="optional"><cmd>Use the Properties view to define
additional properties for your import element.</cmd>
<substeps>
<substep><cmd>If you want to edit the location of the included XML
schema file, click the <uicontrol>General</uicontrol> tab and type
the new location display in the <uicontrol>Schema location</uicontrol> field.</cmd>
</substep>
<substep><cmd>Click the <uicontrol>Documentation</uicontrol> tab if
you want to provide any information about this include<?Pub Caret?>
element. </cmd><info>The <uicontrol>Documentation</uicontrol> page
is used for human readable material, such as a description.</info>
</substep>
<substep><cmd>Click the <uicontrol>Extensions</uicontrol> tab if you
want to add application information elements to your annotations of
schema components. </cmd><info>The <uicontrol>Extensions</uicontrol> page
allows you to specify the schema and add XML content to your annotations.</info>
</substep>
</substeps>
</step>
</steps>
<result><p>Once you have added the include element to your XML schema,
when you define new elements, attributes, complex types, or simple
types where you can specify type information, any declarations from
the included schema will be available in the <uicontrol>Type</uicontrol> list
for the element, attribute, complex or simple type.</p><p>For example,
if Address.xsd has the following content:</p><codeblock>&lt;complexType name="Address">
    &lt;sequence>
        &lt;element name="name" type="string">
        &lt;element name="street" type="string">
    &lt;/sequence>
&lt;/complexType>
</codeblock>and you have an XML schema called PurchaseOrder.xsd that
has added an include for Address.xsd, then when defining a new element
in  PurchaseOrder, you can select Address as its type.  </result>
</taskbody>
</task>
<?Pub *0000004174?>