<%@ page language="C#" masterpagefile="~/templates/Documentation.master" inherits="Page" pagetitle="Specifying a Target Structure" keywords="Specifying a Target Structure"%>

Specifying a Target Structure

There are two ways to specify an XQuery 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. If a node is required by the associated XML Schema or DTD, a red check appears over the node symbol.

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

See Modifying the Target Structure to learn about the types of changes you can make to a target structure.

Using an Existing Document

To use an existing document to provide the XQuery 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 XQuery.

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 329. 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.


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

How to create elements and attributes

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 330. 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.

< Previous| Next >