XSL File

An XSL File asset is used to upload XSL (extensible style sheet language) files into Squiz Matrix. These files can then be used to style XML Files in the system. Once you have created an XSL File, it can be used as many times as you like within your Squiz Matrix system.

Adding an XSL File

When you add an XSL File, the Create new XSL File screen will appear. The Details section of this screen is shown in the figure below.

The fields available on the Create new XSL File screen

Enter the following details for the XSL File asset:

• Title: enter the name for the XSL File asset. This will be used as the friendly name of the XSL File and will appear in the Asset Map. This name will also appear when the keyword replacement %asset_short_name% is used. This field is required when creating an XSL File.
• Upload File: select which file to use as the XSL File. To do this, click on the Browse button - the File Upload pop-up will appear. Locate the file that you want to use, left click on it and click on the Open button. The path of the file that you have selected will appear in the Upload File field. You can only upload files of type XSL.

Once you have entered the required information, click Commit. Your XSL File will appear in the Asset Map on the left hand side of the screen.

Once created, you can configure the settings of your XSL File  on its associated asset screens. These screens are often the same or similar to those for a Standard Page and are described in the Asset Screens manual. In this chapter, we will describe the Details, which is different for an XSL FIle.  

Tip: To find out which assets in the system have a hyperlink to an XSL FIle, look at the Linking screen. The assets linked to the XSL File will be listed in the CurrentLinking section.

Details Screen

The Details screen for an XSL File allows you to set up this asset. For more information about the Status, Future Status and Thumbnail sections of this screen, refer to the Details Screen chapter in the Asset Screens manual.

Details

This section allows you to change various details of the XSL File including the Title and which file to use.

The Details section of the Details screen

The fields available are as follows:

• Title: by default, the Title that was entered into the Title field when the XSL File was created will appear in this field. You can change the Title by clicking into this field and entering the new Title for the XSL File.
• Filename: by default, the name of the file that was used when the XSL File was created will appear in this field. You can change the name of the file by clicking into this field and entering the new file name.
• Upload File: this field allows you to upload a new version of the XSL File. This file can be an updated version of the file or a different file. To upload a new file, click on the Browse button; the File Upload pop-up will appear. Locate the file that you want to use, left click on it and click on the Open button. The path of the file that you have selected will appear in the Upload File field.
• Current File: this section outlines the details of the XSL File including the size of the file and when it was last updated. If you click on the Current File link, a preview of the file will appear in a new window.  

  Tip: If you have selected a new XSL FIle to upload using the Upload File field, the details of this file will not appear in the Current File section until you click Commit.  

• Allow Unrestricted Access: depending on what this setting is, the Status of the XSL File and whether or not Public Read access has been granted, Squiz Matrix will use different style URLs.  
  • Yes: if the Status of the XSL File is Under Construction and Public Read access has been granted then a human readable URL will be used, for example, http://www.example.com/text.xsl. This means that it is served dynamically from the Squiz Matrix repository and hence is not optimal in terms of performance.
    If the Status of the XSL File is Live and Public Read access has been granted then a static URL will be used, for example http://www.example.com/__data/assets/image/100/text.xsl where 100 is the asset ID of the XSL File. The static URL gives optimal performance as it is served directly by the web server.
  • No: if this setting is No, then the human readable URL will be used. This may be required if an external system is referencing the file and needs to use the dynamic human readable URL.
  The default setting of the Allow Unrestricted Access field is Yes.

Updating the XSL File

Once an XSL File has been created, you can change the file that it is using at any time. To do this, go to the Details screen of the XSL File. In the Upload File field, click on the Browse button - the File Upload pop-up will appear. Locate the file that you want to use, left click on it and click on the Open button. The path of the file that you have selected will appear in the Upload File field. You can only upload files of type XSL.

Once you have clicked Commit, any assets that reference the XSL File will be updated with the new version of the file.

XSL Transformation

An XSL File can be used on the Transformations screen of an XML File asset to stylise the content of the XML. The Transformations screen is shown in the figure below.

An XSL File selected on the Transformations screen of an XML File

An XSL File has been selected in the XSL Transformations section and will be used to style the XML File. For more information, refer to the Transformations Screen section of the XML File chapter in this manual.

PreviousNext