XSL Transformations

Transformation maps describe the mapping between two data types. eXtensible Stylesheet Language Transformation (XSLT) maps describe XML-to-XML mappings.

Locating XSL 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 XSL transformation.
Select Resource Browser > XSLTs. The Summary of XSLTs page displays the information shown in Table 12-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 XSLT resides.

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

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

Table 12-1 XSL Transformation Details
Property	Description
XSLT Name	The name assigned to the XSL transformation. Click the name to display the View XSL Transformation Details page. See Editing XSL Transformations.
Path	The path is the project name and the name of the folder in which the XSL transformation resides, for example, `MyProject/MyFolder/MyResource`. Click the path of an XSLT 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 XSL 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 XSLT. 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 XSL Transformation.

Adding an XSL 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 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 XSL transformation.
From the Create Resource list, select XSLT to display the Create a New XSLT page.
In the Resource Name field, enter a unique name for this XSL transformation.
In the Resource Description field, enter a description for the XSL transformation.
In the XSLT field, do one of the following:

Enter text for the new XSL transformation.
Click Browse to locate and import an existing XSL transformation.
Copy and paste text from an existing XSL 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, click Activate under Change Center.

Editing XSL 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 XSL transformation, as described in Locating XSL Transformations.
Click the XSL transformation name. The View XSL Transformation Details page displays the structural view of the XSLT by default, which includes the information shown in Table 12-2.

Table 12-2 XSL Transformation Resource Details
Property	Description
Last Modified By	The user who created this XSL transformation or imported it into the configuration.
Last Modified On	The date and time that the user created this XSL 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 XSL 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 XSL transformation. If such references exist, click the numeric link to view a list of the objects. For example, if you assigned this XSL 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 XSL transformation.
Target Namespace	The namespace used to qualify any of the definitions included in the XSL transformation.
XSLT Dependencies	The attributes and groups associated with the XSLT: The XSLT location
State	The status of the XSL transformation: Valid All of the XSL transformation locations included by the current XSL transformation are specified and are valid. Furthermore, all of the locations for nested XSL transformations (XSL transformations subsequently included by the included XSL transformations) are specified and are valid. Invalid One or more of the locations for XSL transformations included by the current XSL transformation is not specified or is not valid. Additionally, one or more of the nested XSL transformations (XSL transformations subsequently included by the included XSL transformations) may not be specified or may not be valid.To resolve an invalid XSL transformation, click Edit References.To learn more, see Resolving Unresolved XSL Transformation References.

Click Text view to display a text view of the XSL transformation details. The text view includes the information shown in Table 12-3.

Table 12-3 XSL Transformation Text Details
Property	Description
Target Namespace	The namespace used to qualify any of the dependencies included in the XSL transformation.
XSLT	The full text of the XSL transformation.

To make a change to the fields, click Edit. See Adding an XSL Transformation for a description of the fields.

You cannot change the Resource Name field.

Click Save to commit the updates in the current session.

Deleting an XSL 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 > XSLTs to display the Summary of XSLTs page.
Click the Delete icon in the row of the XSL transformation you want to delete. The XSL 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.

Resolving Unresolved XSL Transformation References

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 > XSLTs to display the Summary of XSLTs page.
In the XSLT Name column, click the appropriate XSLT name to view details of the unresolved reference. The View XSL Transformation Details page is displayed.
Click Edit References to display the Edit the References of an XSL Transformation Resource page.
In the Resource Type field, select XSLT.
Click Browse. The XSLT Browser is displayed.
In the XSLT Browser, select an XSLT, then select a dependency from the Dependencies pane.
Click Submit. The XSLT you selected is displayed in the Resource Name field.
Click Save. The View XSLT Details page is displayed.
Click OK. The state of the XSL transformation is displayed as Valid.
To end the session and deploy the configuration to the run time, click Activate under Change Center.