docs/org.eclipse.wst.xsdeditor.doc.user/topics/taddagrp.dita - sourceediting/webtools.sourceediting - Git at Google

 <?xml version="1.0" encoding="UTF-8"?>
 <!--Arbortext, Inc., 1988-2008, 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>attribute groups</indexterm></indexterm>
 <indexterm>XML schema files<indexterm>attribute groups</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, complete the following 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>Attributes</uicontrol> folder
 and click  <uicontrol>Add Attribute Group</uicontrol>. </cmd><info>It
 appears in the <uicontrol>Attributes</uicontrol> folder.</info></step>
 <step><cmd>Select your new group, and in the Design 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 and click <uicontrol>OK</uicontrol>.</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 Design view, click
 the current (default) name of the attribute, then type the new <uicontrol>Name</uicontrol>.</cmd>
 </substep>
 <substep><cmd>In the Design 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><uicontrol>Current Resource</uicontrol> (default). 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 Design 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. Select
 the reference, then in the Properties view, select the attribute you
 want it to reference from the <uicontrol>Reference</uicontrol> list.<?Pub
 Caret?></info></step>
 <step><cmd>An attribute group reference provides a reference to an
 attribute group. To add an attribute group reference, in the Design
 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. Select
 the reference, then in the Properties view, select the attribute group
 you want it to reference from the <uicontrol>Reference</uicontrol> list.</info>
 </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 <uicontrol>Namespace</uicontrol> value, you can select:<ul>
 <li><b>##any</b>: this allows any well-formed XML from any namespace.</li>
 <li><b>##local </b>: this allows any well-formed XML that is not declared
 to be in a namespace.</li>
 <li><b>##other</b>: this allows any well-formed XML that is not from
 the target namespace of the type being defined.</li>
 <li><b>##targetNamespace </b>: this is shorthand for the target namespace
 of the type being defined.</li>
 </ul></choice>
 <choice>For a <uicontrol>Process Contents</uicontrol> value, you can
 select:<ul>
 <li><b>skip</b>: the XML processor will not validate the attribute
 content at all.</li>
 <li><b>lax</b>: the XML processor will validate the attribute content
 as much as it can.</li>
 <li><b>strict</b>: the XML processor will validate all the attribute
 content.</li>
 </ul></choice>
 </choices>
 </step>
 </steps>
 </taskbody>
 </task>
 <?Pub *0000005544?>
	<?xml version="1.0" encoding="UTF-8"?>
	<!--Arbortext, Inc., 1988-2008, 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>attribute groups</indexterm></indexterm>
	<indexterm>XML schema files<indexterm>attribute groups</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, complete the following 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>Attributes</uicontrol> folder
	and click <uicontrol>Add Attribute Group</uicontrol>. </cmd><info>It
	appears in the <uicontrol>Attributes</uicontrol> folder.</info></step>
	<step><cmd>Select your new group, and in the Design 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 and click <uicontrol>OK</uicontrol>.</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 Design view, click
	the current (default) name of the attribute, then type the new <uicontrol>Name</uicontrol>.</cmd>
	</substep>
	<substep><cmd>In the Design 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><uicontrol>Current Resource</uicontrol> (default). 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 Design 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. Select
	the reference, then in the Properties view, select the attribute you
	want it to reference from the <uicontrol>Reference</uicontrol> list.<?Pub
	Caret?></info></step>
	<step><cmd>An attribute group reference provides a reference to an
	attribute group. To add an attribute group reference, in the Design
	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. Select
	the reference, then in the Properties view, select the attribute group
	you want it to reference from the <uicontrol>Reference</uicontrol> list.</info>
	</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 <uicontrol>Namespace</uicontrol> value, you can select:<ul>
	<li><b>##any</b>: this allows any well-formed XML from any namespace.</li>
	<li><b>##local </b>: this allows any well-formed XML that is not declared
	to be in a namespace.</li>
	<li><b>##other</b>: this allows any well-formed XML that is not from
	the target namespace of the type being defined.</li>
	<li><b>##targetNamespace </b>: this is shorthand for the target namespace
	of the type being defined.</li>
	</ul></choice>
	<choice>For a <uicontrol>Process Contents</uicontrol> value, you can
	select:<ul>
	<li><b>skip</b>: the XML processor will not validate the attribute
	content at all.</li>
	<li><b>lax</b>: the XML processor will validate the attribute content
	as much as it can.</li>
	<li><b>strict</b>: the XML processor will validate all the attribute
	content.</li>
	</ul></choice>
	</choices>
	</step>
	</steps>
	</taskbody>
	</task>
	<?Pub *0000005544?>