XQuery Transformations

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

Locating XQuery Transformations

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 10-1.

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 10-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 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 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 Testing Transformations.
Options	If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See 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 Deleting an XQuery Transformation.

Adding XQuery Transformations

If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Project Explorer to display the Projects View page or Project/Folder View page.
Navigate to the project or a folder to which you want to add the XQuery transformation.
From the Create Resource list, select XQuery. The Create a New XQuery page is displayed.
In the Resource Name field, enter a unique name for this XQuery transformation.
In the Resource Description field, enter a description for the XQuery transformation.
In the XQuery field, do one of the following:

Click Save to commit the updates in the current session.
To end the session and deploy the configuration to the run time, select Activate under Change Center.

Editing XQuery Transformations

If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Locate the XQuery transformation, as described in Locating XQuery Transformations.
Click the XQuery transformation name. The View XQuery Transformation Details page displays the information shown in Table 10-2.

Table 10-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 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 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 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.

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

You cannot change the Resource Name field.

Click Save to commit the updates in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.

Deleting an XQuery Transformation

If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Resource Browser > XQueries. The Summary of XQueries page is displayed.
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.
To end the session and deploy the configuration to the run time, click Activate under Change Center.

Using the AquaLogic Service Bus Console