Element Properties

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:
  • all – All children may be present.

  • choice – Only one child must be present.

  • group – Reference to a predefined group (see Groups (XSM))

  • sequence – All children must be present in order.

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.

Detail Tab

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.

Note: In the case of a model targeted with XDR, the Detail tab is only available for local elements.

Mapping Tab

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:

Tool

Description

Add Mapping - Selects the attributes in the current element that will be mapped to PDM columns or OOM class attributes. Once you have selected the attributes, you can use the list in the Mapped to column to select corresponding PDM columns or OOM class attributes.

Create from Sources - Copies PDM columns or OOM class attributes in the data source to the current element attributes.

Generate Mapping - Automatically generates a mapping between PDM columns or OOM class attributes and element attributes with the same name or code in the data source and the current model.

For more information on complex type mapping, see Core Features Guide > Linking and Synchronizing Models > Object Mappings.

The following tabs are also available:

XDR Element Properties

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:
  • closed – [default]

  • open - if an "Any" element is attached to the element. See Any Elements (XSM)

Content

Specifies the content type. Possible values are:
  • mixed - a group particle and a data type are defined

  • eltOnly - a group particle is defined without a data type

  • textOnly - a data type is defined without a group particle

  • empty – neither group particle nor data type are defined

General tab: Group type/Type

Order

Specifies how child elements are organized within a parent element. Possible values are:
  • seq - sequence group particle

  • one - choice group particle

  • many - all group particle

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