The File asset is used to upload files into Squiz Matrix. You would use this asset if a specific file type asset does not exist. For example, if you were uploading a MS Word Document you would ideally use the MS Word Document asset instead of the File asset.

Adding a File

When you add a new File, the following fields are available:

• Title: The name for the File asset. This will be used as the friendly name of the File and will appear in the Asset Map. This name will also appear where ever the keyword replacement %asset_short_name% is used.
• Upload File: Select which file to upload as the File from your computer.

Once you have entered the required information, click Save. Your File will appear in the Asset Map.

Once created, you can configure the settings of your File on its associated asset screens. The information on this page relates to specific screen functionality found on the File asset.

To find out which assets in the system have a hyperlink to a File, look at the Linking screen. The assets linked to the File will be listed in the Current Linking section.

Details Screen

The Details screen for a 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 chapter in the Asset Screens manual.

Details

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

The available fields are:

• Title: The Title (Asset Short Name) of the File. By default, the value that was entered into the Title field when the File was created will appear in this field.
• Filename: The filename of the uploaded File. By default, the name of the file that was used when the File was created will appear in this field.
• Upload File: This field allows you to upload a new version of the File.
  • Current File: This section outlines the details of the 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.

    If you have selected a new File to upload using the Upload File field, the details of this file will not appear in the Current File section until you Save the screen.

• Allow Unrestricted Access: Depending on what this setting is, the Status of the File and whether or not Public Read access has been granted, Squiz Matrix will use different URL formats.
  • Yes: If the Status of the File is Under Construction and Public Read access has been granted, then an asset map relative URL will be used, for example, http://www.example.com/resources/documents/report.pdf, where resources/documents are the parent assets of the File in the asset map. This means that it is served dynamically from the Squiz Matrix repository and hence is not optimal in terms of performance.
    
    However, If the Status of the 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/pdf/100/report.pdf where 100 is the asset ID of the File. This static URL gives optimal performance as it is served directly by the web server and doesn't have to get processed by Matrix first.
  • No: If this setting is No, then the asset map relative URL will be used. This may be required if an external system is referencing the file and needs to use the relative URL, for example, for robots.txt files.
  The default setting of the Allow Unrestricted Access field is Yes.