<?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>