This section includes the following topics:
Transformation maps describe the mapping between two data types. AquaLogic Service Bus supports data mapping using either XQuery or the eXtensible Stylesheet Language Transformation (XSLT) standard. XSLT maps describe XML-to-XML mappings, whereas XQuery maps can describe XML-to-XML, XML to non-XML, and non-XML to XML mappings.
XQuery transformation is the primary XML transformation tool provided in BEA AquaLogic Service Bus. BEA provides the BEA XQuery Mapper tool to help you create XQuery transformations (.xq
files). The XQuery Mapper is a plug-in within the Eclipse development environment. Therefore, to use the XQuery Mapper, Eclipse must be installed and launched.
Eclipse and the XQuery Mapper are provided as part of the AquaLogic Platform installation. However, when using the XQuery Mapper with AquaLogic Service Bus, the XQuery Mapper must be invoked separately. To learn more, see "Launching the XQuery Mapper" in Transforming Data Using XQuery in Transforming Data Using the XQuery Mapper.
You can use XQuery transformations when you edit XQuery expressions in the Message Flow of proxy services. You can select the XQ transformation option to execute a specific XQuery transformation when you edit an XQuery expression on the XQuery Expression Editor page.
In the Message Flow of proxy services, you can assign XQuery expressions to message context variables, assign if then else actions based on the Boolean result of an XQuery expression, insert the result of an XQuery expression at an identified place relative to an XPath expression, specify the message context that you want to log through XQuery expressions on context variables, and so on. To learn more, see Overview of Message Flow, Adding an Action, and Using the Inline XQuery Expression Editor.
The following table lists the XQuery transformation pages you can access from the Resource Browser and Project Explorer modules. The tasks and help topics associated with each are provided.
The Summary of XQueries page allows you to view a list of XQuery transformations. XQuery transformations describe the mappings between two data types. To learn more, see Overview of XQuery Transformations.
The name assigned to the XQuery transformation. The name is a link to the XQuery Transformation Details page. To learn more, see Viewing and Changing XQuery Transformation Details.
|
|
The path is the project name and the name of the folder in which the XQuery transformation resides. It is a link to the project or folder that contains this resource. To learn more, see Viewing Project Details or Viewing Folder Details.
|
|
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 Testing Transformations.
|
|
Click the Delete icon to delete a specific XQuery transformation. To learn more, see Deleting an XQuery Transformation.
|
Note: | Click View All to display all XQuery transformations. |
Adding an XQuery Transformation
The Create a New XQuery page allows you to add a new XQuery transformation. XQuery transformations describe the mapping between two data types. To learn more, see Overview of XQuery Transformations.
To add a new XQuery transformation, do one of the following:
Note: | XQuery transformation is the primary XML transformation tool provided in BEA AquaLogic Service Bus. BEA provides the BEA XQuery Mapper tool to help you create XQuery transformations (.xq files). The XQuery Mapper is a plug-in within the Eclipse development environment. Therefore, to use the XQuery Mapper, Eclipse must be installed and launched. Eclipse and the XQuery Mapper are provided as part of the AquaLogic Platform installation. However, when using the XQuery Mapper with AquaLogic Service Bus, the XQuery Mapper must be invoked separately. To learn more, see "Launching the XQuery Mapper" in
Transforming Data Using XQuery in Transforming Data Using the XQuery Mapper. |
Note: | Click the name of a folder to select it. The Folder View page is displayed. |
Note: | The new XQuery transformation is saved in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session. |
Listing and Locating XQuery Transformations
Viewing and Changing XQuery Transformation Details
Deleting an XQuery Transformation
The XQuery Transformation Details page allows you to view and change details of an XQuery transformation. XQuery transformations describe the mapping between two data types. To learn more, see Overview of XQuery Transformations.
The number of objects that this XQuery transformation references. If such references exist, click the link to view a list of the objects. To learn more, see Viewing References.
|
|
The number of objects that reference this XQuery transformation. If such references exist, click the 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 Viewing References.
|
|
Note: | You cannot change the Resource Name field. |
Note: | The updated XQuery transformation is saved in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session. |
Deleting an XQuery Transformation
The Summary of XQueries page allows you to delete XQuery transformations. XQuery transformations describe the mapping between two data types. To learn more, see Overview of XQuery Transformations.
Note: | You cannot delete a resource if it is referenced by other resources in AquaLogic Service Bus. Instead of the Delete icon, a Delete icon with a red X is displayed for these resources. |
The XQuery transformation is removed from the list.
Note: | If necessary, you can undo the deletion of this resource. To learn more, see Undoing a Task. |
The XQuery transformation is deleted in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.
Listing and Locating XQuery Transformations
Adding an XQuery Transformation
Viewing and Changing XQuery Transformation Details