Gitiles
Code Review Sign In
git.eclipse.org / sourceediting / webtools.sourceediting / c7d8db0656c8cd6915f3e59b01d7da39b29c8a5c / . / docs / org.eclipse.wst.xsdeditor.doc.user / topics / taddelmr.html
blob: ac1e9660984e37f70d2e0f96cddd848b030478e5 [file] [log] [blame]
kprice159fa582006-05-08 21:30:45 +0000[diff] [blame]1<?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">
2<html lang="en-us" xml:lang="en-us">
syeshinf3d0d4b2005-07-27 18:33:03 +0000[diff] [blame]3<head>
kprice159fa582006-05-08 21:30:45 +0000[diff] [blame]4<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
kpricede20a692008-04-24 00:27:47 +0000[diff] [blame]5<meta name="copyright" content="Copyright (c) 2000, 2008 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" />
6<meta name="DC.rights.owner" content="(C) Copyright 2000, 2008" />
kprice159fa582006-05-08 21:30:45 +0000[diff] [blame]7<meta content="public" name="security" />
8<meta content="index,follow" name="Robots" />
9<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))' />
10<meta content="task" name="DC.Type" />
11<meta name="DC.Title" content="Adding element references" />
12<meta name="abstract" content="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." />
13<meta name="description" content="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." />
kpricede20a692008-04-24 00:27:47 +0000[diff] [blame]14<meta content="XML schema editor, element references, XML schema files" name="DC.subject" />
15<meta content="XML schema editor, element references, XML schema files" name="keywords" />
kprice43d0c0f2006-05-18 15:56:09 +0000[diff] [blame]16<meta scheme="URI" name="DC.Relation" content="../topics/taddglem.html" />
17<meta scheme="URI" name="DC.Relation" content="../topics/taddelm.html" />
18<meta scheme="URI" name="DC.Relation" content="../topics/taddanye.html" />
19<meta scheme="URI" name="DC.Relation" content="../topics/taddglba.html" />
kprice159fa582006-05-08 21:30:45 +0000[diff] [blame]20<meta content="XHTML" name="DC.Format" />
21<meta content="taddelmr" name="DC.Identifier" />
22<meta content="en-us" name="DC.Language" />
23<link href="../../org.eclipse.wst.doc.user/common.css" type="text/css" rel="stylesheet" />
24<title>Adding element references</title>
syeshin8f077832005-09-06 04:22:45 +0000[diff] [blame]25</head>
kprice159fa582006-05-08 21:30:45 +0000[diff] [blame]26<body id="taddelmr"><a name="taddelmr"><!-- --></a>
27
28
29<h1 class="topictitle1">Adding element references</h1>
30
31
32
33
34<div><p>An element reference provides a reference to a global element.
35A declaration that references a global element enables the referenced global
36element to appear in the instance document in the context of the referencing
37declaration.</p>
38
39<div class="section"><p>The following instructions were written for the Resource perspective,
40but they will also work in many other perspectives.</p>
41<p>To add an element
kpricede20a692008-04-24 00:27:47 +0000[diff] [blame]42reference, complete the following steps:</p>
kprice159fa582006-05-08 21:30:45 +0000[diff] [blame]43</div>
44
45<ol>
kpricede20a692008-04-24 00:27:47 +0000[diff] [blame]46<li class="stepexpand"><span>In the Design view, right-click the content model (sequence, choice,
47or all element) you want to work with and click <span class="uicontrol">Add Element Ref</span>.</span>
48 If no global element is defined in the document, a new global
49element is created for you, and the element reference will point to it.
50</li>
kprice159fa582006-05-08 21:30:45 +0000[diff] [blame]51
kprice43d0c0f2006-05-18 15:56:09 +0000[diff] [blame]52<li class="stepexpand"><span>Select the element reference. To specify values for an element
53reference:</span>
kprice159fa582006-05-08 21:30:45 +0000[diff] [blame]54<ul>
kprice43d0c0f2006-05-18 15:56:09 +0000[diff] [blame]55<li>Click the name of the element reference in the Design view. Enter
56the name of the element reference.</li>
kprice159fa582006-05-08 21:30:45 +0000[diff] [blame]57
kpricede20a692008-04-24 00:27:47 +0000[diff] [blame]58<li>Click the element reference type in the Design view. Select a type
59from the menu, or select <span class="uicontrol">Browse</span> for more options.</li>
kprice159fa582006-05-08 21:30:45 +0000[diff] [blame]60
61</ul>
62
63</li>
64
kpricede20a692008-04-24 00:27:47 +0000[diff] [blame]65<li class="stepexpand"><span>(Optional) Select the appropriate value in the <span class="uicontrol">Minimum
66Occurrence</span> field.</span> This is the number of times the global
67element referenced can appear in an instance document. If you want the element
68to be optional, select <span class="uicontrol">0</span>. Otherwise, select <span class="uicontrol">1</span>.
69</li>
kprice159fa582006-05-08 21:30:45 +0000[diff] [blame]70
kpricede20a692008-04-24 00:27:47 +0000[diff] [blame]71<li class="stepexpand"><span>(Optional) Select the appropriate value in the <span class="uicontrol">Maximum
72Occurrence</span> field.</span> This is the maximum
73number of times the global element referenced can appear. You can select <span class="uicontrol">unbounded</span> to
74indicate there is no maximum number of occurrences.</li>
kprice159fa582006-05-08 21:30:45 +0000[diff] [blame]75
76<li class="stepexpand"><span>Click the <span class="uicontrol">Documentation</span> tab if you want
77to provide any information about this element reference.</span> The <span class="uicontrol">Documentation</span> page
kprice43d0c0f2006-05-18 15:56:09 +0000[diff] [blame]78is used for human readable material, such as a description.</li>
79
80<li class="stepexpand"><span>Click the <span class="uicontrol">Extensions</span> tab if you want to
81add application information elements to your annotations of schema components.</span>
82 The <span class="uicontrol">Extensions</span> page allows you to specify the
83schema and add XML content to your annotations.</li>
kprice159fa582006-05-08 21:30:45 +0000[diff] [blame]84
85</ol>
86
87</div>
88
kprice43d0c0f2006-05-18 15:56:09 +0000[diff] [blame]89<div><div class="reltasks"><strong>Related tasks</strong><br />
90<div><a href="../topics/taddglem.html" title="A global element is an element with a global scope. It is one that has been declared as part of the main schema rather than as part of a content model.">Adding global elements</a></div>
91<div><a href="../topics/taddelm.html" title="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.">Adding elements</a></div>
92<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>
93<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>
94</div>
95</div>
kprice159fa582006-05-08 21:30:45 +0000[diff] [blame]96
97</body>
98</html>