To view or edit an element's properties, double-click its diagram symbol or Browser or list entry. The property sheet tabs and fields listed here are those available by default, before any customization of the interface by you or an administrator.
The General tab of an XSD or DTD element property sheet displays the following properties (for XDR element properties, see the subsequent table):
Property |
Description |
---|---|
Name/Code/Comment |
Identify the object. The name should clearly convey the object's purpose to non-technical users, while the code, which is used for generating code or scripts, may be abbreviated, and should not normally include spaces. Neither the name nor code should contain colons. You can optionally add a comment to provide more detailed information about the object. By default the code is generated from the name by applying the naming conventions specified in the model options. To decouple name-code synchronization, click to release the = button to the right of the Code field. |
Stereotype |
Extends the semantics of the object. You can enter a stereotype directly in this field, or add stereotypes to the list by specifying them in an extension file. |
Reference |
Specifies a global element in this or another model to reuse. Disables all other properties. Select an element in the current model from the list or click the Browse tool to select an element from any model open in the workspace. You can locate the referenced element in the diagram by right-clicking the referencing element symbol and selecting Find Referenced Element. |
Group type |
Specifies that the element has child elements, and how they are used (see Group Particles (XSM)). You can choose between:
|
Type |
Specifies the data type. Select a built-in data type from the list or click the Browse tool to select a simple type defined in any model open in the workspace. For an XSD element, selecting a data type will delete any group particle (and its child elements) or attribute previously defined in the element property sheet. Do not select a data type if you want to define attributes or child elements within the current element |
Embedded type |
[XSD only] Specifies a locally defined data type, which applies to the current element only. Automatically set to Complex if you define a derivation for the element data type. |
Content |
[XSD only] Specifies whether the content type of the element is Complex (and can have child elements) or Simple (and cannot). |
Derivation |
[XSD only] Specifies a derivation method for the data type to extend or restrict its values. Resets the Type property to <None>. Click the Properties tool to further define the derivation (see Derivations: Extensions, Restrictions, Lists and Unions (XSM)). |
Keywords |
Provide a way of loosely grouping objects through tagging. To enter multiple keywords, separate them with commas. |
The Detail tab contains the following properties:
Property |
Description |
---|---|
Minimum |
Minimum number of times the element can occur. To specify that the element is optional, set this attribute to zero. |
Maximum |
Maximum number of times the element can occur. For an unlimited number of times, select unbounded. |
Substitution group |
Name of a global element for which the current element can be substituted. It must have the same type or a derived type. Its value must be a qualified name. |
Default |
Specifies a default value for the element. Mutually exclusive with the Fixed property. |
Fixed |
Specifies a fixed value for the element if its content is a simple type or text-only. Mutually exclusive with the Default property. |
Block |
Specifies that another element with the same type of derivation cannot be used in place of the current element. |
Final |
[global elements] Specifies that the element cannot undergo further derivations. |
Form |
Specifies whether or not the element must be qualified by combining the target namespace of the schema with the no-colon-name of the element. |
ID |
Specifies the ID of the element, which must be unique within the model. |
Abstract |
Specifies that the element cannot appear in the instance document. |
Nillable |
Specifies that the element may be null. |
This tab lets you map the element and its attributes to PDM or OOM objects.
You associate one or more PDM or OOM objects to the element using the Add Objects tool on the Element Sources sub-tab. You can associate PDM columns or OOM class attributes to the element attributes using following tools on the Attributes Mapping tab:
For more information on complex type mapping, see Core Features Guide > Linking and Synchronizing Models > Object Mappings.
In a model targeted with the XML-Data Reduced language, elements are defined as follows:
XDR Element Attribute |
Description |
---|---|
Model |
Specifies if an element can contain new local elements. Possible values are:
|
Content |
General tab: Group type/Type |
Order |
General tab: Group type |
dt:type |
Specifies a data type. General tab: Type |
dt:values |
Specifies a list of possible element values. Values tab |
type |
[local elements only] Specifies the name of a global element as reference for the local element General tab: Reference |
minOccurs |
[local elements only] To specify the minimum number of occurrences for a local element. Usually set to 0 or 1 Detail tab: Minimum |
maxOccurs |
[local elements only] To specify the maximum number of occurrences for a local element. Usually set to 1 or * (unbounded) Detail tab: Maximum |