Use an XSLT to transform one component

If you have the same data that can be used in different formats, you can quickly change a component's structure. An XSLT can be imported into your Inspire instance so that you can use the Transform Component option to quickly change the XML code in a component.

In Inspire, the XSLT transformation only updates the XML code in an existing XML component. If you want to transform XML into another format, such as HTML or PDF, you must publish it and select the appropriate publish configuration. Publish your content.

Tips and tricks

  • An eXtensible Stylesheet Language Transformations (XSLT) file is written in an XML-based language.
    • You can create an XSLT or contact your Vasont customer specialist to have one created for you.
    • The XSLT file is stored as a binary file in Inspire.
    • To learn more about the XSLT file, read Understand XSLT transformations.
  • You do not need special permissions to use the Transform Component... option.

    Important notes:

    • You cannot transform multiple components at once.
    • The Transform Component option is not available in projects.
  • The original component that is being transformed is changed.
    • No new component is created.
    • If you want to see the original XML, you must restore the transformed component.
    • If the XSLT processing fails, the original component is NOT changed.
  • Multiple XSLTs can be uploaded. In this case:
    • If you need to, you can select one or more XSLTs to transform a component.
    • You can also select the order in which they should be applied.

To use an XSLT to transform one component:

  1. Click Components_TopMenuOpt Components.
  2. In Folders pane, navigate to the folder where you've saved the component.
  3. In the Components pane, locate the component you want to transform.
  4. In the list, to select the row, click it.
  5. Right-click the component, select Advanced, and then select Transform Component...
    You can also access this menu by clicking Options, selecting Advanced, and then selecting Transform Component...

  6. On the Transform Component screen:
    1. Click Add.
    2. On the Select Components screen, use the Folders and Components panes to find the binary XSLT file. (Only binary files are shown.)
    3. On the Select Components screen, select the checkbox for the XSLT file you want to use.
    4. Optionally, repeat steps a-c to add other XSLT files.
    5. Optionally, if you have multiple files listed, you can re-order them.

      Inspire processes each XSLT in the order they are listed on this screen. If one fails to process, Inspire moves to the next XSLT listed.

      • Select the file you want to move up or down so it's highlighted in yellow.
      • If the file isn't listed first, you can use the up arrow to move it to a higher position.
      • If the file isn't listed last, you can use the down arrow to move it to a lower position.
  7. On the Transform Component screen, click Transform.

    Results: You see a notification in Inspire in the top left corner of the screen when the transformation has completed.

    • When you open the component that you transformed, you will see the new XML structure.
    • If you want to see the original XML, you must restore the transformed component.