| <?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="taddelm" xml:lang="en-us"> | |
| <title>Adding elements</title> | |
| <titlealts> | |
| <searchtitle>Adding elements</searchtitle> | |
| </titlealts> | |
| <shortdesc>Elements are fundamental building blocks in XML. Element | |
| declarations provide value constraints, provide a description that | |
| can be used for validation, establish constraining relationships between | |
| related elements and attributes, and control the substitution of elements.</shortdesc> | |
| <prolog><metadata> | |
| <keywords><indexterm>XML schema editor<indexterm>elements</indexterm></indexterm> | |
| <indexterm>XML schema files<indexterm>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 element, complete the following steps:</p></context> | |
| <steps> | |
| <step><cmd>To add an element, in the Design view, right-click the | |
| content model (sequence, choice, or all element) you want to work | |
| with and click <uicontrol>Add Element</uicontrol>.</cmd><info>The | |
| element appears attached to the content model in the Design view.</info> | |
| <substeps> | |
| <substep><cmd>In the Design view, select the element, and click the | |
| current (default) name of the element, which puts you in direct editing | |
| mode, then type the new <uicontrol>Name</uicontrol> and press enter.</cmd> | |
| </substep> | |
| <substep><cmd>In the Design view, click the current (default) element | |
| type and select a type from the menu. Alternately, you can select | |
| browse to invoke the Set Type dialog 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>(Optional) In the Properties view, select the appropriate | |
| value in the <uicontrol>Minimum Occurrence</uicontrol> field. </cmd> | |
| <info>This is the number of times the element can appear in an instance | |
| document. If you want the element to be optional, select <uicontrol>0</uicontrol>. | |
| Otherwise, select <uicontrol>1</uicontrol>. </info></step> | |
| <step><cmd>(Optional) Select the appropriate value in the <uicontrol>Maximum | |
| Occurrence</uicontrol> field. </cmd><info>This is the maximum number | |
| of times the element can appear in an instance document. Select <uicontrol>unbounded</uicontrol> to | |
| indicate there is no maximum number of occurrences.</info></step> | |
| <step><cmd>Click the <uicontrol>Documentation</uicontrol> tab if you | |
| want to provide any information about this 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. <?Pub Caret?></cmd><info>The <uicontrol>Extensions</uicontrol> page | |
| allows you to specify the schema and add XML content to your annotations.</info> | |
| </step> | |
| </steps> | |
| <postreq>You can add a content model to an element, which is the representation | |
| of any data that can be contained inside the element. For more information | |
| about working with content models, refer to the related tasks.</postreq> | |
| </taskbody> | |
| </task> | |
| <?Pub *0000003893?> |