Bulk File Import Tool

The Bulk File Import Tool allows you to upload multiple files through the browser into a specified location. The type of asset that is used will be assigned based on the extension of each file you upload. For example if you are upload a MS Word Document, a MS Word Document asset will be created. If a specific asset type is not available for the file you are importing, a File asset will be created.

Bookmarks to the headings on this page:

  1. Global Options
  2. Choose File or Directory

Global Options

This section allows you to change the settings for all of the files that are to be imported. The Global Options section of the Bulk File Import Tool screen is shown in the figure below.

5-0-0_global-options-section.png
The Global Options section

The following fields are available:

  • Allow Unrestricted: this field allows you to set the default value for the Allow Unrestricted Access field for the file. 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 style URLs.
    • Yes: if the Status of the file is Under Construction and Public Read access has been granted then a human readable URL will be used, for example, http://example.com/image.jpg. 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 file is Live and Public Read access has been granted then a static URL will be used, for example http://example.com/__data/assets/image/100/image.jpg where 100 is the asset ID of the 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 field is Yes.
  • Link Type: select the default link type for the file assets that will be created. These options include TYPE_1 and TYPE_2. By default it is set to TYPE_1.

Choose File or Directory

This section allows you to select which files to import from the server and/or the local computer.

By default, if you have not set the Server Import Directory on the Import Tools Manager, a Warning message will appear in the Choose File or Directory section, as shown in the figure below.

5-0-0_choose-file-directory-section-warning.png
The Choose File or Directory Warning message

Once the directory has been set on the Import Tools Manager, additional fields will be displayed in this section, as shown in the figure below. For more information on the Import Tools Manager, refer to the System Management manual.

5-0-0_choose-file-directory-section-additional-fields.png
The Choose File or Directory section with additional fields

The fields that are available in this section will depend on what has been selected in the Allowed Import Type field on the Import Tools Manager is set to, will depend on what fields appear in the Choose File or Directory section. 
  • If Allowed Import Type is set to Server and Local, both the Server File Import and Local File Import fields will appear, as shown in the figure above.
  • If Allowed Import Type is set to Server Only, only the Server File Import fields will appear.
  • If Allowed Import Type is set to Local Only, only the Local File Import fields will appear.

For more information on the Import Tools Manager, refer to the System Management manual.

Server File Import

The Server File Import fields allow you to import the files that have been uploaded to the specified directory on the server. These fields are shown in the figure below.

5-0-0_server-file-import-fields.png
The Server File Import fields

This section will list the number of files and sub folders it finds in the specified directory on the server. For example, in the figure shown above, the system has found five files and one folder, called temp, that contains one file in the /home/ directory. It will only find the first level of sub folders; it does not look within folders for additional folders. For example, in the figure shown above, if the temp folder had another folder inside that, the system will not find it.

For each set of files that you want to import, click the Select for Import box and select where to create them in the Import Under field. For example, if you want to create the PDF files under a Folder asset called PDF Files, select this Folder in the Import Under field. You can select different assets for each set of files. For example, in the figure shown above, we can select the Site for the first set of files and a folder asset for the second set of files. If you do not want to import a set of files, do not click the Select for Import field.

Tip: If you click the Select for Import box but do not select an asset in the Import Under field, the files will not be imported into the system.

The Sort the files alphanumerically on import? option allows you to sort the files imported by the Bulk File Import Tool in alphanumeric order (i.e. numerals -> capital letters -> lower case letters).

Once you have entered the required information, click Commit. The file assets will be created under the Import Under asset in the Asset Map.

Local File Import

The Local File Import fields allow you to bulk upload files that are on your local machine. These fields are shown in the figure on the below.

5-0-0_local-file-import-fields.png
The Local File Import fields

Select where to create the files in the system in the Root Asset field. For example, if you want to create them under a Folder asset called PDF Files, select the asset in this field. Select the file to upload in the Choose File field. To select additional files to upload, click the Click Here to Add hyperlink. An additional field will appear on the screen. Once you have selected the files you want to import, click Commit. The file assets will be created under the Root Asset in the Asset Map.

PreviousNext