Target Structures

There are two ways to specify an XSLT target structure:

You can select an existing document from which Stylus Studio infers a structure and, optionally, modify the structure. Existing nodes in a target structure are displayed in blue. Nodes that you add are displayed in red.

You can build a structure from scratch, starting with the root element and defining other elements and attributes as needed. Nodes for target structures you define are displayed in red.

This section covers the following topics:

Using an Existing Document

Building a Target Structure

Modifying the Target Structure

Using an Existing Document

To use an existing document to provide the XSLT target structure:

1. Click the Mapper tab if necessary.

2. Click the Set Target Document button at the top left of the Mapper tab.

The Open dialog box appears.

3. Select the document you want to use to provide the target structure for defining the mapping (XML, XSD, or DTD).

4. Click Open.

The structure of the document you select appears in the target document pane of the Mapper tab.

Building a Target Structure

To build a target structure from scratch, you first create a root element, and then define child elements and attributes as needed.

How to create a root element

To create a root element:

1. Click the Mapper tab if necessary.

2. Right click the area underneath the Set Target Document button.

The target document shortcut menu appears.

3. Select Create Root Element.

The Name dialog box appears.

Figure 219. Name Dialog Box

4. Type a name for the root element and click OK.

The root element you specified appears in the target document pane of the Mapper tab.

How to create elements and attributes

You can create elements and attributes in a new or existing target structure.

To create elements and attributes:

1. Click the Mapper tab if necessary.

2. Select the attribute or element to which you want to add a child element or attribute. If you have just created a root element, select the root element.

3. Right click the area underneath the Set Target Document button.

The target document shortcut menu appears.

4. Choose one of the following:

Add Attribute

Add Child Element

Insert Element After (This choice is not applicable to the root element; it creates the element as a sibling of the selected element.)

The Name dialog box appears.

Figure 220. Name Dialog Box

5. Type a name for the node and click OK.

The node you specified is added to the target structure in the Mapper tab.

Modifying the Target Structure

This section describes the techniques you can use to modify the structure and content of an XSLT mapper target structure. It covers the following topics:

Adding a Node

Removing a Node