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

 <?xml version="1.0" encoding="utf-8"?>
 <!--Arbortext, Inc., 1988-2005, v.4002-->
 <!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>
 <!-- /*******************************************************************************
  * Copyright (c) 2000, 2005 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
  *******************************************************************************/ -->
 <link href="../../org.eclipse.wst.doc.user/common.css" rel="stylesheet" type="text/css"/>
 <title>Adding simple types</title>
 </head>
 <body id="taddsmpt"><a name="taddsmpt"><!-- --></a> <h1 class="topictitle1">Adding
 simple types</h1> <div><p>Simple types are used to created derived datatypes.
 They provide a set of constraints on the value space (that is, a set of values)
 and the lexical space (that is, a set of valid literals) of a datatype.</p> <div
 class="section"><p>A simple type cannot have element content and cannot carry
 attributes. Elements that contain numbers (and strings, and dates, and so
 on) but do not contain any sub-elements are said to have a simple type.</p> <p>The
 following instructions were written for the Resource perspective, but they
 will also work in many other perspectives.</p> <p>To add a simple type, follow
 these steps:</p> </div> <ol>
 <li class="stepexpand"><span>Open your XML schema in the XML schema editor.</span></li>
 <li class="stepexpand"><span>In the Outline view, select your schema.</span> The
 entire schema and its contents should be displayed in the Graph view.</li>
 <li class="stepexpand"><span>In the Graph view, right-click in the <strong>Types</strong> section
 and click <b> <span class="uicontrol">Add Simple Type</span></b>.</span></li>
 <li class="stepexpand"><span>In the Properties view, click the <span class="uicontrol">General</span> tab,
 and type a new name for the simple type in the <b> <span class="uicontrol">Name</span></b> field.</span></li>
 <li class="stepexpand"><span>You can select the following options from the <b> <span
 class="uicontrol">Variety</span></b> list:</span><ul>
 <li> 	<b><span class="uicontrol">atomic</span></b>. Atomic types are all the
 simple types built into the XML schema language.</li>
 <li><b><span class="uicontrol">list</span></b>. List types are comprised of
 sequences of atomic types. They have values that are comprised of finite-length
 sequences of atomic values. </li>
 <li><b><span class="uicontrol">union</span></b>. A union type enables an element
 or attribute value to be one or more instances of one type drawn from the
 union of multiple atomic and list types.</li>
 </ul> </li>
 <li class="stepexpand"><span>If you selected <span class="uicontrol">atomic</span> from
 the  <b> <span class="uicontrol">Variety</span></b> drop down list, click
 the <b> <span class="uicontrol">Browse</span></b> <img alt="This graphic is the Browse button"
 src="../images/Browse.gif"/> button next to the  <b> <span class="uicontrol">Base
 type</span></b> field to specify a base type for the simple type.</span> The
 Set  Type dialog lists all built-in and user-defined types currently available.
 You  can change the <b> <span class="uicontrol">Scope</span></b> of the list
 by selecting one of the following options:<ul>
 <li><b><span class="uicontrol">Workspace</span></b>. Lists all of the types
 available in your workspace. </li>
 <li><b><span class="uicontrol">Enclosing Project</span></b>. Lists all of
 the types available in the project that contains your file. </li>
 <li>(Default)<b> <span class="uicontrol">Current Resource</span>.</b> List
 all of the types available in your current file.</li>
 </ul> 	</li>
 <li class="stepexpand"><span>If you selected <span class="uicontrol">list</span> from
 the  <b> <span class="uicontrol">Variety</span></b> drop down list, click
 the <b> <span class="uicontrol">Browse</span></b> <img alt="This graphic is the Browse button"
 src="../images/Browse.gif"/> button next to the  <b> <span class="uicontrol">Item
 type</span> </b>field to specify a item type for the simple type.</span> The
 Set Type dialog lists all built-in and user-defined types currently available.
 You can change the <b> <span class="uicontrol">Scope</span></b> of the list
 by selecting one of the following options:<ul>
 <li><b><span class="uicontrol">Workspace</span></b>. Lists all of the types
 available in your workspace. </li>
 <li><b><span class="uicontrol">Enclosing Project</span></b>. Lists all of
 the types available in the project that contains your file. </li>
 <li>(Default) <b> <span class="uicontrol">Current Resource</span></b>. List
 all of the types available in your current file.</li>
 </ul> 	</li>
 <li class="stepexpand"><span>If you selected <span class="uicontrol">union</span> from
 the  <b> <span class="uicontrol">Variety</span></b> drop down list, click
 the <b> <span class="uicontrol">Browse</span></b> <img alt="This graphic is the Browse button"
 src="../images/Browse.gif"/> button next to the  <b> <span class="uicontrol">Member
 types</span> </b>field to specify the member types for the simple type.</span> You
 can select to add both  <b> <span class="uicontrol">Built-in simple types</span></b> and <b> <span
 class="uicontrol">User-defined simple types</span></b> to the member types
 value list. </li>
 <li class="stepexpand"><span>Click the <b> <span class="uicontrol">Enumerations</span></b> tab.</span> Enumerations
 help you to define a set of valid values for simple types. They are the actual
 values the simple type can take as valid values in the instance document.
 You can either add one enumeration or several enumerations at a time:<ol type="a">
 <li class="substepexpand"><span>To add one enumeration at a time, click the
  	<b> <span class="uicontrol">Add</span></b> button and specify a value for
 the enumeration.</span></li>
 <li class="substepexpand"><span>To add several enumerations at one time, follow
 these steps:</span> <ol type="i">
 <li>Click the  	<b> <span class="uicontrol">Add...</span></b> button.</li>
 <li>Enter the value of each enumeration. Each value must be separated by the <b> <span
 class="uicontrol">Delimiter character</span></b>. For example: <samp class="codeph">First,
 Second</samp> will create two enumerations, one with the value "First" and
 one with the value "Second".</li>
 <li>Select the <b> <span class="uicontrol">Preserve leading and trailing whitespace</span></b> check
 box if you want any white space around your enumeration values to be preserved.
 If, for example, you select this check box, the values of <samp class="codeph">First,
 Second</samp> will show up as "First" and " Second" (there is a space before
 Second) because you put a space before "Second" when entered the value.</li>
 <li>Click <b> <span class="uicontrol">OK</span></b>. Your enumerations will
 be created and appear in the Properties view.</li>
 </ol> </li>
 </ol> </li>
 <li class="skipspace"><span>Click the <b> <span class="uicontrol">Documentation</span></b> tab
 if you want to provide any information about this simple type.</span> The <span
 class="uicontrol">Documentation</span> page is used for human readable material,
 such as a description, and the <span class="uicontrol">App Info</span> page
 can be used to provide information for applications.</li>
 <li class="skipspace"><span>Click the <b> <span class="uicontrol">Advanced</span></b> tab.</span> The
 options available from this page will vary depending on what option you selected
 in the <b> <span class="uicontrol">Variety</span></b> field, and the <b> <span
 class="uicontrol">Base type</span>,</b> <b> <span class="uicontrol">Item type</span>,</b> or <b> <span
 class="uicontrol">Member types</span></b> field on the <span class="uicontrol">General</span> page.</li>
 <li class="skipspace"><span>If applicable to the type, the <b> <span class="uicontrol">Facets</span></b> table
 will be populated with constraining facets. A constraining facet is an optional
 property that can be applied to a datatype to constrain its value.</span><ol
 type="a">
 <li><span>To change a facet's value, click its name in the  	<b> <span class="uicontrol">Name</span></b> column,
 then click its value (or the empty cell that will contain its value) in the <b> <span
 class="uicontrol">Value</span></b> column and type or select a new value.</span></li>
 <li><span> To change whether a facet's value is fixed or not, click its name
 in the <b>Name</b> column, then click the appropriate cell in the <b>Fixed</b> column,
 and change the value to true or false.</span></li>
 </ol> </li>
 <li class="stepexpand"><span>If applicable to the type, a Pattern page will
 be available. Click the <b> <span class="uicontrol">Patterns</span></b> tab
 to switch to it.</span> A pattern can be used to constrain the value of a
 type's lexical space (the set of string literals that represent the values
 of a type), which indirectly constrains the value space. For more information
 on adding a pattern to a simple type, refer to the related tasks.</li>
 </ol> 	<p><b class="reltaskshd">Related tasks</b><br/> 	<a href="taddreg.html">Adding
 pattern facets to simple types</a></p> 	</div> </body>
 </html>
	<?xml version="1.0" encoding="utf-8"?>
	<!--Arbortext, Inc., 1988-2005, v.4002-->
	<!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>
	<!-- /*******************************************************************************
	* Copyright (c) 2000, 2005 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
	*******************************************************************************/ -->
	<link href="../../org.eclipse.wst.doc.user/common.css" rel="stylesheet" type="text/css"/>
	<title>Adding simple types</title>
	</head>
	<body id="taddsmpt"><a name="taddsmpt"><!-- --></a> <h1 class="topictitle1">Adding
	simple types</h1> <div><p>Simple types are used to created derived datatypes.
	They provide a set of constraints on the value space (that is, a set of values)
	and the lexical space (that is, a set of valid literals) of a datatype.</p> <div
	class="section"><p>A simple type cannot have element content and cannot carry
	attributes. Elements that contain numbers (and strings, and dates, and so
	on) but do not contain any sub-elements are said to have a simple type.</p> <p>The
	following instructions were written for the Resource perspective, but they
	will also work in many other perspectives.</p> <p>To add a simple type, follow
	these steps:</p> </div> <ol>
	<li class="stepexpand"><span>Open your XML schema in the XML schema editor.</span></li>
	<li class="stepexpand"><span>In the Outline view, select your schema.</span> The
	entire schema and its contents should be displayed in the Graph view.</li>
	<li class="stepexpand"><span>In the Graph view, right-click in the <strong>Types</strong> section
	and click <b> <span class="uicontrol">Add Simple Type</span></b>.</span></li>
	<li class="stepexpand"><span>In the Properties view, click the <span class="uicontrol">General</span> tab,
	and type a new name for the simple type in the <b> <span class="uicontrol">Name</span></b> field.</span></li>
	<li class="stepexpand"><span>You can select the following options from the <b> <span
	class="uicontrol">Variety</span></b> list:</span><ul>
	<li> <b><span class="uicontrol">atomic</span></b>. Atomic types are all the
	simple types built into the XML schema language.</li>
	<li><b><span class="uicontrol">list</span></b>. List types are comprised of
	sequences of atomic types. They have values that are comprised of finite-length
	sequences of atomic values. </li>
	<li><b><span class="uicontrol">union</span></b>. A union type enables an element
	or attribute value to be one or more instances of one type drawn from the
	union of multiple atomic and list types.</li>
	</ul> </li>
	<li class="stepexpand"><span>If you selected <span class="uicontrol">atomic</span> from
	the <b> <span class="uicontrol">Variety</span></b> drop down list, click
	the <b> <span class="uicontrol">Browse</span></b> <img alt="This graphic is the Browse button"
	src="../images/Browse.gif"/> button next to the <b> <span class="uicontrol">Base
	type</span></b> field to specify a base type for the simple type.</span> The
	Set Type dialog lists all built-in and user-defined types currently available.
	You can change the <b> <span class="uicontrol">Scope</span></b> of the list
	by selecting one of the following options:<ul>
	<li><b><span class="uicontrol">Workspace</span></b>. Lists all of the types
	available in your workspace. </li>
	<li><b><span class="uicontrol">Enclosing Project</span></b>. Lists all of
	the types available in the project that contains your file. </li>
	<li>(Default)<b> <span class="uicontrol">Current Resource</span>.</b> List
	all of the types available in your current file.</li>
	</ul> </li>
	<li class="stepexpand"><span>If you selected <span class="uicontrol">list</span> from
	the <b> <span class="uicontrol">Variety</span></b> drop down list, click
	the <b> <span class="uicontrol">Browse</span></b> <img alt="This graphic is the Browse button"
	src="../images/Browse.gif"/> button next to the <b> <span class="uicontrol">Item
	type</span> </b>field to specify a item type for the simple type.</span> The
	Set Type dialog lists all built-in and user-defined types currently available.
	You can change the <b> <span class="uicontrol">Scope</span></b> of the list
	by selecting one of the following options:<ul>
	<li><b><span class="uicontrol">Workspace</span></b>. Lists all of the types
	available in your workspace. </li>
	<li><b><span class="uicontrol">Enclosing Project</span></b>. Lists all of
	the types available in the project that contains your file. </li>
	<li>(Default) <b> <span class="uicontrol">Current Resource</span></b>. List
	all of the types available in your current file.</li>
	</ul> </li>
	<li class="stepexpand"><span>If you selected <span class="uicontrol">union</span> from
	the <b> <span class="uicontrol">Variety</span></b> drop down list, click
	the <b> <span class="uicontrol">Browse</span></b> <img alt="This graphic is the Browse button"
	src="../images/Browse.gif"/> button next to the <b> <span class="uicontrol">Member
	types</span> </b>field to specify the member types for the simple type.</span> You
	can select to add both <b> <span class="uicontrol">Built-in simple types</span></b> and <b> <span
	class="uicontrol">User-defined simple types</span></b> to the member types
	value list. </li>
	<li class="stepexpand"><span>Click the <b> <span class="uicontrol">Enumerations</span></b> tab.</span> Enumerations
	help you to define a set of valid values for simple types. They are the actual
	values the simple type can take as valid values in the instance document.
	You can either add one enumeration or several enumerations at a time:<ol type="a">
	<li class="substepexpand"><span>To add one enumeration at a time, click the
	<b> <span class="uicontrol">Add</span></b> button and specify a value for
	the enumeration.</span></li>
	<li class="substepexpand"><span>To add several enumerations at one time, follow
	these steps:</span> <ol type="i">
	<li>Click the <b> <span class="uicontrol">Add...</span></b> button.</li>
	<li>Enter the value of each enumeration. Each value must be separated by the <b> <span
	class="uicontrol">Delimiter character</span></b>. For example: <samp class="codeph">First,
	Second</samp> will create two enumerations, one with the value "First" and
	one with the value "Second".</li>
	<li>Select the <b> <span class="uicontrol">Preserve leading and trailing whitespace</span></b> check
	box if you want any white space around your enumeration values to be preserved.
	If, for example, you select this check box, the values of <samp class="codeph">First,
	Second</samp> will show up as "First" and " Second" (there is a space before
	Second) because you put a space before "Second" when entered the value.</li>
	<li>Click <b> <span class="uicontrol">OK</span></b>. Your enumerations will
	be created and appear in the Properties view.</li>
	</ol> </li>
	</ol> </li>
	<li class="skipspace"><span>Click the <b> <span class="uicontrol">Documentation</span></b> tab
	if you want to provide any information about this simple type.</span> The <span
	class="uicontrol">Documentation</span> page is used for human readable material,
	such as a description, and the <span class="uicontrol">App Info</span> page
	can be used to provide information for applications.</li>
	<li class="skipspace"><span>Click the <b> <span class="uicontrol">Advanced</span></b> tab.</span> The
	options available from this page will vary depending on what option you selected
	in the <b> <span class="uicontrol">Variety</span></b> field, and the <b> <span
	class="uicontrol">Base type</span>,</b> <b> <span class="uicontrol">Item type</span>,</b> or <b> <span
	class="uicontrol">Member types</span></b> field on the <span class="uicontrol">General</span> page.</li>
	<li class="skipspace"><span>If applicable to the type, the <b> <span class="uicontrol">Facets</span></b> table
	will be populated with constraining facets. A constraining facet is an optional
	property that can be applied to a datatype to constrain its value.</span><ol
	type="a">
	<li><span>To change a facet's value, click its name in the <b> <span class="uicontrol">Name</span></b> column,
	then click its value (or the empty cell that will contain its value) in the <b> <span
	class="uicontrol">Value</span></b> column and type or select a new value.</span></li>
	<li><span> To change whether a facet's value is fixed or not, click its name
	in the <b>Name</b> column, then click the appropriate cell in the <b>Fixed</b> column,
	and change the value to true or false.</span></li>
	</ol> </li>
	<li class="stepexpand"><span>If applicable to the type, a Pattern page will
	be available. Click the <b> <span class="uicontrol">Patterns</span></b> tab
	to switch to it.</span> A pattern can be used to constrain the value of a
	type's lexical space (the set of string literals that represent the values
	of a type), which indirectly constrains the value space. For more information
	on adding a pattern to a simple type, refer to the related tasks.</li>
	</ol> <p><b class="reltaskshd">Related tasks</b><br/> <a href="taddreg.html">Adding
	pattern facets to simple types</a></p> </div> </body>
	</html>