Managing XQuery Results

The following topics are covered below.


Specifying the Result Fetch Options

The result of a query is shown as different packs in the Result pane. You can specify the number of instances that are to be shown with each pack.

The default values are defined in the Options dialog box. See Setting the Tamino XQuery Tool Options for further information.

Start of instruction setTo specify the result fetch options

  1. From the Result menu, choose Result Fetch Options.

    Or:
    Choose the following toolbar button:

    Result fetch options

    The Specify Instance Fetch Options for Result dialog box appears.

    Result fetch options

  2. Specify the following information:

    Number of instances per pack

    The number of instances or fragments that are to be fetched with each pack.

    Maximum number of kept instances

    The maximum number of instances or fragments that can be shown at the same time.

  3. Optionally: if you want to reset the values that are currently defined in the dialog box to the default values, choose the Reset to Default button.

  4. Choose the OK button to use the new values.

Browsing the Result Packs

When more instances or fragments are available than can be shown on the Result pane, you can browse through the result packs.

You can display the next or previous pack. Or you can immediately jump to the last pack or to the first pack.

The browse commands (see below) that are currently not available are disabled. For example, when the entire result is provided in one pack on the Result pane, all browse commands (and the corresponding toolbar buttons) are disabled.

Start of instruction setTo go to the first result pack

  • From the Result menu, choose First.

    Or:
    Choose the following toolbar button:

    First

Start of instruction setTo go to the last result pack

  • From the Result menu, choose Last.

    Or:
    Choose the following toolbar button:

    Last

Start of instruction setTo go to the previous result pack

  • From the Result menu, choose Previous.

    Or:
    Choose the following toolbar button:

    Previous

    Or:
    When the navigation tree is shown, click the plus sign next to the up-arrow at the top of the list. When using the keyboard, select the up-arrow and press ENTER.

Start of instruction setTo go to the next result pack

  • From the Result menu, choose Next.

    Or:
    Choose the following toolbar button:

    Next

    Or:
    When the navigation tree is shown, click the plus sign next to the down-arrow at the bottom of the list. When using the keyboard, select the down-arrow and press ENTER.

Saving the Current Result Pack

You can save the result pack that is currently shown in the navigation tree of the Result pane to your file system.

Start of instruction setTo save the current result pack

  1. From the Result menu, choose Save Displayed Result As.

    The Save As dialog box appears. File name and extension are automatically provided.

  2. Optionally: specify another file name and extension.

  3. Select the path in which you want to save the file.

  4. Choose the Save button.

Saving an Instance or Fragment

You can save the item that is currently selected in the navigation tree of the Result pane to your file system.

Start of instruction setTo save an instance or fragment

  1. In the navigation tree of the Result pane, select the item to be saved.

  2. From the Result menu, choose Save Selected Item As.

    The Save As dialog box appears. File name and extension are automatically provided.

  3. Optionally: specify another file name and extension.

  4. Select the path in which you want to save the instance or fragment.

  5. Choose the Save button.