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

<?xml version="1.0" encoding="utf-8"?>
<!--Arbortext, Inc., 1988-2005, v.4002-->
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<task id="taddagrp" xml:lang="en-us">
<title>Adding attribute groups</title>
<titlealts>
<searchtitle>Adding attribute groups</searchtitle>
</titlealts>
<shortdesc>An attribute group definition is an association between a name
and a set of attribute declarations. Named groups of attribute declarations
can greatly facilitate the maintenance and reuse of common attribute declarations
in an XML schema.</shortdesc>
<prolog><metadata>
<keywords><indexterm>XML schema editor<indexterm>adding<indexterm>attribute
groups</indexterm></indexterm></indexterm><indexterm>XML schema editor<indexterm>attributes
groups<indexterm>adding</indexterm></indexterm></indexterm><indexterm>XML
schema files<indexterm>adding<indexterm>attribute groups</indexterm></indexterm></indexterm>
<indexterm>XML schema files<indexterm>attributes groups<indexterm>adding</indexterm></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 attribute
group to an XML schema, 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, right-click the <uicontrol>Attribute Groups</uicontrol> folder
and click  <uicontrol>Add Attribute Group</uicontrol>.</cmd><info>It appears
in the <uicontrol>Attribute Groups</uicontrol> folder.</info></step>
<step><cmd>Select your new group, and in the Graph view, right-click the attribute
group and select <menucascade><uicontrol>Refactor</uicontrol><uicontrol>Rename</uicontrol>
</menucascade>. In the <uicontrol>New Name</uicontrol> field, type a name
for the attribute group.</cmd></step>
<step><cmd>To add an attribute, right-click your attribute group in the Outline
view, click <uicontrol>Add Attribute</uicontrol>.</cmd><info>The attribute
appears below the attribute group in the Outline view.</info>
<substeps>
<substep><cmd>Select the attribute, and in the Graph view, click the current
(default) name of the attribute, then type the new <uicontrol>Name</uicontrol>.</cmd>
</substep>
<substep><cmd>In the Graph view, click the current (default) attribute type
and select a type from the menu. Alternately, you can select browse to invoke
the Set Type menu for more options.</cmd><info>The Set Type dialog lists all
built-in and user-defined types currently available. You can change the <uicontrol>Scope</uicontrol> of
the list by selecting one of the following options:<ul>
<li><uicontrol>Workspace</uicontrol>. Lists all of the types available in
your workspace. </li>
<li><uicontrol>Enclosing Project</uicontrol>. Lists all of the types available
in the project that contains your file. </li>
<li>(Default) <uicontrol>Current Resource</uicontrol>. List all of the types
available in your current file.</li>
<li><uicontrol>Working Sets</uicontrol>. List all the types available within
the selected working set.</li>
</ul></info></substep>
</substeps>
</step>
<step><cmd>An attribute reference provides a reference to a global attribute.
To add an attribute reference, in the Graph view, right-click the complex
type containing the element, and click <uicontrol>Add Attribute Ref</uicontrol>.</cmd>
<info>A declaration that references a global attribute enables the referenced
attribute to appear in the instance document in the context of the referencing
declaration.</info>
<substeps>
<substep><cmd>Select the reference, then select the attribute group you want
it to reference in the Properties view, from the<uicontrol>Ref</uicontrol> menu.</cmd>
</substep>
</substeps>
</step>
<step><cmd>An attribute group reference provides a reference to an attribute
group. To add an attribute group reference, in the Graph view, right-click
the complex type containing the element, and click <uicontrol>Add Attribute
Group Ref</uicontrol>.</cmd><info>A declaration that references a global attribute
enables the referenced attribute to appear in the instance document in the
context of the referencing declaration.</info>
<substeps>
<substep><cmd>Select the reference, then select the attribute group you want
it to reference in the Properties view, from the<uicontrol>Ref</uicontrol> menu.</cmd>
</substep>
</substeps>
</step>
<step><cmd>An <codeph>any</codeph> element enables element content according
to namespaces, and the corresponding <codeph>any</codeph> attribute element
enables attributes to appear in elements. To add an <codeph>any</codeph> attribute,
right-click your attribute group and click <uicontrol>Add Any Attribute</uicontrol>.</cmd>
<info>The <codeph>any</codeph> appears below the attribute group in the Outline
view. You can specify the following values for an <codeph>any</codeph> attribute:</info>
<choices>
<choice>For a <b>namespace</b> value, you can select <b>##any</b> (this allows
any well-formed XML from any namespace), <b>##local </b> (this allows any
well-formed XML that is not declared to be in a namespace), <b>##other </b> (this
allows any well-formed XML that is not from the target namespace of the type
being defined) or <b>##targetNamespace </b> (which is shorthand for the target
namespace of the type being defined). </choice>
<choice>For a <uicontrol>processContents</uicontrol> value, you can select <b>skip</b> (the
XML processor will not validate the attribute content at all), <b>lax</b> (the
XML processor will validate the attribute content as much as it can), or <b>strict</b> (the
XML processor will validate all the attribute content).</choice>
</choices>
</step>
</steps>
</taskbody>
</task>