Skip Headers
Oracle® Fusion Middleware Administrator's Guide for Oracle Service Bus
11g Release 1 (11.1.1.6.3)

Part Number E15867-08
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

11 XQuery Transformations

This chapter describes how to create, locate, edit, and delete XQuery Transformation resources using the Oracle Service Bus Administration Console.

XQuery transformation maps can describe XML-to-XML, XML to non-XML, and non-XML to XML mappings.

11.1 Locating XQuery Transformations

To locate XQuery Transformations:

  1. Do either of the following:

    • Select Project Explorer to display the Projects View Page or the Project/Folder View page. Then navigate through projects and folders to find the XQuery.

    • Select Resource Browser > XQueries. The Summary of XQueries page displays the information shown in Table 11-1.

  2. To restrict the number of items in the list, you can filter by name, path, or both. In the Name and Path fields, under Search, enter the name and/or path of the target(s), then click the Search button.

    The path is the project name and the name of the folder in which the XQuery resides.

    Wildcard characters * and ? are allowed. Search is case-sensitive.

    Click View All to display all XQueries in the domain. This clears the search parameters from the previous search.

Table 11-1 XQuery Transformation Details

Property Description

XQuery Name

The name assigned to the XQuery transformation. Click the name to display the View XQuery Transformation Details page.

See Section 11.3, "Editing XQuery Transformations."

Path

The path is the project name and the name of the folder in which the XQuery resides, for example, MyProject/MyFolder/MyResource.

Click the path of an XQuery to display the Section 4.3, "Project/Folder View Page." that contains it.

Actions

Click the Launch Test Console icon to invoke the Test Console, which you use to validate and test the design of your services and transformations. For XQuery transformations, you can use the Test Console whether you are inside or outside a session. To learn more, see Section 4.2, "Projects View Page."

Options

If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "Using the Change Center."

Click the Delete icon to delete the XQuery. A Deletion Warning icon is displayed when other resources reference this resource. You can delete the resource with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource. For more information, see Section 11.4, "Deleting an XQuery Transformation."


11.2 Adding XQuery Transformations

To add an XQuery Transformation:

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "Using the Change Center."

  2. Select Project Explorer to display the Section 4.2, "Projects View Page." or Section 4.3, "Project/Folder View Page."

  3. Navigate to the project or a folder to which you want to add the XQuery transformation.

  4. From the Create Resource list, select XQuery. The Create a New XQuery page is displayed.

  5. In the Resource Name field, enter a unique name for this XQuery transformation.

    Follow the Section 2.3, "Resource Naming Restrictions" for naming guidance.

  6. In the Resource Description field, enter a description for the XQuery transformation.

  7. In the XQuery field, do one of the following:

    • Enter text for the new XQuery transformation.

    • Click Browse to locate and import an existing XQuery transformation.

    • Copy and paste text from an existing XQuery transformation into this field.

  8. Click Save to commit the updates in the current session.

  9. To end the session and deploy the configuration to the run time, select Activate under Change Center.

11.3 Editing XQuery Transformations

To edit an XQuery Transformation:

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "Using the Change Center."

  2. Locate the XQuery transformation, as described in Section 11.1, "Locating XQuery Transformations."

  3. Click the XQuery transformation name. The View XQuery Transformation Details page displays the information shown in Table 11-2.

    Table 11-2 XQuery Transformation Resource Details

    Property Description

    Last Modified By

    The user who created this XQuery transformation or imported it into the configuration.

    Last Modified On

    The date and time that the user created this XQuery transformation or imported it into the configuration. Click the date and time link to view the change history of this resource. See Section 4.23, "View Change History Page."

    References

    The number of objects that this XQuery transformation references. If such references exist, click the numeric link to view a list of the objects. To learn more, see Section 4.22, "Viewing References to Resources."

    Referenced by

    The number of objects that reference this XQuery transformation. If such references exist, click the numeric link to view a list of the objects. For example, if you assigned this XQuery transformation to a variable in the Message Flow of a specific proxy service, the proxy service is listed as a reference when you click the link.To learn more, see Section 4.22, "Viewing References to Resources."

    Description

    A description of this XQuery transformation, if one exists.

    XQuery

    The full text of the XQuery transformation.

    XQuery Variables

    The XQuery variables selected for this XQuery transformation.


  4. To make a change to the fields, click Edit. See Section 11.2, "Adding XQuery Transformations" for a description of the fields.

    You cannot change the Resource Name field.

  5. Click Save to commit the updates in the current session.

  6. To end the session and deploy the configuration to the run time, click Activate under Change Center.

11.4 Deleting an XQuery Transformation

To delete an XQuery Transformation:

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "Using the Change Center."

  2. Select Resource Browser > XQueries. The Summary of XQueries page is displayed.

  3. Click the Delete icon in the row of the XQuery transformation you want to delete. The XQuery transformation is deleted in the current session. A Deletion Warning icon is displayed when other resources reference this resource. You can delete the resource with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource.

  4. To end the session and deploy the configuration to the run time, click Activate under Change Center.