Configure transformations
You can use the Configure Transformation Scenarios(s) dialog box for editing exiting transformation scenarios or creating new ones.
To open this
dialog box, use the Configure Transformation Scenario(s) (Ctrl + Shift +
C (Command + Shift + C on OS X)) action from the toolbar or the Document >
Transformation menu.
Figure: Configure Transformation Scenario(s) Dialog Box


- Show all scenarios
- Select this option to display all the available scenarios, regardless of the document they are associated with.
- Show only the scenarios available for the editor
- Select this option to only display the scenarios that Oxygen XML Author can apply for the current document type.
- Show associated scenarios
- Select this option to only display the scenarios associated with the document you are editing.
Import scenarios
- This option opens the Import scenarios dialog box that allows you to
select the scenarios file that contains the scenarios you want to
import. If one of the scenarios you import is identical to an existing
scenario, Oxygen XML Authorignores it. If a conflict appears (an
imported scenario has the same name as an existing one), you can choose
between two options:
- Keep or replace the existing scenario.
- Keep both scenarios.Note: When you keep both scenarios, Oxygen XML Author adds imported to the name of the imported scenario.
Export selected scenarios
- Use this option to export selected scenarios individually. Oxygen XML Author creates a scenarios file that contains the scenarios that you export. This is useful if you want to share scenarios with others or export them to another computer.
- Association - The check-boxes in this column mark whether or not a transformation scenario is associated with the current document.
- Scenario - This column presents the names of the transformation scenarios.
- Type - Displays the type of the transformation scenario. For further details about the types of transformation scenarios that are available in Oxygen XML Author, see the Transformation Types section.
- Storage - Displays where a transformation scenario is stored (the Show Storage option must be enabled.)
- Show Type
- Use this option to display the transformation type of each scenario.
- Show Storage
- Use this option to display the storage location of the scenarios.
- Group by Association
- Select this option to group the scenarios depending on whether or not they are associated with the current document.
- Group by Type
- Select this option to group the scenarios by their type.
- Group by Storage
- Select this option to group the scenarios by their storage location.
Ungroup all
- Select this option to ungroup all the scenarios.
- Reset Layout
- Select this option to restore the default settings of the layout.
- Association follows selection
- Enable this checkbox to automatically associate selected transformation scenarios with the current document. This option can also be used for multiple selections.Note: When this option is enabled, the Association column is hidden.
- New
- This button allows you to create a new transformation scenario.
- Edit
- This button opens the Edit Scenario dialog box that allows you to configure the options of the transformations scenario. For information about all the specific options in the various tabs, see the Transformation Types section.Note: If you try to edit a transformation scenario associated with a defined document type, Oxygen XML Authordisplays a warning message to inform you that this is not possible and gives you the option to create a duplicate transformation scenario to edit instead.
- Duplicate
- Use this button to create a duplicate transformation scenario.
- Remove
- Use this button to remove transformation scenarios.Note: Removing scenarios associated with a defined document type is not allowed.
The Edit, Duplicate, and Remove actions are also available in the contextual
menu of the transformation scenarios listed in the middle section of the dialog
box (along with Import scenarios and
Export selected scenarios).
This contextual menu also contains a Change storage action that allows you to change the storage location of a transformation scenario to Global Options or Project Options. You are also able to keep the original storage location and make a copy of the selected scenario in the new storage location.