Ch. 001a. Before You Begin (AWI v1)

AUTOMATED WORKFLOW INTEGRATOR > AWI User Manual & Video
What It Is
Aleyant Automated Workflow Integrator is a desktop application that automates the transfer of Pressero orders into your back-end production process using hot folders. It eliminates the need to manually download and sort orders.
• Connects to your Pressero Orders automatically 
• Downloads orders on a schedule you set 
• Hierarchically applies multiple downloading rules 
• Creates control files (such as JDF or XML) to integrate with various 3rd party workflow solutions
• Places orders into local, network, or FTP hotfolders 
• Filters orders into production workflow based on file types 
• Filters orders into production workflow based on attributes for product, or equipment requirements 
• Creates subfolders for each order item if desired 
• Adds download date and time to file names for quality control 
• Displays download percentage status bar and activity log 
• Lists orders and items processed 
• Selectively reprocesses due to rule changes, accidental file deletion by staff 

Create a new Admin User Account in Pressero to be used for AWI
The application is licensed for one Pressero User Account only. It will be locked to this account and cannot be changed. We recommend you create an Admin User Account in Pressero and set it aside for the exclusive use of the Automatic Workflow Integrator. Perhaps something like awi@yourdomain.com, integrator@yourdomain.com, etc, and a login name value. You can uncheck the option for this user to Receive Notifications, the email address is used for login purposes only. This user must be part of an Admin Group that has permissions enabled to view and download orders. Once you have created the new admin user to be used for AWI access, or if you have any questions about enabling AWI on your account, please open a ticket to Aleyant Support at support.aleyant.com and we will review your submission as soon as possible.

Minimum System Requirements
Aleyant Automated Workflow Integrator is a desktop application. It can be run on Macintosh, Windows or Linux operating system. It is a small desktop utility that polls your Pressero account, and downloads information for any new orders. It does not require a lot of memory, but needs to be open and active to get orders from your Pressero account, and will require any permissions necessary on the account running AWI on that machine for transferring files to other folders, network folders, etc.
 
Windows Requirements
All the files for running AWI for Windows are included in the download zip file. If the AWI application is not starting on your Windows machine, please check that Microsoft .NET version 4 is active. This is usually updated automatically on the Windows machines, but we have seen instances where it needs to be done manually. Administrative permissions may be required for the account installing the AWI, please check with your system administrator if there are any questions about account capability.
 
Microsoft .NET Framework 4 (Standalone Installer)
https://www.microsoft.com/en-us/download/details.aspx?id=17718
 
Macintosh OSX Requirements
In order for the AWI to function properly on Macintosh OS X, you will need to install the Mono Framework and XQuartz packages onto the machine that will be running the AWI. Any security settings on that machine, such as Gatekeeper settings, need to be open, and the file installing AWI needs to have administrative permissions to perform the installation.
 
 
Linux Requirements
AWI can be run on Linux operating systems by using a common emulation package, such as WINE and installing and running the Windows version of AWI.
 
Installing a New Version
If you are installing AWI for the first time on your machine, please refer to the page below for the current version of the AWI application for Windows and Macintosh. New versions are posted to this page when they are made available. Unzip the downloaded file from the website page below. On Windows, this will extract to a folder with the AWI executable file and other required files. On Macintosh, the download will extract to a single application file bundle.
 
Ch. 005 Application Download
 
Updating to New Version
The Automated Workflow Integrator database file and settings like download rules are stored in the user account folder on the machine it is installed on. This is separate from the program files, so updating your AWI application does not affect your current database file and settings. When updating your copy of AWI, the new downloaded files will completely replace any older files on your machine. Delete your old folder containing AWI, and replace completely with the new downloaded version to update.

Windows
To update a previously installed version of Automated Workflow Integrator with the newest release, If you are installing AWI for the first time, it should only be necessary to download the file from the website, unzip it and move the unzipped folder to a desired location on your desktop or hard-drive. Administrative permissions may be required for the account installing the AWI, please check with your system administrator if there are any questions about account capability.

1. Download the new zip file, unzip it.
2. If upgrading, delete your old AWI folder, and replace it with the new AWI folder.
3. Double-clicking JobDownloader.exe launches the AWI.

Macintosh OSX
To install for the first time, or update a previously installed version of AWI with the newest release on the Macintosh has additional steps. The Mac hides the fact the AWI application downloaded is actually a folder, and a permissions change done on the command line within the application is required to ensure that AWI will launch correctly on that machine. Administrative permissions will be required for the account installing the AWI for these changes, please check with your system administrator if there are any questions about account capability.

1. Download the newest Macintosh version of the AWI from the Application Download page.
    Double click the AutomatedWorkflowIntergartor-Mac.zip file to unzip the JobDownloader app.

2. Go to your Mac's Applications > Utilities folder. Find and open the Terminal application. You should see something like the following text in the Terminal window. In this example, MacMini is your computer name and jsmith is your user account. The command line active cursor appears as a blinking gray box or underscore where any typed text is inserted at.
  MacMini:~ jsmith$ followed by a blinking cursor.

3. Copy this command: cd ~/Downloads and paste it into In the Terminal window where the active cursor is.
    MacMini:~ jsmith$ cd ~/Downloads

4. Click your Return or Enter key.

5. Copy this command and paste it into the Terminal window where the active cursor is.
    chmod +x ./JobDownloader.app/Contents/MacOS/JobDownloader
    Terminal window should look like this:
  MacMini:~ jsmith$ chmod +x ./JobDownloader.app/Contents/MacOS/JobDownloader

6. Click your Return or Enter key, Terminal window should look return this:
  MacMini:~ jsmith$
 
7. Quit the Terminal.

8. Go to your Downloads file, find the JobDownloader.app and double-click it, this will start the JobDownloader. Click the red button to close it, or enter your AWI account credentials to start using AWI. Or close it if you wish to move the JobDownloader.app file to another location.

9. If you are updating a previously installed copy, go to your Applications folder, or wherever the AWI program was installed to. Delete the old JobDownloader.app by dragging it to the trash, and empty the trash if you like. Now move the newly downloaded JobDownloader into the destination folder, finished.
 
When you first run the AWI on the Macintosh, or when you first run a new version of the AWI that you have downloaded as an update, the Macintosh will prompt and ask you to confirm that you do wish to run this application. This is a standard default setting on Macintosh operating systems and it is expected to see a prompt such as the one below.
 
 
If you have followed all the steps above and AWI is still not launching for you on Macintosh, please try to see what errors are being generated by reviewing the console log. Go to Applications > Utilities > Console.app and launch the console. The default should be showing you all the system messages when the console opens. Launch the AWI again and pay attention for new messages getting generated by the AWI. Copy and paste those messages into a support ticket and we will review that and see if anything is apparent from the log information. Please include operating system version when submitting that information to us, you can see that easily by going to the Apple menu at the upper-left of the desktop and choosing About this Mac.