Transformation Scenarios View

You can manage the transformation scenarios by using the Transformation Scenarios view. To open this view, go to Window > Show View > Transformation Scenarios.

Figure: The Scenarios view

The following options are available in the contextual menu of the Transformation Scenarios view:

Apply selected scenarios

Select this option to run the current transformation scenario.

Debug selected scenario

Select this option to switch to the Debugger perspective and initialize it with the parameters from the scenario (the XML, XSLT, or XQuery input, the transformation engine, the XSLT parameters).

Duplicate

Adds a new scenario to the list that is a duplicate of the current scenario. It is useful for creating a scenario that is similar to an existing one.

Edit

Opens the dialog box for editing the parameters of a transformation scenario.

Remove

Removes the current scenario from the list. This action is also available by using the Delete key.

Change storage

Use this option to change the storage location of the selected scenario. You are also able to keep the original storage location and make a copy of the selected scenario in the target storage location.

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 Editor ignores 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 Editor adds imported to the name of the imported scenario.

Export selected scenarios

Use this option to export transformation and validation scenarios individually. Oxygen XML Editor creates a scenarios file that contains the scenarios that you export.

Along with the options available in the contextual menu, the Transformation Scenarios view toolbar contains a New drop-down button that contains a list of the scenarios you can create. Oxygen XML Editor determines the most appropriate scenarios for the current type of file and displays them at the beginning of the list, followed by the rest of the scenarios.

The Settings drop-down menu allows you to configure the following options:

• 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 Editor 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.
• Change storage - Use this option to change the storage location of the selected 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.
• 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 Editor ignores 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 Editor adds imported to the name of the imported scenario.
• Export selected scenarios - Use this option to export transformation and validation scenarios individually. Oxygen XML Editor creates a scenarios file that contains the scenarios that you export.
• 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.

Oxygen XML Editor supports multiple scenarios association. To associate multiple scenarios with a document, enable the check-boxes in front of each scenario. You can also associate multiple scenarios with a document from the Configure Transformation Scenario(s) or Configure Validation Scenario(s) dialog boxes.