Transforming and Converting Schema Constructs

This document covers the following topics:


General Information

The Tamino Schema Editor allows you to perform transformations that facilitate the schema design process. See Making a Schema Construct Local or Global and Converting a Choice, Sequence or All

Using a Transformation Wizard

You can transform a schema construct into another schema construct, using items from the menu bar or using items from context menus.

The Transformation command in the Tools menu offers several transformation commands in a cascading menu. The available transformation commands depend on the current selection in the schema tree and on the current view.

When you select a transformation command, a wizard appears providing different dialogs. The number of dialogs and the amount of information in these dialogs depends on the elements that have been defined for the selected schema construct.

Start of instruction setTo use a transformation wizard

  1. In the schema tree, select the schema construct that is to be transformed.

  2. From the Tools menu, choose Transformation > transformation-command.

    Descriptions of the transformation commands are provided later in this section.

    A wizard appears, providing different dialogs.

    Read the information in each dialog carefully. The wizard informs you about all items that will be lost or that will not be adopted. Some dialogs require that you select one or more options (for example, whether you want to copy the documentation/appinfo of a reference), or that you enter additional information (for example, when an element with the same name exists already or when you have to decide on a new parent for an annotation).

  3. Use the Next button to proceed to the next dialog.

    Or:
    If no further dialogs are available, choose the Finish button to execute the transformation.

Note:
You can undo each transformation immediately. See Undoing and Redoing the Previous Action.

Making a Schema Construct Local or Global

The following transformation commands are provided in the Tools > Transformation menu:

Make Local

Replaces the selected reference with its declaration.

Extract Global Type

Moves the selected element or attribute to the top level of the schema. A reference is created at the selected position.

If an element with the same name exists already at the top level of the schema, you have to enter a new name for the element that is to be moved to the top level.

If the selected element has an annotation, you have to specify the new parent of the annotation. This can either be a new global element (i.e. a declaration) or a new local element (i.e. a reference). It is also possible not to specify a new parent; in this case, the information will be lost.

Converting a Choice, Sequence or All

The following transformation commands are provided in the Tools > Transformation > Convert To menu:

All

Converts the selected Choice or Sequence to All. Information may be lost. Therefore, a wizard is used.

Choice

Converts the selected Sequence or All to a Choice. This is a simple conversion. Information is not lost and therefore a wizard is not used.

Sequence

Converts the selected Choice or All to a Sequence. This is a simple conversion. Information is not lost and therefore a wizard is not used.

Converting an Element

The following transformation commands are provided in the Tools > Transformation > Convert To menu:

Attribute

Converts the selected element, that currently has no attributes, into an attribute.

Element with Attribute

Converts the selected element, that currently has no attributes, into an element with an attribute.