Images, Batch Updating

 Objective

The purpose of the interface for uploading images in batches is to simplify image updates in your gallery. If you only have a few images to update, we recommend directly using the upload page in your image gallery, following the recommendations in the following help topic: Image Gallery

If you have numerous images to update, you can use batch processing. However, you must be familiar with creating ZIP archive files.

This is necessary because the image batch updating feature involves uploading a single ZIP file containing all of the image files that need to be updated. You can find more details below concerning the rules and structure that must be respected when using a ZIP file.
 
 ZIP File Structure

The maximum size authorized for the ZIP file is 5120 Kb.

The ZIP file not only contains the images, but also the categories to which these images are associated. Using categories is not mandatory but is highly recommended because it will lead to a much more organized gallery in relation to the type of images you are using (products, logos, partners, etc.). In the ZIP, the categories are represented by folders. All of the image files contained in a folder will be associated to the category bearing the same name as this folder.

You can organize a hierarchy of folders and sub-folders containing up to 5 levels. For example:
  • main-folder
    • sub-folder1
      • sub-folder2
        • sub-folder3
          • sub-folder4
            • image.jpg
The file names in the ZIP are used for the "Actinic" image names in the gallery. If the file names are Web-compatible, the system uses them "as-is" to store them on our servers. If they are not Web-compatible, the names are modified to remove any non-compatible characters.

As a general rule, and if you don't want your file names to be modified, only use uppercase and lowercase characters from A to Z , numbers from 0 to 9, dashes ( - ) and underscores ( _ ).

Example:

ZIP file contents:
Intro.jpg
Products\TV A423.jpg


Our ZIP file example above contains a file "Intro.jpg" in the root directory and a file "TV A423.jpg" in the "Products" folder.

After the update, the image gallery will contain two new files: "Intro.jpg" and "TV A423.jpg". The first file will not be associated to any specific category, whereas the second file will belong to the "Products" category (which will have been created, if necessary.)

The names of each image (not the file names!) that will be visible in the gallery will be "Intro (jpg)" and "TV A423 (jpg)" respectively. In other words, whenever possible, the file name in the ZIP will be the name of the image in your gallery.
 
 Rules of Syntax

Category and file names must respect a certain number of criteria. See details below:
• Category names (folders) must not exceed 100 characters. Otherwise, they will be truncated.
• Currently supported image formats are: jpg, jpeg, png and gif.
• Image file names must not exceed 100 characters. Otherwise, they will be truncated.
 
 Updating Rules

At the time of the update, if an image already exists in the gallery with the same file name AND the same folder/category, the file contained in the ZIP will replace the file in the gallery. The name of the image in the gallery will not be modified. This is nothing more than a simple update.

If an existing image in the gallery is updated by a new image contained in the ZIP, but the new image is located in a different folder from the category in the gallery, the image will be added in the gallery in the newly specified folder/category.

Exception:

In certain instances, a file that is already present in the gallery will not be updated when imported via batch processing, but will be duplicated.

The system relies on the file name and its path of origin. This parameter is called "Original Image" in the Actinic system. It is visible by clicking on [Edit View] in the image gallery and activating the "Original Image" column.

Let's take the example of a file example.jpg that has been added manually to the image gallery and classified in the Folder1 category. The path of origin (original image) stored by the system will be: example.jpg. If you then try to update this same file via a batch update by putting it in a ZIP Archive inside of a folder Folder1, the path of origin (original image) stored by the system will be: Folder1/example.jpg. Therefore, the image will not be updated, but will be added to the gallery.
 
 Image Path

By default, each image that is added to your gallery is placed on our servers in a randomly defined directory, independant from the folders you defined in your ZIP file.

The relative URL of the image respects the following format:

/Files/XXXXX/Img/YY/your-file.jpg

Where XXXXX is your Actinic account number and YY is a two-number code randomly generated by the Actinic system.
However, it is possible to make the system respect the defined relative paths contained in your ZIP file.

To activate this mode, check the option "Preserve folder structure" when importing your ZIP file. This mode is defined as "expert" because it is essential that every image, folder and sub-folder have a Web-compatible name (no accents, no apostrophes, no spaces, etc.).

Example 1

ZIP file contents:
Category\Sub-category\your-file.jpg

This gives a URL (relative path) that looks like:

/Files/XXXXX/Category/Sub-category/your-file.jpg

Where XXXXX is your Actinic account number. You can find your Actinic account number in the owner properties page of your administration space in the [Account\Owner Properties] menu.

Important Point: Images at the "root" of your ZIP archive (without folders) will have a path that is identical to that of the file gallery.

Example 2:

ZIP file contents:
your-file.jpg

This gives a URL (relative path) that looks like:

/Files/XXXXX/your-file.jpg
 
 Macintosh

If you use a Macintosh, it is necessary to delete the .DS_Store file generated inside of the archive when the ZIP file is created.

To avoid this nuisance, you can zip your folder using the Stuffit Deluxe Macintosh program. There is an option in this program that allows you to exclude troublesome files in the ZIP file, such as the invisible .DS_Store file, that pose problems when extracting the folder. In the program preferences, check the option: Ignore finder desktop file.

 

Add to favorites: http://www.oxatis.co.uk/Help/HelpCenterContent.asp?ActionID=512&TID=1238&MID=5000&LangID=1
© 2001-2018 Oxatis. All rights reserved.