blob: 9db7e7736bc5a0e3c7b9246c3c90a2c72e8546e0 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "">
<!-- /*******************************************************************************
* 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
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/ -->
<link rel="stylesheet" type="text/css" href="../../org.eclipse.wst.doc.user/common.css" />
<title>Adding pattern facets to simple types</title>
<body id="taddreg"><a name="taddreg"><!-- --></a>
<h1 class="topictitle1">Adding pattern facets to simple types</h1>
<div><div class="skipspace"><p>A pattern facet 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. </p>
<p>The value of the pattern is called
a regular expression. You can specify it using the<b> <span class="uicontrol">Regular Expression</span></b> wizard.</p>
add a pattern to a simple type, follow these steps:</p>
<ol><li class="skipspace"><span>In the Graph view, select the simple type you want to work with.</span></li>
<li class="skipspace"><span>In the Properties view, click the <b> <span class="uicontrol">Advanced</span></b> tab,
then the <b> <span class="uicontrol">Patterns</span></b> tab.</span> The <b> <span class="uicontrol">Patterns</span></b> tab
will only appear if the pattern facet is applicable to the base type of the
simple type.</li>
<li class="skipspace"><span>Click <b> <span class="uicontrol">Add</span></b>.</span> The Regular Expression
Wizard opens.</li>
<li class="skipspace"><span>Select the token you want to add to the expression.</span></li>
<li class="skipspace"><span>Indicate how often you want the token to appear in order for a
match to succeed.</span> If you want the token to repeat, click <span class="uicontrol">
<b>Repeat</b> </span>and
specify the number of times the token must appear. If you want to specify
a minimum and maximum number of times the token can appear, click <b> <span class="uicontrol">Range</span></b> and
enter a minimum and maximum value.</li>
<li class="skipspace"><span>Click <b> <span class="uicontrol">Add</span></b> to
add the token to the regular expression.</span></li>
<li class="skipspace"><span>Repeat the previous three steps as necessary to create the entire
<li class="skipspace"><span>When you are finished, click <b> <span class="uicontrol">Next</span></b>.</span></li>
<li class="skipspace"><span>(Optional) Enter some sample text to test against the regular expression
and see if a match occurs. </span></li>
<li class="skipspace"><span>Click<span class="uicontrol"> <b>Finish</b></span>.</span></li>
<div class="skipspace">The regular expression will appear in the Patterns page.</div>
<p>To edit an existing pattern, select it in the Patterns page and click <b>
<span class="uicontrol">Edit</span></b>. To delete an existing pattern, select
it in the Patterns page and click <b><span class="uicontrol">Delete</span></b>.
<p><b class="reltaskshd">Related tasks</b><br />
<a title="As schemas become larger, it is often desirable to divide their content among several schema documents for purposes such as ease of maintenance, reuse, and readability. XML schema defines two constructs to support this: include and import. The include element brings in definitions and declarations from the included schema into the current schema. It requires the included schema to be in the same target namespace as the including schema. The import element behaves in a similar way, with the exception that the imported schema can come from a different namespace." href="taddsmpt.html">Adding
simple types</a></p>