blob: 0188c47ae36dbfc700fb7b0b7d0da70a91bf464b [file] [log] [blame]
<?xml version="1.0" encoding="utf-8"?>
<!--Arbortext, Inc., 1988-2005, v.4002-->
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN"
"task.dtd">
<?Pub Inc?>
<task id="taddimpt" xml:lang="en-us">
<title>Adding import elements</title>
<titlealts>
<searchtitle>Adding import elements</searchtitle>
</titlealts>
<shortdesc>As schemas become larger, it is often desirable to divide their
content among several schema documents for purposes such as ease of maintenance,
reuse, and readability. You can use an <codeph>import</codeph> element to
bring in definitions and declarations from an imported schema into the current
schema. </shortdesc>
<prolog><metadata>
<keywords><indexterm>XML schema editor<indexterm>import elements</indexterm></indexterm>
<indexterm>XML schema files<indexterm>import elements</indexterm></indexterm>
</keywords>
</metadata></prolog>
<taskbody>
<context><p>The imported schema can come from a different namespace than the
current schema does.</p><p>You can add multiple import elements to an XML
schema, however, prefixes and namespaces have to unique amongst the imported
schemas.</p><p>The following instructions were written for the Resource perspective,
but they will also work in many other perspectives.</p><p>To add an import
element, follow these steps:</p></context>
<steps>
<step><cmd>Open your XML schema in the XML schema editor.</cmd></step>
<step><cmd>In the Outline view, select your schema.</cmd><info>The entire
schema and its contents should be displayed in the Design view.</info></step>
<step><cmd>In the Design view, right click in the <b>Directives</b> section
and click <uicontrol>Add Import</uicontrol>.</cmd></step>
<step><cmd>In the Properties view, click the <b>General</b> tab and click <uicontrol>Browse</uicontrol> <image
href="../images/Browse.gif"><alt>This graphic is the Browse button</alt></image> to
the right of the <uicontrol>Schema location</uicontrol> field.</cmd></step>
<step><cmd>If you want to import an XML schema located in the workbench:</cmd>
<substeps>
<substep><cmd>Select <uicontrol>Workbench projects</uicontrol> and click <uicontrol>Next</uicontrol>. </cmd>
</substep>
<substep><cmd>Select the schema you want to import and click <uicontrol>Finish</uicontrol>.</cmd>
</substep>
</substeps>
</step>
<step><cmd>If you want to import an XML schema located on the Web:</cmd>
<substeps>
<substep><cmd>Select <uicontrol>HTTP</uicontrol> and click <uicontrol>Next</uicontrol>.</cmd>
</substep>
<substep><cmd>Type the URL of the XML schema and click <uicontrol>Finish</uicontrol>.</cmd>
<info><note>A local copy of the schema will not be stored in the workbench.
Every time you validate your schema, the schema's contents will be checked
from the URL you specify.</note></info></substep>
</substeps>
</step>
<step><cmd>The XML schema editor will retrieve the namespace for the imported
XML schema file and display it as read-only in the <uicontrol>Namespace</uicontrol> field.</cmd>
</step>
<step><cmd>If necessary, type a unique prefix for this namespace in the <uicontrol>Prefix</uicontrol> field.</cmd>
</step>
<step><cmd>Click the <uicontrol>Documentation</uicontrol> tab if you want
to provide any information about this import element.</cmd><info>The <uicontrol>Documentation</uicontrol> page
is used for human readable material, such as a description.</info></step>
<step><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></step>
</steps>
<result><p>Once you have added an import 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></result>
<postreq></postreq>
</taskbody>
</task>
<?Pub *0000004340?>