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 to reuse. 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.

Disables all other properties. To locate the referenced element in the diagram, right-click the referencing element and select Find Referenced Element.

Group type

Specifies that the object has child elements, and how they are used (see Group Particles (XSM)). You can choose between:
  • all – Each child element can occur 0 or 1 times.

  • 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 / IDREF 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. If you select IDREF or IDREFS, the IDREF type property is displayed, allowing you to select the element to reference for documentation purposes.

For an XSD element, selecting a data type will delete any group particle or attribute previously defined. 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 the type of content of the object. You can select:
  • Complex – elements or elements and character data. Click the Properties tool to specify an ID (unique within the model) for the complex content, and select the Mixed check box if character data can appear between child elements.
  • Simple – character data or a simple type (but no elements). Click the Properties tool to specify an ID for the simple content.

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

Persistent Specifies how the element will be generated to a PDM. You can choose between:
  • Generate table - the element will be generated as a table (with a reference to its parent, if appropriate).
  • Migrate columns - the attributes and child elements of the element will be migrated to its parent element.

Minimum

Specifies the minimum number of times the object can occur. Enter zero to specify that it is optional.

Maximum

Specifies the maximum number of times the object can occur. Select unbounded to specify unlimited instances.

Substitution group

Species a global element for which the current element can be substituted. The substitute must have the the same type or derived type.

Default

Specifies a default value for the object. Mutually exclusive with Fixed.

Fixed

Specifies a fixed value for the object. Mutually exclusive with Default.

Block

Specifies that another object with the same type of derivation cannot be used in place of the current one.

Final

[global elements] Prevents derivation of the object.

Form

Specifies whether or not the object name must be qualified by the target namespace of the schema.

ID

Specifies the ID of the object, which must be unique within the model.

Abstract

Specifies that the object cannot be used 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.
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