0 Introduction

1 Email Order System Pro 4.0 Enhancements

   1.1 Multi-Catalog Collections
   1.2 New 'Collect Files' EJaP to find, collect, and convert files
   1.3 Multi-Language Support
   1.4 Auto-Fill order form with user information from Cumulus $Users Catalog (Server Console)
   1.5 Easy Configuration and Integration
   1.6 Asset Actions to convert files

2 Miscellaneous

   2.1 bcc: the email order
   2.2 Show catalog name in email order form for Multi-Catalog Collections
   2.3 Send email in HTML format

3 Feedback

The Email Order System Pro 4.0 Example Web Application with 2 additional menu items

The Email Order System Pro is an extension to the Canto Cumulus Web Publisher Pro (WPP) or Internet Client Pro (ICP) Option. The new version supports WPP/ICP 3.0 (shipped with Cumulus 6) and WPP/ICP 7.0 with '3.0 Design' web applications.

With the help of this extension, the user of the WPP/ICP can order files from his service provider by email. An order form will be displayed which can be configured by the administrator of the website. The order form information will be sent to a given email address after mandatory fields evaluation. For the person who processes the order, the 'Email Order System Pro' comes with functions (implemented for the Cumulus Client as an EJaP) for Mac OS and Windows which helps to find the ordered files in the Cumulus catalog. The EJaP (Embedded Java Plugin) 'CollectFiles' also performs the specified Asset Actions(!) to convert the files. It will also inform about missing files in the catalog.

The 'Email Order System Pro' comes with two different order forms. The first form is used to send a list of file names in the order email, the second form enables the user to also specify the number of ordered files, the format, the price or additional information. The second order form is used by print service providers.

The new version of Email Order System Pro supports multiple catalogs (Multi-Catalog Collections) and also supports multiple languages. The product supports German and English out of the box, more languages can be added in localisation files easily!

This document contains an overview of the new features and functions of the new version of the Email Order System Pro 4.

1.1 Multi-Catalog Collections

Canto Cumulus supports Multi-Catalog Collections, which means that you can open a lot of catalogs at the same time in one Client window or in the web browser. The Email Order System Pro 4 now also supports multi-catalog collections: the email order form will send asset and catalog information to the email order recipient.

The order form will provide asset and catalog information, if necessary

The information about the assets and the catalogs is provided in the email order (if necessary). The email contains the following information: Catalog Name, Asset Name, internal Cumulus Record ID to identify the correct records in the catalogs, and the selected Asset Action (conversion).

The email order also contains catalog and asset action information

The new version 4 of the 'Collect Files' application for the Cumulus Client will inform you if catalogs are not open in your current collection, if needed:

A catalog is missing in the collection, collecting the files can not be performed

You can only use the 'Collect Files' application if all the catalogs necessary to perform the collection are open in the frontmost Cumulus Client window.

1.2 New 'Collect Files' EJaP to find, collect, and convert files

'Collect Files' is an EJaP (Embedded Java Plugin) for the Cumulus Client on Mac OS X and Windows. The application performs a search for the list of ordered files that you have received in the email order. The new version can also help to copy the ordered files to a folder while taking the selected 'Asset Actions' into account! So the application can convert the files before they are copied to the specified folder.

'Collect Files' performs a search for the files, copies and converts the files

A progress bar informs about the progress of the search or conversion. You can cancel the process at any time. 'Collect Files' will inform about errors that arise while processing the order (like missing or duplicate files, conversion errors, etc.).

1.3 Multi-Language Support

The Email Order System Pro supports English and German out of the box. The Cumulus Admin can add more languages, if necessary. All the text can be localised in localisation files and the language used in the order forms and emails can be specified in the configuration file.

The product comes with two localisation files:

- EOSP_en_US.properties (English)
- EOSP_de_DE.properties (German)

To add another languages just duplicate one of these files and localise the strings inside the file.

1.4 Auto-Fill order form with user information from Cumulus $Users Catalog (Server Console)

The Canto Cumulus User Management that is implemented in the Cumulus $Users catalog can hold a lot of information about the user. You can specify the additional user information in the Server Console User Manager in the 'Additional Fields' Tab. These user properties can be used by the Email Order System Pro in the email order form:

Specify the additional user info in the Cumulus Server Console to use it on the order form

If the configuration attribute 'UseUserInformation' is set to true (default), the information is automatically read into the Email Order form, so the user does not have to specify all the details with every order again and again. Of course the user is allowed to overwrite the information, if necessary.

The order form fields have been filled automatically based on the Cumulus Server users' properties

Please keep in mind that you can open the $Users catalog in the Cumulus Client to fill the additional fields in a quite comfortable way!

1.5 Easy Configuration and Integration

The new version comes with a new seperate configuration file. In the configuration file, you can specify the following parameters:

- the product serial number
- the language used in the web application (email order forms, messages and emails)
- the name of the Email Template File
- the email content type (text or html email)
- auto-fill the order form with Cumulus User Information

Specify the language and email setup in the configuration file

Each web application can have a seperate configuration file. You can also have one configuration file for all your web applications. Just put this file into the Temporary Folder of your Tomcat web application server to allow access to the file from all web applications.

1.6 Asset Actions to convert files

The email order now also contains the asset action per file that has been specified by the user in the Collection Basket of WPP/ICP.

The email order also contains asset action information

'Collect Files' now supports these 'Asset Actions'. In the example above, some of the files will just be copied into the specified folder, others will be converted to JPG before they are put into the specified folder.

Select 'Use action' to convert the files before collecting the files in a folder

In 'Collect Files' you can specify if you want to convert the files by using the specified Asset Actions, or not.

Important: please not that Canto does not support using the asset actions in EJaPs on Mac OS X in Cumulus Version 6 (what a shame - and they are not willing to fix this). This function is only available to all Windows users and to Macintosh users with Cumulus version 7.0 and higher.

2.1 bcc: the email order

You can now blind carbon copy the email order to a list of specified addresses. You can specify the bcc attribute in the Email Order Form attribute 'bcc' in the files 'EmailOrderForm.jsp' and 'EmailOrderFormSelection.jsp'

2.2 Show catalog name in email order form for Multi-Catalog Collections

The name of the catalog is displayed with every asset in the collection basket. This is necessary if you are working with a mult-catalog collection. The name of the catalog is not displayed if you are only using one catalog in the current collection.

The catalog names are displayed with every asset

2.3 Send email in HTML format

In the Configuration File you can specify the Content Type of the email. If you set this property to 'text/html' (default is 'text/plain') the email will be sent in HTML format. This will allow to use formatting the text in the email order by using HTML tags.

The product comes with two example Email HTML Templates (in English and German) that you can use as a start to develop your own HTML templates. You can find the files at 'EmailOrderSystemPro4/Standard/EmailOrderSystemPro/config/templates'.

The files are named 'EmailTemplateHTML_en_US.txt' and 'EmailTemplateHTML_de_DE.txt'.

Your feedback is very much welcome!

Please send all your questions about the product to the email address support@heymann-consulting.de. We try hard to answer your questions quickly and improve our products by implementing functionality based on your feedback.