Ae12 UserGuide
Ae12 UserGuide
User Guide
Automation Engine
Contents
1. About Automation Engine........................................................................................................................................................6
1.1 Copyright Notice................................................................................................................................................................6
1.2 Getting Help.........................................................................................................................................................................8
4. Server Administration.............................................................................................................................................................. 30
4.1 Starting and stopping the server..............................................................................................................................30
4.2 Setting up the server.....................................................................................................................................................31
4.3 Backing up the server...................................................................................................................................................31
4.4 Restoring the server...................................................................................................................................................... 32
4.5 Managing databases..................................................................................................................................................... 32
4.6 Managing SQL servers................................................................................................................................................. 35
4.7 Managing application servers.................................................................................................................................... 35
ii
Contents
iii
Automation Engine
11. Scripting....................................................................................................................................................................................177
11.1 Automation Engine Script Runner.......................................................................................................................177
11.2 Getting Started with Scripting.............................................................................................................................. 178
11.3 Use case: Scripting...................................................................................................................................................180
iv
Contents
v
1 Automation Engine
6
Automation Engine
1
Software BVBA shall not be liable for any direct, indirect, consequential or incidental damages arising
out of the use or inability to use the software or the information contained herein.
The information contained herein is subject to change without notice. Revisions may be issued from
time to time to advise of such changes and/or additions.
No part of this document may be reproduced, stored in a data base or retrieval system, or published,
in any form or in any way, electronically, mechanically, by print, photoprint, microfilm or any other
means without prior written permission from Esko Software BVBA.
This document supersedes all previous dated versions.
®
PANTONE , PantoneLIVE and other Pantone trademarks are the property of Pantone LLC. All other
trademarks or registered trademarks are the property of their respective owners. Pantone is a wholly
owned subsidiary of X-Rite, Incorporated. © Pantone LLC, 2012. All rights reserved.
This software is based in part on the work of the Independent JPEG Group.
Portions of this software are copyright © 1996-2002 The FreeType Project (www.freetype.org). All
rights reserved.
Portions of this software are copyright 2006 Feeling Software, copyright 2005-2006 Autodesk Media
Entertainment.
Portions of this software are copyright ©1998-2003 Daniel Veillard. All rights reserved.
Portions of this software are copyright ©1999-2006 The Botan Project. All rights reserved.
Part of the software embedded in this product is gSOAP software. Portions created by gSOAP are
Copyright ©2001-2004 Robert A. van Engelen, Genivia inc. All rights reserved.
Portions of this software are copyright ©1998-2008 The OpenSSL Project and ©1995-1998 Eric
Young ([email protected]). All rights reserved.
This product includes software developed by the Apache Software Foundation (http://
www.apache.org/).
Adobe, the Adobe logo, Acrobat, the Acrobat logo, Adobe Creative Suite, Illustrator, InDesign, PDF,
Photoshop, PostScript, XMP and the Powered by XMP logo are either registered trademarks or
trademarks of Adobe Systems Incorporated in the United States and/or other countries.
Microsoft and the Microsoft logo are registered trademarks of Microsoft Corporation in the United
States and other countries.
SolidWorks is a registered trademark of SolidWorks Corporation.
Portions of this software are owned by Spatial Corp. 1986 2003. All Rights Reserved.
JDF and the JDF logo are trademarks of the CIP4 Organisation. Copyright 2001 The International
Cooperation for the Integration of Processes in Prepress, Press and Postpress (CIP4). All rights
reserved.
The Esko software contains the RSA Data Security, Inc. MD5 Message-Digest Algorithm.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun
Microsystems in the U.S. and other countries.
Part of this software uses technology by BestTM Color Technology (EFI). EFI and Bestcolor are
registered trademarks of Electronics For Imaging GmbH in the U.S. Patent and Trademark Office.
Contains PowerNest library Copyrighted and Licensed by Alma, 2005 – 2007.
All other product names are trademarks or registered trademarks of their respective owners.
Correspondence regarding this publication should be forwarded to:
7
1 Automation Engine
8
Automation Engine
2
9
2 Automation Engine
10
Automation Engine
2
Files and Jobs in Automation Engine
In Automation Engine, your files can be part of jobs (customer orders that contain files and related
customer information), that are located in containers (local or remote shared folders that Automation
Engine can access).
Depending on how you want to work with Automation Engine, you can link your jobs to customer
products, focus on job pages, proofs, plates...
11
2 Automation Engine
•
Containers : this shows all the data that Automation Engine can access, in the different
Containers. For more information, see Containers.
•
Job Overview : this lists all jobs existing in the Automation Engine Job database. See Jobs.
•
Last used Job : this shows the last job you worked on, and the job's data (files and folders).
2. The Views highlight different parts of the Automation Engine functionality. Certain views are only
accessible in defined workflows. For more information, see Views.
3. The Tools area contains tools useful to administrate Automation Engine. See Tools for more
information.
4.
The Create Job button allows you to create a job.
5.
The New Task button creates a new Ticket from the pilot. You can create a new workflow
from the pilot using . Using the button, you can access the information regarding the
files.
The contents of the central panes depend on the View you are in.
2.1.2 Views
The Pilot's Views highlight different parts of the Automation Engine functionality. You can use them
to work with your data in different ways (see Different Ways of Working with Automation Engine).
Note:
• Depending on the mode you are using (Containers, Job Overview or Last used job), you will
have access to different views.
• Depending on your access rights, you may not be able to see some of the views.
Files
The Files view allows you to manage your jobs, files, favorites, tasks... See The Files View for more
information.
To Do List
The To Do List view lists all actions that need user intervention. For more information, see The To
Do List View and To Do List.
Pages
The Pages view is only used in page workflows. It is extremely useful when working with impositions.
For more information, see Working with Pages.
12
Automation Engine
2
Products
The Product view shows the production files associated with your jobs, and allows you to reuse those
files for a similar order from the same customer. For more information, see Working with Products.
Proofs
The Proof view is only used in page workflows. It shows the proof sets and the proof details. See
Working with Proofs.
WebCenter
Before you can use the WebCenter view, make sure that your WebCenter site is correctly configured.
See Integration with WebCenter.
Plates
The Plates view is only used in page workflows. It shows details about all plates associated with
a job. It also includes advanced features for managing plates for jobs with multiple versions. See
Working with Plates.
CDI
The CDI view shows all the files sent to the Digital Flexo Suite and used to image a flexo plate on
a Cyrel Digital Imager. See The CDI View.
Tasks
The Tasks view shows the current state of processing: the running tasks, the tasks waiting for
execution and the recently finished tasks. See The Tasks View.
Devices
The Devices view lists all output devices connected to your Automation Engine server. It allows you
to monitor, start and stop your devices and device queues.
Milestones
The Milestone view shows all milestones set for your last job (in Last used job mode), or the
milestones set for all jobs (in Job Overview mode). See Milestones.
Hot Folders
The Hot Folders view lists all hot folders defined on the server (in Container mode) or all hot folders
defined for a job (in Last used job mode). It offers all the necessary tools to create and manage hot
folders. See About Hot Folders.
Tickets
The Tickets view shows a list of all tickets available on your server (both the default and your custom
tickets). See Tickets.
Jobs
This view is only visible in Job Overview mode. It lists all jobs defined on the server. See The Jobs
View.
13
2 Automation Engine
•
Containers : this shows all the data that Automation Engine can access, in the different
Containers. For more information, see Containers.
•
Job Overview : this lists all jobs existing in the Automation Engine Job database. See Jobs.
•
Last used Job : this shows the last job you worked on, and the job's data (files and folders).
2.2.1 Containers
A container is a special folder containing your files, folders and jobs, that Automation Engine can
access. It can be located either on your Automation Engine server or another machine.
By default, you have an empty ExampleJobContainer, on the drive Automation Engine was installed
on.
You can have many containers, that you can see in the Pilots’ Containers mode.
2.2.2 Jobs
What is a Job?
A job contains all the files and information relative to a customer job you process in Automation
Engine.
It has a blue icon and is stored in the Automation Engine Job Database. The database can hold
up to 100 000 jobs.
In the Containers mode, you can see your job in its container.
14
Automation Engine
2
In the Last used job mode, you can see your job’s subfolders and files.
Job Metadata
You can attach an extended set of metadata to every job: customer information, inks to use, bar
codes, impositions...). This metadata is stored in the Automation Engine database, and will be used
when launching tasks on the job.
Job Automation
Automation Engine is very job-centric. On top of launching tasks and workflows on the job, you can
also have tasks be launched automatically when the job reaches a certain status (for example: a new
page has been delivered, the sheet is complete...).
For more information about Jobs, please see Working with Jobs in the Reference Guide.
2.3.1 Tasks
What is a Task?
A task is an action executed on a file, a folder or a job on the Automation Engine server.
Types of Tasks
There are seven types of tasks:
1. Conversion tasks such as Export to PDF, Export to PostScript...
2. File Creation tasks such as Create Wrapper File, Create PAF / JPG / XML...
15
2 Automation Engine
Task Settings
You can define settings for the tasks, and save these settings as Tickets to reuse them (see Tickets).
Task Progress
When a task is launched, you can monitor its progress in the Pilot. See Checking the Status of the
Task.
You can build new workflows from your task chains, while keeping all your tickets settings (see
Reusing a Task Chain Ticket to Build a Workflow).
2.3.3 Workflows
Automation Engine workflows are more powerful and flexible than the old BackStage workflows.
16
Automation Engine
2
You can build them and launch them on your files using the workflow editor (see The Workflow Editor).
You can also launch them from the Pilot or from Shuttle (see Using Shuttle to Upload and Process
Files).
2.3.4 Tickets
What is a Ticket?
The settings used when executing a task, task chain or workflow on a file can be saved as a ticket.
Public Tickets
You can make tickets public if you want to submit files to them from Shuttle. There are several ways
to make a ticket public (see Making Your Ticket Public in the User Guide).
Public tickets have a mark in the Public column.
17
2 Automation Engine
Note: Depending on your access rights, you may only see public tickets, and public parameters
inside the tickets.
18
Automation Engine
3
19
3 Automation Engine
a) Enter a User name and Password valid for your Automation Engine server.
20
Automation Engine
3
Note:
Before you define any user, you can log in using admin as both user name and password.
Once you have created users (see Creating Users), you can log in with one of your users’
credentials.
b) In Server, enter either your Automation Engine server’s name or its IP address.
c) Click OK.
Attention:
Creating a user via Automation Engine means that Automation Engine requests the Windows OS to
create that user.
Some changes to that user can then no longer be made through the Automation Engine Pilot, but
need to be done via the Windows user administration tools.
21
3 Automation Engine
b) in the Access Rights tab of the Properties window, check the access rights you want this
user to have.
Note: Automation Engine Administrators automatically have all access rights. You cannot change
this.
• To give a particular access right to several users:
a) in the Users window, click the Access Rights button to switch to the Access Rights view,
b) select the access right you want to give to your users,
c) check the users you want to give this access right to.
22
Automation Engine
3
23
3 Automation Engine
2. Select the option corresponding to your output device in the list at left (for example, select FlexRip
- Proofer Output to output to a proofer).
3. Go to File > New or use the Insert key (on Windows).
This shows tabs with parameters at right.
24
Automation Engine
3
Note: You can find that port number by going to Info > Ports in the Dispatcher.
c) Click the Synchronize with Rip / Synchronize with ProofNode button.
After a few seconds, your RIP/proof server is connected to Automation Engine, and you can see
its name in the Type field.
5. In the Queue tab:
a) Give your queue a name in the Queue field.
b) Choose a Queue Job Limit:
• choose 1 to have the RIP handle one file at a time (this ensures the files are ripped in the
order they enter the RIP),
• choose 2 to have the RIP handle two files at once (the files may not be ripped in the order
they enter the RIP if for example you send a big then a small file).
6. Go to File > Save to save the configuration.
You can now see the devices you are connected to in the Pilot’s Devices view.
25
3 Automation Engine
1. In the Pilot, select the Files view from the Views bar (or use Go > Files ).
2. In the Containers mode, browse to your chosen file.
3. Right-click it, select New Task then More Tickets...
Note: If you have launched tasks previously, the most recent task tickets you used are listed
above More Tickets...
4. In the Select Ticket dialog that opens, select the task ticket you want to use.
Note: This dialog contains all the tickets suitable for the file type you selected. You can choose
either a Default ticket, or a custom ticket (saved under a different name) if you have already
created one.
5. Click OK.
This opens the task’s ticket.
26
Automation Engine
3
Note: For a description of all of the ticket's settings for each task, see The Tasks: an Overview
in the Reference Guide.
You can monitor the tasks progress in the Files View's Task pane or in the Tasks View. See Check
the Status of the Task.
You can see the progress (in percentage) and the processing state. The state can be:
27
3 Automation Engine
• : starting
•
: success
•
: warning
•
: failure
•
: processing cancelled
If you click on the
You can also double-click the task entry in the Tasks pane to open your task ticket and check its
parameters.
Note: Depending on your access rights, you may only see the public parameters.
Note: If the the user access right for deep zoom is not enabled (read more here Defining User Access
Rights )while defining user rights:
• you can only view prepared files
• your zoom is restricted.
28
Automation Engine
3
You can now zoom in on the file, measure distances and densities, view separations individually or
together, etc.
Note: The task related to your output device will only be available once you have correctly configured
your output device.
29
4 Automation Engine
4. Server Administration
Automation Engine features a new web tool for server administration. This means that you
can access your server administration tool from any workstation via http://servername or http://
servername:9999/.
On this web server administration tool you will also find the client application(s) such as the
Automation Engine Pilot, a diagnostics tool, a back-up tool, ...
Server administration consists of:
• Starting/Stopping the server
• Setting up the server
• Backing up the server
• Restoring the server
• Managing databases
• Managing SQL servers
• Managing application servers
30
Automation Engine
4
31
4 Automation Engine
Note: Take into account that the server should be stopped before you can restore a back-up.
32
Automation Engine
4
• Back-up or restore databases
• Repare or move databases
Note: Take into account that, even if you are logged in to the Server Administration, you also need
to log in to the SQL Server instance separately.
33
4 Automation Engine
34
Automation Engine
4
Note: Take into account that, even if you are logged in to the Server Administration, you also need
to log in to the SQL Server instance separately.
35
4 Automation Engine
36
Automation Engine
5
Tip: To use a port other than the default port, add : and the port number after the host name.
For example: myftpserver:1085
3. Enter the User Name and Password you use to connect to the FTP server.
Make sure you use a valid User Name and Password corresponding to an account that exists
on the FTP server.
4. In File Transfer, choose between Binary and ASCII.
Binary will always work, but if you have an ASCII file, the transfer will go a bit faster when selecting
ASCII.
5. By default, the transfer uses Active Connection Mode (where the FTP server opens the data
connection).
If your system is behind a firewall that blocks incoming FTP server connections, select Passive
to use Passive Connection Mode (where the client initiates the connection).
6. Select Secure FTP if you are connecting to a secure FTP server (over FTPS, not SSL or SSH).
Tip: If you are experiencing problems using secure FTP, try connecting over regular FTP, and ask
your IT administrator to check the security settings of your FTP server.
7. If desired, you can delete the files from the FTP site once they are uploaded to the Pilot (select
Remove remote data after transfer).
37
5 Automation Engine
If you do this, you can choose to Backup remote data before removal. Select the Backup Folder
in which to copy the files.
8. When you are done, click Connect.
• either manually or by setting an application to output files there (for Task Hot Folders),
38
Automation Engine
5
• by setting your MIS system to output files there (for JDF Hot Folders).
39
5 Automation Engine
Note:
• Attach a task or task chain that will process all file types.
• Attach a workflow that will process all file types.
• Attach different tasks / workflows to process different file types.
10.When you are done, click OK in the New Hot Folder dialog.
40
Automation Engine
5
The Hot Folder is now listed in the Pilot's Hot Folders View. You can see information about the
Hot Folder in the Details pane at the bottom.
41
5 Automation Engine
4. In the Select Task Type and Settings dialog, enter your settings and click Save and Close.
42
Automation Engine
5
Note:
• You can add other tasks as steps to create a task chain (for more information, see Task Chains).
• Task (chain) tickets are copied into the hot folder and lose all relation with the original tickets.
43
5 Automation Engine
5. Select Grouped Launching if you want the files in the Hot Folder to be processed together (in
one workflow) instead of individually.
Tip: Use this with a specific Inactive time (for example 08:00 AM to 05:00 PM, so the files are
only processed at the end of the day) or a very large Poll Interval.
6. Select a Working Folder (Automation Engine will copy the input files to this folder and start the
processing from there).
7. Choose to Delete the input files when the automatic task is finished or not.
8. Add an Annotation if you wish.
44
Automation Engine
5
5. Modify your workflow if desired, then save and close it.
Note: The workflow ticket is copied into the hot folder and loses all relation with the original ticket.
6. Select Grouped Launching if you want the files in the Hot Folder to be processed together (in
one workflow) instead of individually.
Tip: Use this with a specific Inactive time (for example 08:00 AM to 05:00 PM, so the files are
only processed at the end of the day) or a very large Poll Interval.
7. Select a Working Folder (Automation Engine will copy the input files to this folder and start the
processing from there).
8. Choose to Delete the input files when the automatic task is finished or not.
9. Add an Annotation if you wish.
2. Click Add...
3. In the Add Step dialog, select the task (or task chain, or workflow) ticket you want to use and
click OK.
4. In the Select Task Type and Settings dialog, enter the settings for the task(s), or for each workflow
step, and click Save and Close.
Note:
• You can add other tasks as steps to create a task chain (for more information, see Task Chains).
• The tickets you choose are copied into the hot folder and lose all relation with the original
tickets.
45
5 Automation Engine
a) Select the File Types you want to automatically process with this task, task chain or workflow.
Note: Some files with external references are not supported (PLA, STA, GRQ, GRI...).
b) Select a Working Folder (Automation Engine will copy the input files to this folder and start
the processing from there).
c) Choose to Delete the input files when the automatic task is finished or not.
d) Add an Annotation if you wish.
e) Click OK.
46
Automation Engine
5
6. Back in the New Hot Folder dialog, add tasks, task chains or workflows for other files types if
desired.
Tip: You can export the task ticket used for your Hot Folder, to be able to use it throughout
Automation Engine. Use the Export Ticket... button and give the ticket a different name.
47
5 Automation Engine
Note: You can only do this if your old Hot Folder was launching a workflow, not a task chain consisting
only of task steps.
You don't need to make new Hot Folders as your old Hot Folders will keep on working, but the
advantages of updating your Hot Folders are:
• You don't need to add a separate Copy Or Move File task to copy the incoming files to a job
folder (you can use First, move files (to Job)).
• You can edit the workflow to launch directly from within the New Hot Folder dialog.
• You can set a Poll Interval (how often Automation Engine will check the Hot Folder for new files).
• You can assign a processing Priority to the files coming into your Hot Folder.
• You can use Grouped launching to process the files in the Hot Folder together (in one workflow)
instead of individually.
You can also use Ctrl + C (on PC) or Command + C (on Mac).
d) Close the old Hot Folder setup window.
48
Automation Engine
5
2. Create a new Hot Folder and:
a) Choose A Workflow for all File Types in Automatic Tasks.
b) Click the Set Up Workflow... button.
c) In the Select a Workflow to Start from dialog, select the Default workflow ticket.
d) In the workflow editor window that opens, paste the workflow you copied from the old Hot
Folder and connect it to the Start step.
Do the rest of the Hot Folder setup as explained in Creating a Task Hot Folder on page 39.
49
5 Automation Engine
3. Enter the Port to use for communication between your Automation Engine server and the Shuttle
clients.
Note: By default this is port 5182, but if this port is already used by other processes, you should
enter the next available port.
50
Automation Engine
5
5. Select Start Shuttle server automatically when Automation Engine is started if you plan to make
frequent use of the Shuttle technology.
6. Click the Start button to start Shuttle server.
Shuttle server makes Automation Engine’s workflows, tasks and files accessible to the Shuttle
clients.
7. Save your settings.
Note: If you need to make changes to this Setup, you must Stop the Shuttle server first.
Important: With Shuttle, you can submit files to any Automation Engine task, task chain or workflow
that has a custom ticket. To do this, you need to make the ticket public.
•
Select your ticket in the Ticket view, click and select Public.
51
5 Automation Engine
• Right-click your ticket in the Ticket view and select Public Ticket.
52
Automation Engine
5
• When connecting to an Automation Engine server, enter the User Name and Password you
use to log in to the Pilot (the password can be blank if your server is configured to accept this).
You will have the same access rights (for example, the right to set processing priorities or not)
in Shuttle as you have in the Pilot.
Note: If you don’t know which User Name and Password to use, contact your system
administrator.
5. To connect to a server not broadcasting over the Bonjour network (Automation Engine servers or
non-Bonjour-enabled Nexus servers):
a) Select Manual in the Browse Method list
b) Enter your server’s name or IP address in Server Address
c) Fill in the Server Port used by your server
53
5 Automation Engine
Note:
When connecting to an Automation Engine server, enter the port you defined in Configure (see
Automation Engine Setup for Shuttle).
Note:
If you are using the Shuttle plug-in with other Deskpack plug-ins, and you have set up a server
connection with the Server Connection Assistant, you will see this connection in bold in the Shuttle
plug-in’s Servers list (after restarting Illustrator).
You will be able to change the user name and password if necessary, but you will not be able to
remove this connection from the Shuttle plug-in.
See the Adobe Illustrator Client documentation for more information on the Server Connection
Assistant.
54
Automation Engine
5
Tip:
If you are running an Automation Engine Pilot on the same computer, or another Shuttle
client connecting to it (either PackEdge, Plato or FastImpose Server), you can select Login
automatically with user name and password from other application connected to the server.
This way, if you are already logged in to the Pilot or the other client application, you won't need
to log in when starting PackEdge / Plato / FastImpose Server.
Do this when:
Note: If the file you are launching is already located in an Automation Engine job, it will
automatically be processed within that job’s context (you don’t need to enter the Job ID).
55
5 Automation Engine
Note:
You can open several Launch windows, and select a different workflow in each.
If you quit and restart Shuttle, your Launch windows will be remembered.
• Drag and drop your file on the Drop Files Here arrow.
• Click the Launch... button and browse to the file you want to launch.
• Go to File > Launch... and browse to the file you want to launch.
• Use Command + S (on Mac).
5. If your workflow has public parameters, you will see a pop-up where you can fill them in.
56
Automation Engine
5
Note:
For more information on public parameters, see:
57
5 Automation Engine
58
Automation Engine
5
2. Choose what file type you want to launch your file as.
59
5 Automation Engine
Note: Use the Search... button to see a list of your server's jobs, with job information and a filter.
4. If you want to add your file to an Automation Engine product, select it in the Product list or fill
in the Job ID and/or Job Part ID.
Note: Use the Search... button to see a list of your server's products.
60
Automation Engine
5
7. Click the Launch button.
Attention: You must save your file on an Automation Engine container before you can launch it into
a workflow from PackEdge or Plato.
2. Select the workflow you want to launch on your file in the workflow list.
3. If your workflow has public parameters, you can fill them in in the same window.
Note: For more information on public parameters, see Using Public Parameters.
61
5 Automation Engine
Tip:
To access Shuttle easily in the future (without using the menus):
1.
62
Automation Engine
5
2. Choose what file type you want to launch your file as.
• When working with FastImpose Server, you can only launch your file as an IMP file.
• When working with FastImpose Standalone, you can launch your file either as a JDF or a PDF
file.
Click the Settings... button to set JDF or PDF Export Preferences (see the FastImpose manual
for more information).
3. Select the workflow you want to launch on your file in the workflow list.
4. If your workflow has public parameters, you can fill them in in the same window.
63
5 Automation Engine
2. Select the workflow you want to launch on your file in the workflow list.
3. If your workflow has public parameters, you can fill them in the same window.
For more information on public parameters, see:
Note: If you want to go back to the default parameters values after changing them, use the Reset
To Defaults button.
64
Automation Engine
5
Note: This uses the PDF Export plug-in to convert your Illustrator file to Normalized PDF. To refine
the conversion, click Settings... and edit the PDF Export Preferences.
3. If you want to link your file to an existing Automation Engine job, fill in the Job ID and/or Job
Sub ID.
65
5 Automation Engine
Note:
• You must enter a Job ID / Job Sub ID that already exists on your Automation Engine server.
The Shuttle plug-in cannot create jobs.
• The Normalized PDF that you launch with a Job ID / Job Sub ID will be linked to that job, so
that tasks and workflows processing that file can use the job parameters.
• If you are launching a file that was already in an Automation Engine job, the Job ID and/or Job
Sub ID will be filled automatically.
4. Select the workflow you want to launch your file to in Launch To Workflow.
5. If your workflow has public parameters, you can fill them in in the same window.
6. Click Launch to launch your file.
66
Automation Engine
6
Note: To create a custom workflow ticket, see Building a Workflow from Zero.
Note: The Scope is always Global when creating a custom ticket from the Tickets view.
67
6 Automation Engine
68
Automation Engine
6
Note:
• If you are not in a job context, the Scope is always Global.
• If you are in a job context, you can choose between Job and Global Scope.
When choosing the job scope (called after your job), you cannot make the ticket public.
69
6 Automation Engine
• Allow the user to set the value if you want Shuttle users to be able to freely enter a value
for that parameter.
• Let the user select a predefined value if you want Shuttle users to choose from a list of
values that you define.
70
Automation Engine
6
If that parameter already has a list of values to choose from in the Ticket, they will be
displayed here. You can Add or Remove values.
Note: Shuttle operators will see (and choose from) the Predefined Settings but not the
associated Values.
c) If you have chosen Let the user select a predefined value: in Default Predefined Setting,
choose the setting that will be selected by default when submitting files from Shuttle (if the
operator doesn’t select another setting, this one will be used for processing).
4. Don’t forget to save your ticket.
If you chose Allow the user to set the value If you chose Let the user select a predefined
value
71
6 Automation Engine
The Manage Public Parameters dialog that opens contains all of your ticket’s public parameters.
The left pane shows all parameters that can be made public for that ticket (the ones you have
made public are greyed out).
72
Automation Engine
6
The right pane shows the parameters you have made public, with their settings (predefined values,
etc.).
2. You can:
• use presets to simplify operators’ choices (see Using Presets to Simplify Operators’ Choices).
73
6 Automation Engine
3. Drag parameters from the dialog’s left pane into the preset.
You can drag as many parameters as you want. They will appear under each value (here both
under Offset and Dry Offset).
74
Automation Engine
6
75
6 Automation Engine
•
Select your ticket in the Ticket view, click and select Public.
• Right-click your ticket in the Ticket view and select Public Ticket.
76
Automation Engine
6
What is a SmartName?
A SmartName is a variable that refers to a predefined value, for example [File] refers to the name
of the input file, and [Date] refers to the current date.
You can use SmartNames to fill in settings all across Automation Engine. They are displayed in green
and between square brackets.
Using SmartNames ensures you can use existing information as a setting without having to remember
it, and reduces errors.
77
6 Automation Engine
Using a SmartName
You can use SmartNames anytime you see the SmartName symbol in a text field.
1. Click .
2. In the Insert SmartNames dialog:
a) browse to your SmartName using the Categories,
b) select it,
c) click Insert.
You can also double-click the SmartName.
Tip:
• You can type the first letters of the SmartName you are looking for to show it in the list.
• The dialog closes automatically after inserting a SmartName. To keep it open (to insert more
SmartNames), hold Alt while clicking the Insert button or double-clicking a SmartName.
• If there are several SmartName-enabled text fields (in a ticket for example), keep the Insert
SmartNames dialog open and just click on the next SmartName-enabled field to insert
SmartNames in it.
• You can choose a smartname as Folder of first input of master workflow from Task
information or Name of folder of originating input of (enclosing) workflow from Workflow
context to keep the names of folders from the original input for the output
78
Automation Engine
6
1. In the Pilot, select the Files view from the Views bar (or use Go > Files).
2. In the Containers mode, browse to your chosen file.
3. Right-click it, and select either:
• New Task to fill in the ticket's settings before launching the task.
• Launch with to launch the task without changing the ticket's settings.
Note:
If you don't have the Tickets: Show All Tickets and their Parameters (Public and other) access
right (see Access Rights in the Reference Guide), you will only see Launch with.
In this case, you can only select public tickets, and only fill in public parameters in the ticket.
• If you have launched tasks previously, the most recent task tickets you used are listed.
79
6 Automation Engine
Note: This dialog contains all the tickets suitable for the file type you selected. You can choose
either a Default ticket, or a custom ticket (saved under a different name) if you have already
created one.
5. If:
• You chose New Task, the task ticket opens. Fill in the settings you want to use in the ticket
and click the Launch button.
80
Automation Engine
6
• You chose Launch with and you have the Tickets: Show All Tickets and their Parameters
(Public and other) access right, the task is launched on the file as soon as you selected the
ticket. You don't need to fill in any settings.
• You chose Launch with and you don't have the Tickets: Show All Tickets and their
Parameters (Public and other) access right, the task is launched on the file as soon as you
selected the ticket if there are no public parameters.
If the ticket contains public parameters, it will open for you to fill them in (you will only see the
public parameters). Click Launch when you are done.
81
6 Automation Engine
Note: For a description of all of the ticket's settings for each task, see The Tasks: an Overview
in the Reference Guide.
You can monitor the task's progress in the Files View's Task pane or in the Tasks View. See Check
the Status of the Task.
You can see the progress (in percentage) and the processing state. The state can be:
• : starting
82
Automation Engine
6
•
: success
•
: warning
•
: failure
•
: processing cancelled
If you click on the
You can also double-click the task entry in the Tasks pane to open your task ticket and check its
parameters.
Note: Depending on your access rights, you may only see the public parameters.
83
7 Automation Engine
The workflow editor window only contains two steps by default ( and ).
2. Drag and drop your chosen steps from the workflow step list into the canvas.
Note: To find a step quickly, you can either use the step filter or the search field on top of the
steps list.
84
Automation Engine
7
You will still be able to see the original name (the task type or workflow control type) by hovering
on the step.
Note: You can connect a step’s output to several other steps. Automation Engine will
automatically check the format of the files going through, and send them to the appropriate step(s)
depending on it.
85
7 Automation Engine
Tip: If you want to align your workflow steps on a grid, hold Shift while dragging them.
5. Double-click each step and fill in its parameters in the step ticket.
86
Automation Engine
7
87
7 Automation Engine
Click the tickets button in the workflow editor’s toolbar to open the Ticket Browser pop-
up.
3. Select the custom ticket you want to use and:
Do... to...
drag the ticket into your workflow use a copy of the original ticket.
hold Ctrl + Shift (on PC or Mac) or Cmd + Alt link the original ticket to your workflow (you
(on Mac only) and drag it into your workflow can see an arrow next to the ticket name).
Note: You can connect a step’s output to several other steps. Automation Engine will
automatically check the format of the files going through, and send them to the appropriate step(s)
depending on it.
88
Automation Engine
7
Tip:
If you want to reuse part of an existing workflow, you can copy and paste it into your new workflow
(using Ctrl + C and Ctrl + V or Edit > Copy and Edit > Paste). This keeps all of the steps’ settings.
You can also use nested workflows if you plan to reuse workflow parts several times (see Nested
Workflows).
Important: You cannot automatically convert task chain tickets to workflow tickets, but you can
preserve all your settings while migrating to workflow tickets.
1. In the Pilot’s Tickets view, search for the task chain ticket you want to convert.
2. Open the workflow editor.
3. Drag and drop your task chain ticket into the workflow editor window.
89
7 Automation Engine
Tip: When dragging the ticket over the canvas, you will see a message telling you where to drop it.
This shows all the steps of your task chain in the canvas.
90
Automation Engine
7
Note:
• Each step keeps all of its settings in its own ticket (you can double-click on a step to see its
ticket).
• The steps are detached so you can optimize your workflow construction (the workflow editor
enables you to build workflows in a more flexible and more efficient way than the task chains).
•
Deprecated steps (as the Mark File step in the example below) will be displayed in red
for three seconds, then disappear. You should replace them with the corresponding workflow
controls (for example, replace Mark File by Mark). See Workflow Controls and Deprecated
Steps.
91
7 Automation Engine
92
Automation Engine
7
5. Save your workflow.
93
7 Automation Engine
94
Automation Engine
7
95
7 Automation Engine
96
Automation Engine
7
1.
In the workflow editor, drag the Workflow step into your workflow.
97
7 Automation Engine
98
Automation Engine
7
99
7 Automation Engine
Note: When a step’s output pin is connected to several other steps, Automation Engine will
automatically check the format of the files going through, and send them to the appropriate step(s)
depending on it.
100
Automation Engine
7
In the main workflow, you can see that they correspond to the two green output pins of the workflow
step.
• files sent to the One Up step of your subworkflow will go through the One Up output in your main
workflow (on to the Zip One Up step),
• files sent to the S & R step of your subworkflow will go through the S & R output in your main
workflow (on to the Print S & R step).
Operator Routing
You can build your workflow so that operators will route your files based on their expertise.
They will get a notification, and the processing will be paused until they decide where to send the file.
To use this in your workflow:
1.
101
7 Automation Engine
• choose one of the predefined due dates (from Immediate to Next sunday),
• choose Other... in the Due date list and pick the due date yourself.
5. In Output states, define the output possibilities you want for your checkpoint.
By default, this step has two outputs: Completed and Aborted.
To add an output:
102
Automation Engine
7
a) Click Add
b) Enter the output’s name
Add as many outputs as you like.
6. If necessary, use the Move Up and Move Down buttons to display your outputs in a different order.
Note: You can Remove the default outputs if you don’t need them.
7. If you want your file to be automatically sent through one of the outputs if no action is taken by
the operator after a period of time:
a) Select Release automatically
b) Enter the time delay after which the file should be released
c) Choose the output to release the file to
103
7 Automation Engine
Operators will be able to route files gone through the Checkpoint from the Pilot’s Tasks pane, the
workflow editor, or Shuttle.
In the Pilot
In the Pilot, the operator will see User intervention needed in the Tasks list, and one To-Do .
He/she can:
• Click either of these elements to route the file to one of the outputs defined in the Checkpoint
step (and close the To-Do).
104
Automation Engine
7
• Right-click the file icon and select one of the outputs defined in the Checkpoint step.
• or...
a) right-click the file icon and select Open To-Do...
b) select one of the outputs defined in the Checkpoint step.
• or...
105
7 Automation Engine
a)
click the To-Do icon ,
b) select Checkpoint Actions in the Actions Filter list,
c) select one of the outputs defined in the Checkpoint step.
In Shuttle
Note:
The user name you used in the Checkpoint step settings and the user name your operator uses in
Shuttle (to connect to Automation Engine) must match.
If they don’t, your operator can still see the file(s) to route, but only in Shuttle’s Show All mode
( ).
For more details, please see the Shuttle manual.
In the Shuttle window, the operator will see an icon ( ) indicating that the file needs attention.
Note: This icon is not on the workflow level, but at the Checkpoint step level. Clicking shows
the workflow steps.
The Inspector panel also shows an attention icon, and the notification defined in the Checkpoint
step.
To route the file (and close the To-Do in Automation Engine), the operator can:
106
Automation Engine
7
This shows the notification and output states set in the Checkpoint step.
b) Select one of the output states to route the file.
• In the Inspector panel:
a) Select the step in the processing list to show the notification set in the Checkpoint step.
b)
Click and select one of the output states to route the file.
Automatic Routing
You can use the Router workflow control to route your files automatically.
In the Router’s settings, you can choose to automatically route your files based on certain criteria
(the file type, the number of separations, the value of a job parameter...).
Files matching your chosen criteria will automatically be sent through the corresponding output.
107
7 Automation Engine
... and send each file type to a different step in the workflow.
108
Automation Engine
7
In the example above, ArtPro files and PDF files are each routed to their own normalization step,
while Normalized PDF files are sent directly to the Trap step.
For more information about the routing criteria, please see the Automation Engine Reference Manual.
• Allow the user to set the value if you want Shuttle users to be able to freely enter a value
for that parameter.
109
7 Automation Engine
• Let the user select a predefined value if you want Shuttle users to choose from a list of
values that you define.
If that parameter already has a list of values to choose from in the Ticket, they will be
displayed here. You can Add or Remove values.
Note: Shuttle operators will see (and choose from) the Predefined Settings but not the
associated Values.
c) If you have chosen Let the user select a predefined value: in Default Predefined Setting,
choose the setting that will be selected by default when submitting files from Shuttle (if the
operator doesn’t select another setting, this one will be used for processing).
4. Don’t forget to save your ticket.
110
Automation Engine
7
If you chose Allow the user to set the value If you chose Let the user select a predefined
value
111
7 Automation Engine
The right pane shows the workflow steps for which you have made parameters public.
The middle pane shows the public parameters for the selected workflow step.
The left pane shows all the parameters you have made public, with their settings (predefined
values, etc.).
2. You can:
112
Automation Engine
7
• drag parameters from right to left to make them public;
•
click a public parameter’s cross if you don’t want it to be public anymore;
• rearrange the order of your public parameters (drag them up or down);
• change public parameters’ settings (Prompt as, Predefined Settings, etc.);
•
group public parameters under a header (click Add Group, click to edit the header, and
drag parameters from the right);
• use presets to simplify operators’ choices (see Using Presets to Simplify Operators’ Choices).
113
7 Automation Engine
For example, you want operators to use different trapping settings for printing with offset or dry
offset. You can define those trapping settings in a preset, so that operators will only have to choose
between offset and dry offset.
In the Manage Public Parameters dialog:
3. Drag parameters from the dialog’s left pane into the preset.
You can drag as many parameters as you want. They will appear under each value (here both
under Offset and Dry Offset).
114
Automation Engine
7
115
7 Automation Engine
The right pane shows the workflow steps containing public parameters, and the left pane shows
the parameter values.
2. Check and edit the values if necessary, and click OK.
•
Select your ticket in the Ticket view, click and select Public.
116
Automation Engine
7
• Right-click your ticket in the Ticket view and select Public Ticket.
117
7 Automation Engine
To enter text, click and enter your text. When you are done, click .
You can move the sticky note on the workflow canvas, or resize it by dragging its bottom right corner.
118
Automation Engine
7
When saving your workflow, all of its sticky notes are saved with it.
1. Right-click any workflow step (task or workflow control) and select Show Parameter Inspector...
2. The left column shows all of the workflow steps in alphabetical order. Click the task / workflow
control whose parameter you want to see.
The parameters are shown at right.
3. Change the parameters as you wish.
Your changes are applied instantly in the workflow.
4. If you want, you can also:
• Save the parameters of the task you just edited as a new ticket (using Save As...).
• Edit that task's public parameters (using Manage Public Parameters...).
See Using Public Parameters on page 69 for details on how to use public parameters.
5. Close the Parameter Inspector when you are done.
119
7 Automation Engine
1. In the Files view, right-click the file(s) to process and select either:
Note:
If you don't have the Tickets: Show All Tickets and their Parameters (Public and other) access
right (see Access Rights in the Reference Guide), you will only see Launch with.
In this case, you can only select public workflow tickets, and only fill in public parameters for
the workflow.
• If you have launched workflows previously, the most recent workflow tickets you used are
listed under Workflow.
120
Automation Engine
7
Tip: Workflow tickets have Workflow as task type. You can use the search field in the Select
Ticket dialog to find them easily.
3. If:
• You chose New Task, the workflow editor window opens. Fill in the settings you want to use
Tip: Hold Alt while clicking Launch to keep the workflow editor window open to monitor your
121
7 Automation Engine
You can monitor the workflow's progress in the Files View's Task pane or in the Tasks View. See
Checking the Workflow's Processing Status on page 124.
Note: If you send files linked to several jobs to the same workflow at the same time (for example
when using the Files view and Shuttle or a Hot Folder), a separate workflow will be started for each
job context.
1. In the Files view, select the file(s) you want to launch your workflow on.
2.
122
Automation Engine
7
Note: You can see your file(s) in the files pane of the workflow editor window.
3. Build your workflow as described previously (see Building a Workflow from Zero, Building a
Workflow using Custom Tickets, Reusing a Task Chain Ticket to Build a Workflow, Building a
Nested Workflow).
Note:
Save your workflow if you want to be able to reuse it later.
Any settings change you make after saving your workflow will only be used on this file and not
saved in the ticket.
4.
Tip: Hold Alt while clicking Launch to keep the workflow editor window open to monitor your
•
click to pause your workflow (at the end of the task currently running),
•
click to make your workflow run again,
•
click to cancel your workflow’s processing.
123
7 Automation Engine
You can see the progress (in percentage) and the processing state. The state can be:
• : starting
•
: success
•
: warning
•
: failure
•
: processing cancelled
124
Automation Engine
7
You can see your file(s) going from task to task, with the status displayed in blue.
Note: The file icon can represent a single file or a collection of related files, depending on your
workflow step’s output.
Each task or workflow control indicates the number of files ran successfully (in green) or with an
error (in red) through it.
125
7 Automation Engine
2. In the workflow editor window, double-click the task(s) you want to edit and change the settings
as necessary.
Note: Save the workflow if you want to keep the new settings in the ticket.
3.
Click Launch .
126
Automation Engine
8
127
8 Automation Engine
Note: If the the user access right for deep zoom is not enabled (read more here Defining User Access
Rights )while defining user rights:
• you can only view prepared files
• your zoom is restricted.
You can now zoom in on the file, measure distances and densities, view separations individually or
together, etc.
128
Automation Engine
8
129
8 Automation Engine
3: View both - highlight the difference: the differences between the two files is highlighted in red.
Right-click this button to see the other options for compare that are available.
While comparing you can also use other tools like for example "view separations in separate
windows", measure, (de)select, rotate, etc...
1: Show channels (Automatic tiling) - Right-click this button to see the other options that are available
to see the different channels.
130
Automation Engine
9
Note: Alternatively, you can set up a WebCenter Project with Approvers in WebCenter, and send
your impositions to it from Automation Engine. But then you will only be able to create new Projects
from WebCenter and not from Automation Engine.
• To make another user or user group the Project Manager for this project, select his or her
name, or the group name, from the Project Manager list.
• If desired, enter a description in the Description field.
• To make the Project active, set the Status as Active.
131
9 Automation Engine
• To specify an optional due date, click the calendar control at the end of the Due On field and
select the desired due date. To set the due time, click the drop-down list box to the right of
the calendar control.
Note: This is not the Approval Due Date. You will set the Approval Due Date when setting
the Approval Cycle.
• To use a custom thumbnail, click Change and enter the complete path and filename in the
associated field or Browse for it. To use the default thumbnail, leave that choice selected.
132
Automation Engine
9
3. Set the members’ permissions as desired. For Approval tasks, members need at least View
permissions (selected by default).
Note: The permissions you set here apply to all members you have just added.
4. Click Finish.
5. Once the members are added, click Go back to the project.
Note: You can only change (add or remove) Approvers when the Approval Cycle is stopped.
133
9 Automation Engine
Note: The Project Manager is not automatically made an Approval User and must be explicitly
added to the list of Approvers.
134
Automation Engine
9
3. Enter the Template Name (different from your Project Name) and a Description.
To use a custom thumbnail, click Specify New Thumbnail and enter the complete path and
filename in the associated field or Browse for it. To use the default thumbnail, leave that choice
selected.
4. Click Finish.
The Template is created.
135
9 Automation Engine
Note: You can use the Open button to open your WebCenter website.
5. Check if your Webcenter and your Automation Engine servers are on the same Local Area
Network:
• If they are, enable Webcenter and Automation Engine are in the same LAN,
Note: Your Webcenter and Automation Engine servers must be on the same Local Area
Network to be able to use the page list approval feature in WebCenter.
• If they are not, enter the Automation Engine Approval Client’s Name and Password.
Note: The Name and Password you enter here must match the Workflow Approval Client’s
Name and Password specified in WebCenter by the WebCenter administrator.
6. Use the Check Connection button to check that your Automation Engine server is now connected
to your Webcenter server.
7. In the left panel, select the WebCenter connection you have just set up and click on it to rename
it. You can also use File > Rename or F12 (on Windows).
8. Go to File > Save to save your WebCenter connection. You can also use Ctrl + S on Windows
or Command + S on Mac.
136
Automation Engine
9
Note: To remove a WebCenter connection, select it in the left panel and go to File > Delete or
use the Delete key.
2. Right-click it and select Add to Imposition Gallery from the context menu.
When you switch to the Pages view, you can see your file in the Imposition Gallery.
3. If the imposition doesn’t show the pages preview (as in the example above), add them this way:
a) Click on the first page’s file name in the Page Gallery. This shows the page’s preview in the
Details area at right.
b) Drag this preview onto the first page of the imposition in the Page list area.
c) Repeat this for the other pages of your imposition.
137
9 Automation Engine
1. In the Imposition Gallery, right-click the imposition (or the book) and select New Task > Prepare
Imposition for WebCenter Workflow.
If the Prepare Imposition for WebCenter Workflow task does not appear in the context menu,
choose More Tickets and select the task in the Select Ticket dialog.
2. Modify the settings of the Prepare Imposition for WebCenter step (the first step in the chain)
if needed.
3. In the Send Imposition to WebCenter step, modify the settings of the Destination tab (you can
138
Automation Engine
9
Note: You can also send your imposition to a Project already existing in WebCenter. In that
case, you don’t need to enter a Project Template. Note that this Project must have Approvers
defined in WebCenter.
c) If you want to send your imposition to a subfolder in the project, enter that Folder’s name. If
this folder doesn’t exist in the template (or project), Automation Engine will create it.
d) Enter the name to give to your imposition Document. This is the name that will be shown in
WebCenter. For example you can use [ImpositionName][BookName][LayerName].
e) Enter the Project Template to use to create your WebCenter project.
Important: This Project Template must be defined in WebCenter. See WebCenter Setup.
f) Enter the User Name and Password used to connect to your WebCenter site. You can use an
Encrypted password or SmartNames.
139
9 Automation Engine
140
Automation Engine
9
5. Click the Launch button in the top left corner to upload the imposition to WebCenter.
Note:
If you don’t start the Approval Cycle from Automation Engine, you will still be able to start it from
WebCenter, and view the approval results in Automation Engine.
For more information, see the WebCenter manual.
Note: Only FastImpose impositions that have been added to the Pages View in Automation Engine
are recognized as Page Lists in WebCenter. Multipage files uploaded from within WebCenter, or from
Odystar, Nexus, or even other Automation Engine documents will never be treated as Page Lists.
Instead, they are considered regular multipage PDF documents.
141
9 Automation Engine
Note:
For more information about Forced Approval or Rejection, see the WebCenter manual.
Approving a Document
Documents waiting for your approval are shown on My To Do List under My Work. If you are an
Approval User, do the following to Approve or Reject a document:
Note:
You can also approve or reject documents in the Viewer.
1. Click Approve/Reject at the end of the Approval field in the document header.
2. Choose the desired Approval Status from the drop-down list: Approved indicates approval;
Pending indicates future Approval or Rejection, and Rejected indicates disapproval.
3. Once you choose Approved or Rejected, you may not change the status later; a view-only version
of the page will be shown showing the choice you picked. Only a Pending status allows future
changes.
If desired, you can add a comment in the Comment field. Submitted approvals and comments
are shown on the Action History page.
4. Click Finish to change the status of the document.
To cancel the changes, navigate to another page without clicking Finish.
142
Automation Engine
9
Page Lists are uploaded from a Automation Engine production server using the Pages View in the
Automation Engine Pilot.
Note: Only FastImpose impositions that have been added to the Pages View in Automation Engine
are recognized as Page Lists in WebCenter. Multipage files uploaded from within WebCenter, or from
Odystar, Nexus, or even other Automation Engine documents will never be treated as Page Lists.
Instead, they are considered regular multipage PDF documents.
Page List documents have two major advantages over other multipage PDF files:
• You can upload either the complete document, or specific pages only (for example, pages 6-12);
• individual pages can be approved or rejected in WebCenter (for example, you can approve
pages 3, 5 and 7-16 of a 16-page Page List).
143
9 Automation Engine
c) Enter your comments, provide your password if required and click Commit.
Note: You can approve / reject one page at a time, or all of the document’s pages (using
Apply to all pages).
• Use the Page Gallery view:
a) In the Project, click on the Page List’s name.
The Document Details page appears.
b) Select Page Gallery from the menu.
c) Select the pages you want to approve and then click Approve/Reject. You can also use
Approve/Reject all Pages.
d) Enter your comments, provide your password if required and click Commit.
144
Automation Engine
9
• Use the Page List view:
a) In the Project, click on the Page List’s name.
The Document Details page appears.
b) Select Page List from the menu.
c) Select the pages you want to approve and then select Approve/Reject from the gearbox menu.
You can also use Approve/Reject all Pages.
d) Enter your comments, provide your password if required and click Commit.
• Use the Approve/Reject link on the Document properties page to approve all the pages at once.
145
9 Automation Engine
a) Enter your comments, provide your password if required and click Commit.
146
Automation Engine
9
Note:
When you try to expose a sheet that contains a rejected page, you will get an error in the
Expose task and an error status in the Plates View.
If you really need to expose the sheet anyway, you can overrule the WebCenter approval status
from Automation Engine (see Overruling the WebCenter Approval).
Important: You need to first set up the WebCenter View before you can view all the approved /
rejected documents in the WebCenter project you created.
Important: Make sure this matches the Project Name of the project you created (or used) when
sending your imposition from Automation Engine to WebCenter. See Sending the Imposition to
WebCenter.
5. To check that the information you entered is correct and that the WebCenter server is running,
click the Retry Connection button at the bottom of the view.
You can also use the link at the top of the view to open the web page of the WebCenter project.
6. Once you have checked that your configuration is correct, use the Save to Configuration button
to save it.
147
9 Automation Engine
Once it is saved, you will be able to return to this configuration using the Load from Configuration
button after any unwanted change.
7. Click the Show Documents button to view the documents in your WebCenter project.
148
Automation Engine
9
Note: If at least one page of the imposition is rejected, the status of the whole imposition is Rejected.
the page and the original imposition layout have been approved by all
approvers.
Note: The imposition layout can be approved even if some of its pages are
rejected.
the page has been approved by all approvers, but it may have changed the
imposition layout, which needs to be checked (for example for a new page
replacing a rejected one).
the page or the whole imposition has been rejected by at least one approver.
149
9 Automation Engine
When you hover on the top of a page in the Pages or Proofs View, you can see:
• the approval status,
• any comment entered,
• the date and time of the approval,
• the WebCenter user who approved/rejected the page.
1. In Automation Engine Pilot, go to either the Pages or the Proofs View and locate your imposition
document.
2. You can either:
Select a page of your document and use the and buttons in the View’s toolbar
to approve/reject the document without entering a comment.
• Right-click on a page of your document and choose Approve/Reject... to open the Approve/
Reject dialog where you can enter a comment.
3. In the Approve/Reject dialog, select Manual as Approval Type.
150
Automation Engine
9
4. Choose to either:
• Approve,
• Approve with warning,
• Reject the document.
5. Enter a Comment if you wish and click OK.
Note: You can hover on the top of a page to view approval information, whether it has been approved/
rejected automatically in WebCenter, or manually in Automation Engine.
151
9 Automation Engine
Any public parameters that have been defined in the Nexus workflow (NeXML) will show up on the
Send to Nexus ticket in Automation Engine. In addition, these public parameters are SmartName-
enabled, so you can use Job metadata to drive the Nexus workflows.
On the Nexus side the Copy to BackStage activity allows you to set up workflows that send their
resulting files back to Automation Engine.
Behind the scenes, Automation Engine and Nexus communicate via the SOAP protocol, exchanging
files and notifying each of other of their progress.
NeXML
Setting up public parameters in Nexus requires knowledge of NeXML. Please refer to the NeXML
Manual for more information.
• If the Nexus server runs on a Windows OS, the container should be mapped to a drive letter on
the operating system.
• If the Nexus server runs on a Mac OS, the container has to be mounted over the SMB protocol.
Note:
The option User Management, which determines the workflows that a particular user can
access, is ignored by the Automation Engine Pilot. As a result, Automation Engine Pilot operators
automatically have access to all Nexus workflows.
3. Create valid Nexus workflows with the Input Type: Hot Folder.
4. Configure the Hot Folder queues for the workflows. Make sure the option Show in Shuttle is
selected.
Only Hot Folders that have Show in Shuttle enabled are published to the Nexus SOAP server and
become accessible to the Automation Engine Pilot.
5. Create the workflows with the Nexus Workflow Editor.
6. Make sure you add the Copy to BackStage activity at the end of the workflow.
152
Automation Engine
9
Your Nexus workflow is now available for use with the Automation Engine Pilot.
Note: You can also test whether the Nexus SoapServer is online by browsing to the following url in
your favorite web browser: http://NexusServerName:5182.
153
9 Automation Engine
Note: You can also manage your Nexus workflow's public parameters (not one by one but as a
group) in your task ticket. See Managing Public Parameters in Your Ticket.
• select One Single Task to send all the files to a single workflow in Nexus.
• select Separate Tasks to launch a separate Nexus workflow for every selected file.
5. Provide the required public parameters for the different activities in the workflow.
Note: You can use SmartNames in all the public parameter fields.
154
Automation Engine
9
The Send to Nexus task appears in the Task List, where you can see the progress of the Nexus
workflow. Note that progress is not displayed in real time.
The processed files from Nexus are returned to Automation Engine as the output of the Send to
Nexus task. In other words, you can include Send to Nexus as a step into a more complete workflow.
Note: In order to jump from the Nexus Manager 9.0 to the Automation Engine Pilot, you must
connect to Nexus Manager with a blank user name and the password awsnexus.
Example
• The Automation Engine workflow (top) sends the files to Odystar for additional processing before
outputting them to a proofer.
• The Odystar workflow (bottom) applies PrePress changes to the files before copying them back
to Automation Engine, where they go through the rest of the workflow (Proof step).
155
9 Automation Engine
Note:
Odystar accepts Normalized PDF files as input, but its changes may render the files non-Normalized.
We suggest that you do either (or both) of the following:
• send regular (not Normalized) PDFs to Odystar (add an Export to PDF File step before Send to
Odystar),
• re-normalize the files you get back from Odystar (add a Normalize PostScript / PDF / Illustrator
8.0 File step after Send to Odystar).
156
Automation Engine
9
Note: Make sure you have Read and Write permissions for those mounted volumes from your
Odystar server machine.
Note: By default this is port 5182, but if this port is already used by other processes, you should
enter the next available port.
157
9 Automation Engine
7. Make sure you add a Copy File gateway, with the Copy Back To Automation Engine mode
selected, at the end of your workflow.
158
Automation Engine
9
Your Odystar workflow is now available for use from the Automation Engine Pilot.
159
9 Automation Engine
Note: You can also test whether the Odystar Hub is online by browsing to the following url in your
favorite web browser: http://OdystarServerNameorAddress:5182.
Tip: If you can’t see the workflow you are looking for, use the refresh button .
• indicate whether you want to launch a new, separate workflow in Odystar for every file you
select in the Pilot (Separate Tasks), or whether you want to send all the selected files to one
Odystar workflow (One Single Task).
• the bottom section of the ticket dialog contains fields for the public parameters for the workflow
you selected. These parameters can be different for every Odystar workflow (they are defined in
the Inspector).
Note: You can also manage your Odystar workflow’s public parameters (not one by one but as
a group) in your task ticket. See Managing Public Parameters in Your Ticket.
160
Automation Engine
9
161
9 Automation Engine
Note: You can use SmartNames in all the public parameter fields.
The Send to Odystar task appears in the Task List, where you can see the progress of the Odystar
workflow. Note that progress is not displayed in real time.
Note: The files processed by Odystar are returned to Automation Engine as the output of the Send
to Odystar task (or as the output of the Send to Odystar workflow step when including the Send to
Odystar ticket in an Automation Engine workflow - see the workflow example).
• Prepare Graphics for Nesting, to extract graphics contours from graphic files using a cut path.
• Add Parameters for Nesting, to specify nesting parameters for a particular graphic.
• Create Nested Layouts, to nest a set of graphics onto one or more sheets, and create production
files.
• Create Tiles, tile very big graphics into smaller graphics to be printed.
See the Reference Guide for a detailed explanation of the tasks' parameters.
162
Automation Engine
9
3. In the Add Parameters for Nesting task, the graphics are set to be repeated to fill the sheet (with
the Maximum fill option).
4. The Data Collector makes sure the graphics arrive to the Create Nested Layout task all at once,
so they are combined in same set of sheets.
5. The Create Nested Layout task creates the nesting on the substrate and with the parameters you
define (margins, fill starting point, gutter, etc.).
6. The production files (print files and cut files), and if desired a nesting report, are created and sent
to the location you define.
Tip:
If the Minimum Fill on the sheet isn't reached on the due date, you can for example send the
remaining graphics to another Create Nested Layout task with a lower minimum fill percentage (or
see Create Nested Layout in the Reference Guide for more options).
163
9 Automation Engine
1. Go to Tools > Configure and set up the connection to PitStop (see Preflight Tools in the Reference
Guide for more details).
2. Launch the Preflight via External Application task on your file (see Preflight via External
Application in the Reference Guide for more details).
164
Automation Engine
9
165
9 Automation Engine
Note: In the Error area of the ticket, you can define an amount of time after which the external
processing should be considered as failed. To do this, enable the option Error when no result after ...
and define a time period (for example, you could enter one hour, a number of days, or even a specific
date).
166
Automation Engine
9
4. In the Select Folder dialog, browse to the folder you want to turn into a Hot Folder (or create a
Note: You cannot select folders that are already Hot Folders ( ).
5. In the New Hot Folder dialog, select an Output Folder (where Automation Engine will write the
processing result).
167
9 Automation Engine
6. Click OK.
The JDF Hot Folder is now listed in the Pilot’s Hot Folder View.
168
Automation Engine
10
Overview
Normalized PDF differs from regular PDF 1.6 in the following areas:
• External references
• Color space
• Document level metadata
• Object level metadata
External references
A Normalized PDF is not always self-contained. It can refer to images or other PDFs that are not
embedded in the PDF itself. Making use of references instead of embedding images and/or graphics
can have several advantages in the workflow. The main advantage is that it allows for “late binding”
e.g. an image can be color corrected. After the color correction all PDFs that refer to this image
will automatically contain the corrected version of the image without the need to open and rewrite
169
10 Automation Engine
all those PDFs. Working with Normalized PDFs with external referenced can also lead to faster
processing especially when the Normalized PDF refers to large amounts of external image data.
Although referring to external files is a standard PDF feature (e.g. used in the PDF/X-5), most
PDF applications do not support this. To guarantee that a PDF can be processed correctly by
PDF application (like Adobe Acrobat) it has to be made self-contained (embedding all the referred
components like images). A self-contained Normalized PDF is 100% PDF compatible.
Color space
A Normalized PDF can only contain objects in the final printing color space. This final printing color
space can have any number of separations but in most cases this will be CMYK and some spot
colors. The PDF object model allows objects to be defined in RGB and CIE based color spaces. This
is not possible in Normalized PDF. During normalization such objects are color converted to CMYK.
The fact that Normalized PDF can’t contain objects in RGB or CIE based color spaces its biggest
limitation. On the positive side it makes the workflow more predictable. It avoids late and often
somewhat hidden color conversions e.g. in the RIP that can lead to problems in printing.
170
Automation Engine
10
Normalized PDF Tasks PDF Tasks
Enrich Black Resize PDF for Output
Export to 3D Resolve OPI
Export to ArtPro File Split Pages
Export to EPS/DCS File Version PDF
Export to PDF File
Export to PostScript File
Export to VRML File
FastVariants (all tasks)
Optimize and Clean (PSFix)
Outline Fonts
PowerTrapper
Prepare Station
RIP (all tasks)
Step & Repeat (all tasks)
Trap (all tasks)
171
10 Automation Engine
The ticket used for Automatic Normalization can be configured using the Configure window in the
Automation Engine Pilot (choose Tools > Configure and navigate to Processing Preferences >
Automatic Normalization ).
172
Automation Engine
10
173
10 Automation Engine
Output formats
Depending on your choice in the Output Format list of the Step & Repeat ticket, the format of the
resulting document can be:
• PDFPLA
• a self-contained Normalized PDF
• a regular PDF
174
Automation Engine
10
PDFPLA
When you choose this option, the output of the step and repeat task will be a PDFPLA file. A PDFPLA
is a Normalized PDF with external references to the 1-ups. It can be loaded and modified in Plato.
It can be RIPped directly by FlexRip. To send it to a non-Esko system, the PDFPLA needs to be
exported to a PDF using the Export PDF task.
Note:
PDFPLA output can only be generated if all the inputs are Normalized PDFs. The task will fail if a 1-
up at the input is not normalized on beforehand.
This format is the recommended output format when the primary purpose of the step and repeat
file is to send it to FlexRip.
175
10 Automation Engine
This format is recommended when further processing is needed on the output, for example by
the Optimize PDF Separations task before sending it to FlexRip.
PDF
When you choose this option, the output of the step and repeat task is a PDF. The 1-ups are
embedded in the PDF using PDF forms so that the file size remains compact. The file can not be
modified in Plato. FlexRip can not RIP this file directly: it will first automatically normalize the step
and repeat file. The file can be sent to a non Esko system.
Normalized PDF inputs will be embedded in the output. PDF inputs will be embedded in the PDF
“as is”.
This format is recommended when the primary purpose of the step and repeat file is to send it
to a third-party, non-Esko RIP.
176
Automation Engine
11
11. Scripting
You can write Scripts (small programs) to automate the execution of certain tasks during a workflow.
Writing and using such scripts is called scripting. You need the Script Runner application to link
scripting with your Automation Engine workflows. You can automate actions from Adobe applications
(e.g. Illustrator, Photoshop, InDesign) and third party tools (e.g. Alwan) using Scripts.
Some of the instances where scripting is useful are given below:
177
11 Automation Engine
1. The Run Script task sends a request to run the specified script.
2. The Script Runner processes the request accordingly and runs the script.
3. The Script Runner sends the results back to the server.
4. The workflow will continue with the outputs from this task.
1. Download Automation Engine Script runner. You can download it via the web access to the
Automation Engine Server. Client Apps > Tools .
178
Automation Engine
11
• On Mac OS, open the ‘dmg’ file after downloading the Script Runner which contains the
installer package. Double-click to start the installation.
• On Windows, double-click the downloaded installer to start the installation.
2. Install the Script Runner by following the instructions in the Installshield Wizard/Assistant and
make sure it is running in your computer.
• On Windows, open Start > All Programs > Esko > Automation Engine Script Runner >
Preferences .
• On Mac OS, open Applications > Automation Engine Script Runner > Esko > Automation
Engine Script Runner > Script Runner Preferences .
179
11 Automation Engine
• You can store the scripts on your computer on a default folder(specific for script type). This is
ideal when you are developing and testing a script or when you do not intend to give access
to other Script Runners on the network.
• Alternatively, you can store your scripts in the Automation Engine data folder. This option is
suitable when you want to make your scripts available to all configured Script Runners.
5. Run the Script using Run Script task in a workflow. Read more about this in Run Script.
180
Automation Engine
11
Please read Getting Started with Scripting before conducting the steps below.
In this example, we are demonstrating a script which will perform a Photoshop action
and produce a JPEG output. The script 'EskoPSDoActionAndSaveasJPG.jsx' is available
from the sample scripts subfolder (ExtendScript) in /Library/Scripts/Esko on Mac or C:\Esko
\bg_data_fastserverscrrunnt_v100\Scripts on Windows.
1. You have to save the Set and Action in Photoshop . In this example we are using Default Actions
as Set and Molten Lead as Action.
2. You can open the script with ExtendScript Toolkit to edit the script if required. However, in this
sample, we do not need to edit the script.
181
11 Automation Engine
a) Run on: is the name of the computer where your Automation Engine ScriptRunner is installed.
The name in this example is ShaletMac. You can read more about configuring and naming
Script Runner in Scripts
b) Script Type: choose ExtendScript.
c) Script File: choose EskoPSDoActionAndSaveasJPG.jsx.
d) Script Parameters: Add the name of your Photoshop Action name followed by your Set . In
this example, Molten Lead; Default Actions
e) Save the task.
4. Launch the task:
a) Select the Photoshop file.
b) Right-click the file and browse for the ticket.
c) Click Launch.
You will see that while the script starts to run on the Automation Engine Server, PhotoShop opens,
performs the actions, closes and continues the script. The result of this sample script is finally
an adjusted jpeg.
182
Automation Engine
12
Note: You can find more info on this in the corresponding chapters of the User Guide.
You can import populated or unpopulated impositions from applications that produces JDF layout
file as its output. Some of the applications that can write a JDF Layout file are Kodak Preps, Litho
Technics Metrix, Ultimate ImpoStrip , Dynagram Inpo2 , Dynagram Dynastrip, Plato and Pandora.
183
12 Automation Engine
It is possible to separate the creation of a RunList and the creation of an Imposition from that Runlist
in time. In some cases printers prefer to let the RunList be approved and corrected before they select
the layout and create the Imposition.
You can achieve this by using two workflows.
Read more about the new importing and creating tasks in the Reference Guide:
Create Imposition from JDF Layout
Create RunList
Create Imposition from RunList
General Remarks
Note: Thumbnails in the Pages and Plates views are only shown when the pages in the files contain
thumbnails. If you have no thumbnails in your PDF files, you can speed up the system.You can also
save some screen space by hiding the details pane and by switching to list mode.
184
Automation Engine
12
You can send an Impostition or part of an Imposition to a PDF Rip (e.g. Nexus Rip) using Export
Imposition to PDF task. The output will be a PDF file containing the Imposition.
Read more about Convert Selection task in Convert Selection the Reference Guide.
185
13 Automation Engine
Attention: To define the preflight settings for Automation Engine go to Tools > Configure and select
Preflight Tools
1. From Start connect to the Preflight via External Application workflow step.
186
Automation Engine
13
2. Double-click on the workflow step to edit its parameters. For more information go to Preflight via
External Application.
When Preflighting in a workflow, the Preflight via External Application workflow step has four
output pins:
187
13 Automation Engine
Note:
• Preflight OK: your files will go through this pin if the preflight gave an OK status.
• Preflight with Warnings: your files will go through this pin if the preflight gave a warning.
• Preflight with Errors: your files will go through this pin if the preflight gave an error.
• Error: your files will go through this pin in case of a processing error unrelated to the preflight
status.
3. Connect each pin to the appropriate workflow step (for example, files which are “OK” or “Warning”
can be normalized depending on your preflight setup, while files with “Error” need to be checked
by an operator).
(To Do List ), when the Preflight detects an error. The processing will be paused until you decide
whether to approve the file or not, based on the preflight error report.
188
Automation Engine
13
• choose one of the predefined due dates (from Immediate to Next Sunday),
• choose Other... in the Due date list and pick the due date yourself.
5. In Output states, define the output possibilities you want for your checkpoint.
By default, this step has two outputs: Completed and Aborted.
To add an output:
a) click Add,
b) enter the output’s name.
Add as many outputs as you like.
6. If necessary, use the Move Up and Move Down buttons to display your outputs in a different order.
Note: You can Remove the default outputs if you don’t need them.
189
13 Automation Engine
• Transparencies and Layers check the box to import PDF files as in Scope 3 (and lower). All
transparencies and layers will be flattened. If not checked, a normalized PDF file will be created
that contains all typical PDF features (like transparencies and layers).
Workflow overview
190
Automation Engine
13
There are three different Trap tasks;
Trap – Create Trap Layer: This task traps the input file according to the settings specified in the Trap
Color Pairs file associated with the input file. The output of this task is a trapped Normalized PDF file.
This task contains only the output options of the Trap task. All other trapping parameters are stored
in the TCP file located in the same folder as the input file.
Trap – Prepare and Create Trap Layer: this step selects candidate trap color pairs and executes the
trapping. The trapping areas are added in a separate layer on top of the original job.
Trap – Prepare Trap Pairs: This scans through the job and suggests a list of candidate trap color pairs.
Tip:
• To define the name and location of the output file that will be generated, use SmartNames.
• You can send the output file via mail.
• You can use PDF as SoftProof.
Workflow Overview
191
13 Automation Engine
192
Automation Engine
13
Tip: You could add an extra Output state, ”Send to Proof” to the checkpoint, connecting to
Proof(FlexProof) to print HardProof.
Mark
Use this to tag files that you will need to select later in the workflow (with the Select workflow
control). The file will be tagged as "Label" and after approved in Hold for Viewing, the Select will
pickup the original file.
Select
Use this ticket to select files that you have tagged earlier in the workflow (with the Mark
workflow control).
193
13 Automation Engine
194
Automation Engine
13
is used to generate a specific report. For more information about templates, see ReportMaker
Templates.
Tip: You can define the File Name and the, Output location, of the report file that will be generated,
by using SmartNames.
Tip:
• To interact with customers you can also use steps likePublish on Web and Create WebCenter
Project.
Workflow Overview
195
13 Automation Engine
196
Automation Engine
13
• In the Ticket view, right-click your ticket and select Public Ticket.
197
13 Automation Engine
• Allow the user to set the value if you want Shuttle users to be able to freely enter a value
for that parameter.
• Let the user select a predefined value if you want Shuttle users to choose from a list of
values that you define.
If that parameter already has a list of values to choose from in the Ticket, they will be
displayed here. You can Add or Remove values.
Note: Shuttle operators will see (and choose from) the Predefined Settings but not the
associated Values.
c) If you have chosen Let the user select a predefined value: in Default Predefined Setting,
choose the setting that will be selected by default when submitting files from Shuttle (if the
operator doesn’t select another setting, this one will be used for processing).
4. Don’t forget to save your ticket.
198
Automation Engine
13
This is how your public parameter will look to Shuttle operators:
If you chose Allow the user to set the value If you chose Let the user select a predefined
value
199
13 Automation Engine
The left pane shows all parameters that can be made public for that ticket (the ones you have
made public are greyed out).
The right pane shows the parameters you have made public, with their settings (predefined values,
etc.).
200
Automation Engine
13
2. You can:
• drag parameters from left to right to make them public;
•
click a public parameter’s cross if you don’t want it to be public anymore;
• rearrange the order of your public parameters (drag them up or down);
• change public parameters’ settings (Prompt as, Predefined Settings, etc.);
•
group public parameters under a header (click Add Group, click to edit the header, and
drag parameters from the left);
201
13 Automation Engine
For example, you want operators to use different trapping settings for printing with offset or dry
offset. You can define those trapping settings in a preset, so that operators will only have to choose
between offset and dry offset.
In the Manage Public Parameters dialog:
3. Drag parameters from the dialog’s left pane into the preset.
You can drag as many parameters as you want. They will appear under each value (here both
under Offset and Dry Offset).
202
Automation Engine
13
203
13 Automation Engine
204
Automation Engine
13
205
13 Automation Engine
Do this when:
Note: If the file you are launching is already located in an Automation Engine job, it will
automatically be processed within that job’s context (you don’t need to enter the Job ID).
Note:
You can open several Launch windows, and select a different workflow in each.
If you quit and restart Shuttle, your Launch windows will be remembered.
• Drag and drop your file on the Drop Files Here arrow.
• Click the Launch... button and browse to the file you want to launch.
• Go to File > Launch... and browse to the file you want to launch.
• Use Command + S (on Mac).
5. If your workflow has public parameters, you will see a pop-up where you can fill them in.
206
Automation Engine
13
Note:
For more information on public parameters, see:
207
13 Automation Engine
2. Select the workflow you want to launch on your file in the workflow list.
3. If your workflow has public parameters, you can fill them in in the same window.
Note: For more information on public parameters, see Using Public Parameters.
208
Automation Engine
13
Tip:
To access Shuttle easily in the future (without using the menus):
1. Go to Window > Toolbars > Shuttle to open the Shuttle palette.
209