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

 <?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html lang="en-us" xml:lang="en-us">
 <head>
 <meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
 <meta name="copyright" content="Copyright (c) 2000, 2006 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: IBM Corporation - initial API and implementation" />
 <meta name="DC.rights.owner" content="(C) Copyright 2000, 2006" />
 <meta content="public" name="security" />
 <meta content="index,follow" name="Robots" />
 <meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
 <meta content="task" name="DC.Type" />
 <meta name="DC.Title" content="Adding elements" />
 <meta name="abstract" content="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." />
 <meta name="description" content="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." />
 <meta content="XML schema editor, adding, elements, XML schema files" name="DC.subject" />
 <meta content="XML schema editor, adding, elements, XML schema files" name="keywords" />
 <meta scheme="URI" name="DC.Relation" content="../topics/taddcmod.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/taddelmr.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/taddanye.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/taddglba.html" />
 <meta content="XHTML" name="DC.Format" />
 <meta content="taddelm" name="DC.Identifier" />
 <meta content="en-us" name="DC.Language" />
 <link href="../../org.eclipse.wst.doc.user/common.css" type="text/css" rel="stylesheet" />
 <title>Adding elements</title>
 </head>
 <body id="taddelm"><a name="taddelm"><!-- --></a>


 <h1 class="topictitle1">Adding elements</h1>


 <div><p>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.</p>

 <div class="section"><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:</p>
 </div>

 <ol>
 <li class="stepexpand"><span>To add an element, in the Design view, right-click the content
 model you want to work with and click <span class="uicontrol">Add Element</span>.</span>
  The element appears attached to the content model in the Design view.
 <ol type="a">
 <li class="substepexpand"><span>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 <span class="uicontrol">Name</span> and press enter.</span></li>

 <li class="substepexpand"><span>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.</span> The Set Type dialog lists
 all built-in and user-defined types currently available. You can change the <span class="uicontrol">Scope</span> of
 the list by selecting one of the following options:<ul>
 <li><span class="uicontrol">Workspace</span>. Lists all of the types available in
 your workspace.</li>

 <li><span class="uicontrol">Enclosing Project</span>. Lists all of the types available
 in the project that contains your file.</li>

 <li>(Default) <span class="uicontrol">Current Resource</span>. List all of the types
 available in your current file.</li>

 <li><span class="uicontrol">Working Sets</span>. List all the types available within
 the selected working set.</li>

 </ul>
 </li>

 </ol>

 </li>

 <li class="stepexpand"><span>(Optional) In the Properties view, select the appropriate value
 in the <span class="uicontrol">MinOccurs</span> field.</span> This is the number
 of times the element can appear in an instance document. If you want the element
 to be optional, select <span class="uicontrol">0</span>. Otherwise, select <span class="uicontrol">1</span>.
 </li>

 <li class="stepexpand"><span>(Optional) Select the appropriate value in the <span class="uicontrol">MaxOccurs</span> field.</span>
  This is the maximum number of times the element can appear in an instance
 document. Select <span class="uicontrol">unbounded</span> to indicate there is no
 maximum number of occurrences.</li>

 <li class="stepexpand"><span>Click the <span class="uicontrol">Documentation</span> tab if you want
 to provide any information about this element.</span> The <span class="uicontrol">Documentation</span> page
 is used for human readable material, such as a description.</li>

 <li class="stepexpand"><span>Click the <span class="uicontrol">Extensions</span> tab if you want to
 add application information elements to your annotations of schema components.</span>
  The <span class="uicontrol">Extensions</span> page allows you to specify the
 schema and add XML content to your annotations.</li>

 </ol>

 <div class="section">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.</div>

 </div>

 <div><div class="reltasks"><strong>Related tasks</strong><br />
 <div><a href="../topics/taddcmod.html" title="A content model is the representation of any data that can be contained inside an element, global element, complex type, or group. It is a formal description of the structure and permissible content of an element, global element, complex type, or group, which may be used to validate a document instance.">Adding content models</a></div>
 <div><a href="../topics/taddelmr.html" title="An element reference provides a reference to a global element. A declaration that references a global element enables the referenced global element to appear in the instance document in the context of the referencing declaration.">Adding element references</a></div>
 <div><a href="../topics/taddanye.html" title="You can use the any element in a similar way as a DTD's ANY content model, however, it must be done in conjunction with namespaces. This enables you to include any well-formed XML content, such as an HTML Web page that conforms to XHTML 1.0 syntax.">Adding an any element</a></div>
 <div><a href="../topics/taddglba.html" title="A global attribute is an attribute that can be recognized anywhere in a document. Once declared, a global attribute can be referenced in one or more declarations using an attribute reference.">Adding global attributes</a></div>
 </div>
 </div>

 </body>
 </html>
	<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
	<html lang="en-us" xml:lang="en-us">
	<head>
	<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
	<meta name="copyright" content="Copyright (c) 2000, 2006 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: IBM Corporation - initial API and implementation" />
	<meta name="DC.rights.owner" content="(C) Copyright 2000, 2006" />
	<meta content="public" name="security" />
	<meta content="index,follow" name="Robots" />
	<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
	<meta content="task" name="DC.Type" />
	<meta name="DC.Title" content="Adding elements" />
	<meta name="abstract" content="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." />
	<meta name="description" content="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." />
	<meta content="XML schema editor, adding, elements, XML schema files" name="DC.subject" />
	<meta content="XML schema editor, adding, elements, XML schema files" name="keywords" />
	<meta scheme="URI" name="DC.Relation" content="../topics/taddcmod.html" />
	<meta scheme="URI" name="DC.Relation" content="../topics/taddelmr.html" />
	<meta scheme="URI" name="DC.Relation" content="../topics/taddanye.html" />
	<meta scheme="URI" name="DC.Relation" content="../topics/taddglba.html" />
	<meta content="XHTML" name="DC.Format" />
	<meta content="taddelm" name="DC.Identifier" />
	<meta content="en-us" name="DC.Language" />
	<link href="../../org.eclipse.wst.doc.user/common.css" type="text/css" rel="stylesheet" />
	<title>Adding elements</title>
	</head>
	<body id="taddelm"><a name="taddelm"><!-- --></a>


	<h1 class="topictitle1">Adding elements</h1>




	<div><p>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.</p>

	<div class="section"><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:</p>
	</div>

	<ol>
	<li class="stepexpand"><span>To add an element, in the Design view, right-click the content
	model you want to work with and click <span class="uicontrol">Add Element</span>.</span>
	The element appears attached to the content model in the Design view.
	<ol type="a">
	<li class="substepexpand"><span>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 <span class="uicontrol">Name</span> and press enter.</span></li>

	<li class="substepexpand"><span>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.</span> The Set Type dialog lists
	all built-in and user-defined types currently available. You can change the <span class="uicontrol">Scope</span> of
	the list by selecting one of the following options:<ul>
	<li><span class="uicontrol">Workspace</span>. Lists all of the types available in
	your workspace.</li>

	<li><span class="uicontrol">Enclosing Project</span>. Lists all of the types available
	in the project that contains your file.</li>

	<li>(Default) <span class="uicontrol">Current Resource</span>. List all of the types
	available in your current file.</li>

	<li><span class="uicontrol">Working Sets</span>. List all the types available within
	the selected working set.</li>

	</ul>
	</li>

	</ol>

	</li>

	<li class="stepexpand"><span>(Optional) In the Properties view, select the appropriate value
	in the <span class="uicontrol">MinOccurs</span> field.</span> This is the number
	of times the element can appear in an instance document. If you want the element
	to be optional, select <span class="uicontrol">0</span>. Otherwise, select <span class="uicontrol">1</span>.
	</li>

	<li class="stepexpand"><span>(Optional) Select the appropriate value in the <span class="uicontrol">MaxOccurs</span> field.</span>
	This is the maximum number of times the element can appear in an instance
	document. Select <span class="uicontrol">unbounded</span> to indicate there is no
	maximum number of occurrences.</li>

	<li class="stepexpand"><span>Click the <span class="uicontrol">Documentation</span> tab if you want
	to provide any information about this element.</span> The <span class="uicontrol">Documentation</span> page
	is used for human readable material, such as a description.</li>

	<li class="stepexpand"><span>Click the <span class="uicontrol">Extensions</span> tab if you want to
	add application information elements to your annotations of schema components.</span>
	The <span class="uicontrol">Extensions</span> page allows you to specify the
	schema and add XML content to your annotations.</li>

	</ol>

	<div class="section">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.</div>

	</div>

	<div><div class="reltasks"><strong>Related tasks</strong><br />
	<div><a href="../topics/taddcmod.html" title="A content model is the representation of any data that can be contained inside an element, global element, complex type, or group. It is a formal description of the structure and permissible content of an element, global element, complex type, or group, which may be used to validate a document instance.">Adding content models</a></div>
	<div><a href="../topics/taddelmr.html" title="An element reference provides a reference to a global element. A declaration that references a global element enables the referenced global element to appear in the instance document in the context of the referencing declaration.">Adding element references</a></div>
	<div><a href="../topics/taddanye.html" title="You can use the any element in a similar way as a DTD's ANY content model, however, it must be done in conjunction with namespaces. This enables you to include any well-formed XML content, such as an HTML Web page that conforms to XHTML 1.0 syntax.">Adding an any element</a></div>
	<div><a href="../topics/taddglba.html" title="A global attribute is an attribute that can be recognized anywhere in a document. Once declared, a global attribute can be referenced in one or more declarations using an attribute reference.">Adding global attributes</a></div>
	</div>
	</div>

	</body>
	</html>