• Chapter 1: Getting Started with Stylus Studio
• Chapter 2: Editing and Querying XML
• Chapter 3: Converting Non-XML Files to XML
• Chapter 4: Working with XSLT
• Chapter 5: Creating XSLT Using the XSLT Mapper
  • Overview of the XSLT Mapper
  • Source Documents
  • Target Structures
  • Mapping Source and Target Document Nodes
  • Working with XSLT Instructions in XSLT Mapper
  • Processing Source Nodes
  • Creating and Working with Templates
  • Creating an XSLT Scenario
    • Overview of Scenario Features
    • How to Create a Scenario
    • How to Run a Scenario
    • How to Clone a Scenario
• Chapter 6: Debugging Stylesheets
• Chapter 7: Defining XML Schemas
• Chapter 8: Defining Document Type Definitions
• Chapter 9: Writing XPath Expressions
• Chapter 10: Working with XQuery in Stylus Studio
• Chapter 11: Composing Web Service Calls
• Chapter 12: Accessing Relational Data as XML
• Chapter 13: Extending Stylus Studio
• Chapter 14: Stylus Studio GUI Reference

Home > Online Product Documentation > Table of Contents > Creating an XSLT Scenario

Creating an XSLT Scenario

An XSLT scenario is a group of settings that Stylus Studio uses to process the XSLT when you click the Preview Result button ( ). Examples of scenario settings include the XML document to which the XSLT will be applied, whether you want to perform any post-processing, and the values of any parameters you might have defined. You can create multiple scenarios that use the same XSLT, and choose different settings for each. This flexibility can aid the XSLT development process as it enables you to easily test different applications of the XSLT before you put it online.

Even if you do not explicitly create a scenario, Stylus Studio uses default scenario settings in order to preview the XSLT. For example, Stylus Studio uses the first source document you specify as the document to which the XSLT is applied. (If the first source document is an XSD or DTD, Stylus Studio prompts you to provide an XML document for the scenario when you preview the XSLT.)

This section covers the following topics:

Overview of Scenario Features

This section describes the main features of XSLT scenarios. It covers the following topics:

Specifying XML Source Documents

The main benefit of the XSLT scenario feature is that it lets you specify the XML document against which you want to run your XSLT. By default, Stylus Studio uses the first source document you add using the XSLT mapper as the XML source document for the scenario. You can specify the XML source document setting on the General tab of the Scenario Properties dialog box.

Figure 237. General Tab of XSLT Scenario Properties Dialog Box

For more information

See Source Documents to learn more about the process of selecting and working with source documents in XSLT mapper.

Setting Values for Global Parameters

The Parameter Values tab of the Scenario Properties dialog box displays any global parameters you have defined in the XSLT source and allows you to

For example, imagine the following parameter defined in the XSLT source:

<xsl:param name="my_title" select="'Confederacy of Dunces'"/>
               

            

This parameter is displayed on the Parameter Values tab as follows:

Figure 238. Specifying Alternate Values for XSLT Parameters

If you want to specify an alternate parameter value for this scenario, click the Parameter value to be used when processing entry field. If the alternate value you enter is an XPath expression, click the associated check box.

Choosing an XSLT Processor

By default, Stylus Studio uses a built-in processor to process the XSLT you compose. You can select other supported processors on the Processor tab, or use this tab to specify an external or custom processor.

Performance Metrics Reporting

Performance metrics reporting is available only in Stylus Studio XML Professional Edition.

Stylus Studio can generate an HTML report that contains information about how your XSLT is being processed. This option is off by default, but you can enable it, and choose options for the report, on the Profiling Options tab.

See Profiling XSLT Stylesheets to learn more about the different ways in which Stylus Studio can provide you with XSLT performance metrics.

Performing Post-Processing

You can use the Post-process tab to specify any optional processing you want performed on the XML after it has been processed by the XSLT.

How to Create a Scenario

To create a scenario:

1. In the XSLT editor toolbar, click .

Alternative: Select Create Scenario from the scenario drop-down list at the top of the editor window.

Stylus Studio displays the Scenario Properties dialog box.

3. In the Source XML URL (optional): field, type the name of the XML file to which you want to apply the XSLT, or click Browse to navigate to an XML file and select it.

If you start to create a scenario and then change your mind, click Delete and then OK.

How to Run a Scenario

To run a scenario:

Alternative:

a. In the XSLT editor toolbar, click .

Stylus Studio displays the Scenario Properties dialog box.

2. Click the Preview Result button ( ).

How to Clone a Scenario

When you clone a scenario, Stylus Studio creates a copy of the scenario except for the scenario name. This allows you to make changes to one scenario and then run both to compare the results.

To clone a scenario:

2. In the XSLT editor toolbar, click to display the Scenario Properties dialog box.

If you change your mind and do not want to create the clone, click Delete and then OK.