11 XQuery Transformations

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:

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

To add 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 Section 3.1, "Using the Change Center."
Select Project Explorer to display the Section 4.2, "Projects View Page." or Section 4.3, "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.

Follow the Section 2.3, "Resource Naming Restrictions" for naming guidance.
In the Resource Description field, enter a description for the XQuery transformation.
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.
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.

To edit 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 Section 3.1, "Using the Change Center."
Locate the XQuery transformation, as described in Section 11.1, "Locating XQuery Transformations."

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.

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

To delete 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 Section 3.1, "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.