File

Last Updated: 19 Jun 2017

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.

Bookmarks

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.
  • Choose a pre-uploaded file: Instead of uploading a file from your computer, you can upload a file that has already been uploaded to the server. You can select that file by clicking on the Choose a pre-uploaded file button. For more information on how to do this, refer to the Using Pre-uploaded Files section in this chapter.

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.

Using Pre-uploaded Files

When creating a new File, on the Create new File screen there is an option called Choose a pre-uploaded file. This option allows you to select a file that has already been uploaded to the Squiz Matrix server. For more information on how to upload a file to the server, refer to the Server Administrator manual.

When you click on the Choose a pre-uploaded file button, a select field will appear and the file browse button will hide. From here your can select which file to use for the current File asset.


Previous Chapter Next Chapter

Send Feedback

Noticed an error?
Want to suggest an improvement?

Let Us Know

The Latest

Let Us Know What You Think

Let us know if you spot any errors or if you have any ideas on how we can improve the Matrix Community Website.

Contact Squiz for Demo

Let us show you the true power of Squiz Matrix by giving you a personalised demonstration.