15 XSL Transformations

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

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

15.1 Locating XSL Transformations

To locate XSL 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 XSL transformation.

    • Select Resource Browser > XSLTs. The Summary of XSLTs page displays the information shown in Table 15-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 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 15-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 Section 15.3, "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 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 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 Section 15.4, "Deleting an XSL Transformation."

15.2 Adding an XSL Transformation

To add an XSL 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 Projects View page or Project/Folder View page.

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

  4. From the Create Resource list, select XSLT to display the Create a New XSLT page.

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

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

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

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

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

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

15.3 Editing XSL Transformations

To edit an XSL 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 XSL transformation, as described in Section 15.1, "Locating XSL Transformations."

  3. 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 15-2.

    Table 15-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 Section 4.23, "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 Section 4.22, "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 Section 4.22, "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 Section 15.5, "Resolving Unresolved XSL Transformation References."

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

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

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

    You cannot change the Resource Name field.

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

15.4 Deleting an XSL Transformation

To delete an XSL 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 > XSLTs to display the Summary of XSLTs page.

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

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

15.5 Resolving Unresolved XSL Transformation References

To resolve XSL Transformation references:

  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 > XSLTs to display the Summary of XSLTs page.

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

  4. Click Edit References to display the Edit the References of an XSL Transformation Resource page.

  5. In the Resource Type field, select XSLT.

  6. Click Browse. The XSLT Browser is displayed.

  7. In the XSLT Browser, select an XSLT, then select a dependency from the Dependencies pane.

  8. Click Submit. The XSLT you selected is displayed in the Resource Name field.

  9. Click Save. The View XSLT Details page is displayed.

  10. Click OK. The state of the XSL transformation is displayed as Valid.

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