User Guide Version: 8.6.
User Guide Version 8.6.1 Last Revision: 4/12/2017 Objectif Lune, Inc. 2030 Pie-IX, Suite 500 Montréal, QC, Canada, H1V 2C8 +1 (514) 875-5863 www.objectiflune.com All trademarks displayed are the property of their respective owners. © Objectif Lune, Inc. 1994-2017. All rights reserved. No part of this documentation may be reproduced, transmitted or distributed outside of Objectif Lune Inc. by any means whatsoever without the express written permission of Objectif Lune Inc. Inc. Objectif Lune Inc. Inc.
Table of Contents Table of Contents 4 Welcome to PReS Workflow 8.6.
Accessing the Data Repository Where to find the Data Repository About Documents Import Documents Import PrintShop Mail Documents Debugging and Error Handling About Error Handling Using the On Error tab Creating and Using Error Processes Accessing the Logs Resubmit Backed Up Input Files to a Process Knowing What to Resubmit Debugging your PReS Workflow Process The Plug-in Bar Categories Settings & customization About Printing PReS Workflow Printer Queues Shared Printer Queue Properties Windows Output Printer
The Watch Object Data repository API Stopping Execution Special Workflow processes PDF workflow PlanetPress Capture workflow HTTP Server workflow OL Connect Send workflow SOAP Workflow PlanetPress Capture Workflow Database Considerations (ODBC) HTTP Server Workflow PDF Workflow Capture OnTheGo Workflow About Tasks Task Properties Variable Properties Contextual Menu Unknown Tasks Masks Date and Time Format Input Tasks Task Properties Variable Properties Data Splitters Process Logic Tasks Connector Tasks Plan
About Configurations Create a New Configuration Open a PReS Workflow Configuration File Saving and Sending Exit PReS Workflow Configuration Program About Related Programs and Services Available Input Services Available Output Services Start and Stop PReS Workflow Service The Interface Customizing the Workspace Dock and Undock Areas of the Program Window Show or Hide Areas of the Program Window Combine and Attach Areas Resize the Program Window Areas Change the Interface Language PReS Workflow Button Options
PDF Viewer The PReS Workflow Service Console Update document Data Repository Manager Virtual Drive Manager The Debug Information Pane The Message Area Pane The Object Inspector Pane The Plug-in Bar Categories Settings & customization Preferences Other Preferences and Settings General appearance preferences Object Inspector appearance preferences Configuration Components Pane appearance preferences Default Configuration behavior preferences Notification Messages behavior preferences Sample Data behavior pref
Zoom In or Out within Process Area Adding Tasks Adding Branches Edit a Task Replacing Tasks, Conditions or Branches Remove Tasks or Branches Task Properties Dialog Cutting, Copying and Pasting Tasks and Branches Moving a Task or Branch Using Drag-and-Drop Ignoring Tasks and Branches Resize Rows and Columns of the Process Area Selecting Documents in Tasks Links Highlight a Task or Branch Undo a Command Redo a Command The Quick Access Toolbar The PReS Workflow Ribbon The Task Comments Pane Copyright Informati
Welcome to PReS Workflow 8.6.1 This PDF documentation covers version 8.6.1. To view the documentation of previous versions please refer to the PDF files available in the Downloads section of our website: http://www.objectiflune.com/OL/Download/DownloadCenter. Workflow is the heart of all of our solutions. Working in conjunction with PReS Connect, PReS Capture, CaptureOnTheGO, PReS Imaging, PReS Fax, and a variety of plugins, it helps improve your communications processes.
Technical Information that may require specific knowledge to understand. Warning Information that is potentially critical to using PReS Workflow. Pay close attention.
System Requirements These are the system requirements for PReS Workflow 8.6.1. Operating System (64-bit only) l Microsoft Windows 2008/2008 R2 Server l Microsoft Windows 2012/2012 R2 Server l Microsoft Windows Vista l Microsoft Windows 7 l Microsoft Windows 8.1 l Microsoft Windows 10 (Pro and Enterprise versions only) Note Windows XP, Windows 2003 and older versions of Windows are not supported by PReS Workflow.
Basics PReS Workflow is a tool for the automation of the processing, the distribution and the printing of your business documents. Once installed on the server, it can be set up to automate all tasks related to document processing. Setting Up the Working Environment Setting up the working environment has to be done the first time you start PReS Workflow. 1. Defining the printer (see Activate Your Printers). 2. Configure PReS Workflow Services (see Workflow Services).
To add a PReS Workflow startup process: l l In the Ribbon, go to the Home tab and click the Startup Process button in the Processes group. In the Configuration Components pane, right-click on any process or the Processes folder and select Insert Startup Process. Note You can only have one Startup Process in any given configuration and cannot add more. Considerations l l l l l While your configuration is limited to a maximum of 512 processes, any given process can have as many tasks as necessary.
If PReS Workflow service is running when you send a new configuration, it stops and restarts automatically with the new configuration. If the service is stopped, it will not start automatically. To send a Configuration to the local server: 1. Open the configuration you want to use as a new configuration. 2. Edit the configuration, if required. 3. When the configuration is ready to be used, from the PReS Workflow button, choose Send Configuration, then Send Local.
Features PReS Workflow are input driven applications designed to output data in a variety of ways through diverse means to various applications and devices. PReS Workflowcan be used as simple go between, passing along input data to output devices, but it can also perform various types of data processing. You can combine the various PReS Workflow services to set up versatile automated processes to print jobs as well as generate other types of output.
Branches A branch is effectively a doubling of your job file. As your job file goes down the process, when it encounters a branch it will go in that branch, process all tasks up to the output, and return to the main trunk to continue processes. You can have branches within branches, and all branches must have an output. For more information on branches, see Branch. A branch is represented as a crossing . Conditions A condition will either execute the branch it creates or the main trunk, but never both.
Available Resources l Data Mapping Configurations: Displays a list of data mapping configurations used with the Execute Data Mapping task. Each of the templates have been sent from PReS Connect using the Send to Workflow tool. For each template in the list, the following two items appear within them: l l l l l Data Model: Displays the data model used in the data mapping configuration. Double-click on the data model to view it in your default XML viewer (generally, Internet Explorer).
package are extracted and placed in the folders noted above. Resource Archives From version 8.2, PReS Workflow maintains an archive of previous versions of resources, in the following location: %PROGRAMDATA%\Objectif Lune\PReS Workflow 8\PReS Watch\OLConnect\Archive , each in their own folder: l datamapper contains archives of the data mapping configurations (.OL-datamapper) l jobcreation contains archives of the Job Presets (.OL-jobpreset) l outputcreation contains archives of the Output Presets (.
Note Null characters present in the data may not be displayed properly when using PReS Workflow Configuration program, and that they may also be printed differently by different printers. To ensure consistency, you should consider filtering out such characters. Data File and Job File Whichever source it may come from, a serial port, an e-mail message, or an LPR request, for instance, and whatever its format, data entering a PReS Workflow process via an input task is always referred to as a data file.
Job File Names and Output File Names When an input task sends a new data file down a process, it gives it an internal file name referred to as the job file name (associated with the %f variable). The new job file typically keeps the same name until the end of the process. l l If the job file comes to a branch in the process, PReS Workflow makes a copy of the job file and give the new file a new job file name.
example, will generate three JPEGs or TIFFs called Invoice0, Invoice1 and Invoice2. Note that this does not apply to multiple TIFFs, which can include multiple images in a single file. Note You can change the name of a previously named file using a Rename action task (see "Rename" on page 317). About Data Selections A data selection could be compared to an address. It indicates a location within a data file using coordinates.
Data Selector" on page 28) or Get Repository Location to open the Data Repository Manager (see "Data Repository Manager" on page 668). Note The Get (...) Value options will also open the Data Selector or the Data Repository Manager, but once selected, the value becomes static and does not change between each datapage and job file. After opening a sample of the data and/or metadata, you can easily make a selection.
Syntax @(page number, from line, to line, from column, to column, case option, trim option) Here is a breakdown of the syntax (all options are mandatory): l l @(): Always surrounds a data selection. Page Number: The data page number from which you want the data selection to grab the data. If you want to get data from each page individually, this has to be done after a splitter. l From Line: The starting line of the data selection. l To Line: the last line of the data selection.
Database data selections These selections are used for database-driven data files such as Database and CSV emulations. The selection refers to a specific field on any given data page. Syntax field(record set number, child number, field name, treatment of character case, treatment of empty trailing cells) Here is a breakdown of the syntax (all options are mandatory): l field(): Always surrounds database field selections. l Record Set Number: The data page (or "record") of the data selection.
l l l l group: The name of the group in which to retrieve the value. Does not need to be surrounded by quotes. return key: The name of the key where the information you want to retrieve is located. Does not need to be surrounded by quotes. lookup key: The name of the key in the group with which to look up the value. The return key of the KeySet in which the lookup key's value matches the lookup value will be returned. lookup value: A string surrounded by quotes which will be used in the lookup.
Note To get a sample of the metadata file, debug your process and step through it until the option View Metadata gets enabled. This happens when metadata have been created by a task in the process. Open the metadata viewer and save the metadata file to use it as a metadata sample file in the Data Selector. Syntax GetMeta(Field Name [, Option Flags, Metadata Path]) Here is a breakdown of the syntax: l l GetMeta(): Always surrounds metadata selections.
Name Value Behavior GetAttribute 1 Search for the name argument in the attribute collection instead of the default field collection. See: "Metadata" on page 35. NoCascade 2 Search only the level specified by the path argument (defaults to Page level when path argument is empty), instead of default behavior, going from the Page level to the Job level. FailIfNotFound 4 Raise an error and crash the job is the specified name is not found instead of returning an empty string.
Depending on the chosen emulation and data file, the options in the data selector, the Sample data file section and the Data pane itself may change to accommodate your choice. The Line Printer, Ascii, Channel Skip and User-Defined emulations will display the default options (see the Emulation section) and a grid-like display of each character on each line. The following emulations however, will be slightly different.
the database. Each column represents a field returned by the query, with its field name as a row header. XML Emulation l XML data is represented in a tree structure which corresponds to the data in the XML file. Each node of the XML can be expanded to see the nodes under it. See XML Data Emulations. PDF Emulation l l l If you use a PDF emulation, the Data pane displays the data as you would see it in any PDF reader.
Metadata tab The Metadata tab allows users to either generate the metadata file for their active sample data file, or to associate an existing metadata file to their document. The Sample Metadata file name is the path to the metadata file describing the current sample data file. Buttons on the right can be used to load metadata from a file or to save the current metadata to a file.
The Search options defines how to retrieve the value of a given metadata element (attribute or field) when it is not present at the current metadata level. The possible search options are: l l Search from a specific location only. Search from level X to Job, where X can be any metadata level (Job, Group, Document, Datapage, Page).
The emulation that is used in your process can change during the process, and can be different than the one used in any PlanetPress Design document used in your process. PlanetPress Design documents use their own emulations, as defined in the document itself from PlanetPress Design. Emulations in PReS Workflow: l Line Printer l ASCII l CSV l Channel Skip l Database l XML l PDF Warning PDF Emulation, also called Document Input, is only available in PReS Workflow.
This section covers issues relating to the sample data used to create your PReS Workflow configuration and to the actual data that PReS Workflow will send to PlanetPress Design documents. It is an important section which you should fully understand before you start creating your configuration. Also included in this section are procedures that let you make data selections as well as get data from the sample data file.
To choose a sample data file: 1. Click the Debug tab in the PReS Workflow Ribbon. 2. Click on Select in the Data group. 3. Use the Data Selector to choose your sample data file and emulation options. 4. Click OK on the Data Selector. PReS Workflow also keeps the last 9 used data files in memory, which you can reopen to use in the same process, or a different one. To reopen a sample data file used previously: 1. Click the Debug tab in the PReS Workflow Ribbon. 2. Click on Reopen Data File in the Data group.
your documents beforehand. Metadata structure The hierarchical structure of the metadata is composed of a number of basic levels for adding information to the job. These levels are, from top to bottom: l l l Job: a file that contains 1 or more groups. Group: a logical and ordered group of documents (ex: all invoices for a specific customer number; all documents going to the same address, etc.).
l l l The job contains only invoices for clients located in Montreal. Since more than one invoice can go to the same recipient, invoices are grouped by customer. Each invoice is a document resulting from the execution of a PlanetPress Design document over one or more datapages, which results in zero or more physical pages being output.
Attributes are non-repetitive (i.e. name is unique) and do not persist through metadata recreation. l Field: A read-write, user-defined element which holds custom information about a certain node in the metadata structure. Fields are repetitive (i.e. the same field may appear multiple times) and persist through metadata recreation.
In the following table, the last 5 columns indicate at which level the corresponding attribute is available. This also depends on the type of job, however. In the metadata file created for a PReS Workflow job, only three levels are filled with actual data about the job: Job, Group and Document. Attribute Description Categor y J o b Gro up Docum ent DataEncoding (optional) Name of the character encoding.
Attribute Description Categor y J o b Gro up Docum ent software that created the metadata. on Creator Name of the software that created the source of the metadata. TargetDevice Datap age Pa ge Producti on X X X Name of the device for which the metadata and associated data is intended. Producti on X X X Dimension Two floats separated by a colon indicating the media size in typographical points (ex: 612:792).
Attribute Description Categor y J o b Gro up Docum ent Datap age Pa ge respectively portrait, landscape, rotated portrait and rotated landscape. Side "Front" or "Back"; indicates whether the page is on the front or the back of the paper sheet. This attribute is a "best effort" and is devicedependent. Finishin g X Duplex "None", "DuplexTumbl e" or "DuplexNoTu mble"; indicates a change of the duplex status.
Attribute Description Categor y J o b Gro up Docum ent Datap age Pa ge identifier of the media source. OutputBin Devicedependent identifier of the media destination. Finishin g X X X X X Weight Devicedependent weight of the media. Finishin g X X X X X MediaColor Devicedepedent color of the media. Finishin g X X X X X MediaType Devicedependent type of the media.
Attribute Description Categor y J o b Gro up Docum ent Datap age Pa ge X X X X X X X X X X under the parent Document. IndexInGroup Returns the Absolute index of the node within all the nodes under the parent Group. Index/C ount IndexInJob Returns the Absolute index of the node within all the nodes under the parent Job.
Attribute Description Categor y J o b Gro up Docum ent Datap age SelectedCount Index/C ount X X X X SelectedDocument Count Index/C ount X SelectedDatapage Count Index/C ount X X SelectedPageCoun t Index/C ount X X SelectedIndexInDo cument Returns the Absolute index of the node within all the selected nodes under the parent Document. Index/C ount SelectedIndexInGr oup Returns the Absolute index of the node within all the selected nodes under the parent Group.
Attribute Description Categor y J o b Gro up Docum ent Datap age Pa ge index of the node within all the selected nodes under the parent Job. NumCopies Indicates how many times the job is set to execute, as set when printing using a Windows driver. Index/C ount X Author Name of the user who printed the job initially, as available in the spool file, and as the first job info of the Windows capture input.
Metadata Tools in PlanetPress [[[Undefined variable Old_ProductVar.ProductShort]]] (not to be confused with PReS Workflow) includes a complete set of metadata-related functionality, which can be referred to as Metadata Tools. These tools can be used to generate metadata, retrieve or define metadata elements, and build the metadata structure. Using PlanetPress Design, one can: l Generate metadata for any given sample datafile.
Firstly, two buttons at the top right corner of this tab allows to load or save a metadata file generated for the current sample datafile. Secondly, the metadata tab graphically displays all elements (i.e. attributes and fields) available at the current level (i.e. Page, Datapage, Document, etc.). More importantly, these elements are graphically selectable, like any other part of the sample datafile when using the 'Select Data' option inside a Text object, for example.
Metadata in document properties The Metadata tab in the properties of a PlanetPress Design document allows to easily define documents or groups.
The Metadata Fields in the structure of a PlanetPress Design document allow to easily define documents or groups, by dragging and dropping data from the Sample Data directly onto the document's Metadata Fields. Data Repository The Data Repository is a permanent structure to store data that can then be reused, modified or augmented at a later time, by different processes. This feature was introduced in version 8.5.
Feature Name Description Equivalent Database Terminology STRING values and any data inserted into it is converted to string automatically. The maximum size of a single key is 1 billion bytes. KeySet A group may contain as many KeySets (rows), which contain variable data, as necessary. A KeySet is inserted using the "Push to Repository" on page 314 task. Row/Record Lookup A method of retrieving one or more KeySets from a group in the data repository.
This function may also be used anywhere else where the contextual menu gives access to it. You could, for example, use it on the General tab of the Create File task, to fill in the value of a key/value pair in a JSON string. Tip The Data Repository Manager displays, at the bottom left, the syntax used for accessing a specific value. Scripts In a script you can access the Data Repository using the "Data repository API " on page 116.
Documents contain static data such as logos, addresses and graphic formatting, as well as placeholders for data. Documents can also contain conditions and programming logic. For more information about PlanetPress Design documents, please see the PlanetPress Design User Guide. Import Documents This procedure describes how to import variable content documents created in PlanetPress Design. Importing documents can be useful when transferring configurations between PReS Workflow installations.
Debugging and Error Handling This chapter touches on two subjects that are intrinsically linked, though their use is different. Debugging is the act of running through your process, either step by step or as a whole, directly from the PReS Workflow Configuration Tool, in order to detect and resolve issues with your process. Error Handling, on the other hand, occurs when your configuration has been sent to PReS Workflow services, and are running in "production" mode.
On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output.
l l Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
The following information is available from within your information process when it is triggered: l Job Information variables (%1 to %9) l The data file as it was before starting the task l Global variables (which are, of course, available anywhere) l A series of variables containing information about the error, the task that triggered it and the process that contained it.
l PReS Fax l PReS Messenger 3. When any job or file is processed by the selected service, the processing logs will be displayed in the window on the right. Note The information that is displayed here is the same as in PReS Workflow logs and depends on the logging level that you set in the "General and logging preferences" on page 697. To view logs for jobs that have already processed By default, the logs are available in the following folder: %ProgramData%\Objectif Lune\PlanetPress Workflow 8\PlanetPr
Resubmit Backed Up Input Files to a Process Each input task includes an option that lets you back up input files. This options is not selected by default, since it has the potential to generate a very large number of back up files. To turn on the backup option of an input task, simply open its properties, go to the Other tab and check the Backup input files option, then type in a unique file name for the backup file (this should be variable).
To resubmit backed up input data files: 1. In the PReS Workflow Ribbon, go to the Tools tab then click Resubmit Job in the Services group. The File Resubmission dialog box is displayed. 2. From the Process box, select the process for which you want to resubmit the backed up input files. 3. From the Task index box, select the index level to which you want the data to be sent. The index is the position in the process where you want to submit the job file. 4.
But finding this information often poses a problem. A good way to find this information easily is to print it using small characters at the bottom of every page. To do this, you have to do the following. In PlanetPress Design: 1. Use a Set Job Info action task and associate a variable with the job’s name. 2. In the output task, make sure to select the option that adds the job information to the document.
executed by copying the initial input task and pasting it as a secondary input task (the first action task to actually run in the process). Do not forget, however, to remove this duplicate task before saving the configuration! l l l Since the initial input task is not performed, there is no actual job information to be added at the beginning of a data file. Note that you can use the Object Inspector on your process to enter sample job information as required.
l l l l l l l l l l Click on Skip to ignore the next task or branch and go to the next one. The job file is not modified in any way. Click on View as Text in the Data group of the Debug tab to view the current job file using a text editor (Notepad by default). Click on View as PDF to view the current job file in Adobe Acrobat if it is present (this will work only for PDF job files). Click on View Metadata to open the data selector and see the current state of the process' Metadata.
l Any data selection used in task properties after this point will use the new emulation. l Continue stepping through each task until the end of the process to debug it. This method does not allow you to add, remove or move tasks, however. The second method can be used when that is required. l l Step through the process in debug mode until you reach the emulation or data change. Click on View as Text (or View as PDF if your data is PDF at this point) in the Data group of the Debug tab.
documentation, as tasks, except in the specific case of importing a new plugin or customizing the Plug-in Bar. Categories The default categories list plugins according to what type of task they achieve.
much are displayed as icon only. Move the bar up to display more full-width categories, or down to display them more as icons. Furthermore, the Plug-in Bar can be customized using the popup indicator control ( ). Customizing the Plug-in Bar is mostly used for third party or legacy plugins. Using the contextual menu displayed by the popup indicator, you can: l Insert, delete and rename custom categories. l Move categories up or down. l Import third party or legacy plugins.
l Local printing: l l l Send to Folder output queues let you save jobs to a local or network folder from which they can be picked up and printed. See "Send to Folder Printer Queue" on page 73. Remote printing: l l l Windows output queues let you send jobs to a local printer. See "Windows Output Printer Queue" on page 69. FTP output queues let you upload jobs to an FTP site from which they can be picked up and printed. See "FTP Output Printer Queue" on page 72.
Technical In PReS Workflow Configuration, you may associate a single Printer Queue output task with multiple Printer Queues. If you do so, you have the option of using load balancing or not (See "Load Balancing" on page 75). PReS Workflow Printer Queues The printer queues displayed in the Configuration Components pane of the PReS Workflow Configuration program are not to be confused with Windows printer queues.
before the data in the data file, while post-job commands are placed at the end of the data file. Properties Advanced tab l l l l l l l Print speed: Enter the speed, in pages per minute (PPM), of the printer associated with the printer queue. This value is used to determine how to divide jobs when you use the Queue Balancing option for load balancing. Commands: The list of available commands appears in this box.
Character name: Character code: Typical use in printing context: Form Feed \f Moves to the next page Carriage Return \r Moves to the beginning of the current line DOS End-Of-File \032 Indicates the end of a print job in a DOS environment Escape \033 Adds an escape character New Line (CRLF) \n Goes to a new line Windows Output Printer Queue Windows output printer queues send print jobs to local or network printer queues set up in the Windows session in which PReS Workflow is running.
Advanced tab l l l l l l l Print speed: Enter the speed, in pages per minute (PPM), of the printer associated with the printer queue. This value is used to determine how to divide jobs when you use the Queue Balancing option for load balancing. Commands: The list of available commands appears in this box. Select either Pre-job commands or Post-job commands in the Selected box, and double-click a command from this list to add it to the appropriate list.
data in the TeX DVI format. Select (o) PostScript file if the job file is a PostScript file. Select (n) Ditroff format if the job file contains data in device independent troff. Select (t) Troff format if the job file contains data in troff. Select (v) Sun raster file if the job file contains raster images. This ensures that the printer uses the correct filter to interpret the data. l l Job name: Enter the job’s file name. By default, the variable %f (Job File Name) is used.
data to configure the LPR output printer queue, you should first use Job info variables to store the information, and then use these variables in the Printer address and Queue name variable property boxes. FTP Output Printer Queue Unlike FTP output tasks, which are typically used to send data files to FTP sites, FTP output printer queues are mostly used to send print jobs to FTP sites.
Advanced tab l l l l l l l Print speed: Enter the speed, in pages per minute (PPM), of the printer associated with the printer queue. This value is used to determine how to divide jobs when you use the Queue Balancing option for load balancing. Commands: The list of available commands appears in this box. Select either Pre-job commands or Post-job commands in the Selected box, and double-click a command from this list to add it to the appropriate list.
l l Concatenate files: If this option is selected, when PReS Workflow tries to save the print job under an existing name, it appends the content of the new print job file to that of the existing file, instead of overwriting it. Separator string: This option is used to add a separator string between the content of each file when the Concatenate files option is selected.
l When the server running PReS Workflow only sends the data to the printer, because the document is already present on the printer, it adds a trigger before the data (trigger+data). PReS Workflow adds the trigger code automatically, but you may want to use custom triggers. You would do this, for example, to use special printer functions. For more on custom triggers, see the Data Capture and Trigger Implementation Guide as well as the PlanetPress Design User Guide.
Install a Windows Printer Queue using the Objectif Lune Printer Driver (PS) A Windows Printer Queue using the Objectif Lune Printer Driver (PS) can be installed from PReS Workflow WinQueue Input plugin properties. Creating a new Windows printer queue from any PReS Workflow: 1. Start your PReS Workflow Configuration program. 2. Insert a WinQueue Input plugin. 3. In the WinQueue Input plugin properties, click New. 4. Enter a Name for the printer queue. 5. Click OK.
l This will create a PDF data file when the option Create Composed Document Stream (with Medatada) is checked. l This format can be obtained using PReS Workflow. By default, the Create Composed Document Stream option is: l Checked if the incoming stream has been produced with the Objectif Lune Printer Driver. l Unchecked if the incoming stream comes from some other PostScript Driver. l Grayed out and unchecked if the incoming stream is not PostScript.
PDF Creation Parameters PDF files retrieved from a Windows print queue using Objectif Lune Printer Driver (PS) have the following properties: l PDF 1.4 l Optimized PDF (subject to change) l No down-sampling of images These settings are pre-configured and cannot be changed by the user. About Metadata Metadata files are files containing information on the job itself rather than containing the job per se.
permits it. l l Startup processes are processes that run only once before every other process in a given configuration. They can be used to perform operations that need to be completed once before the configuration can actually be run, such as to map network drives. You may only have one single startup process in your configuration. Subprocesses are processes which can be called by any other process from any action task.
Note Subprocesses do not have the "General Tab" which is only used for scheduling, but they do have the Information Tab. Options General tab l l l l l l l l Active: Select to make the process active. Clear to prevent this process from running when you send the configuration to PReS Workflow. Startup process: Select to make this process a startup process.
l Week of month / by date: Select the desired option for the time grid. Note that any selection you make in this box will be interpreted based on the selection made in the Month box. If you chose All months in the Month box and Last in the Week of month / by date box, then the process will run on the last week of every month. If you chose January in the Month box and First in the Week of month / by date box, then the process will run only on the first week of January.
l Click on any block to select / deselect it. l Click and drag from one block to another to toggle all blocks between the two. l Shift-click on any block to toggle all blocks from the top-left corner of the grid to the block you click.
l l l To select all of the time segments for a given day or date, click the day or date on the top grid ruler. To deselect all of the time segments for a given day or date, CTRL+click the day or date on the top grid ruler. To select all the days or dates for a given time segment, click the time segment on the left grid ruler. To deselect all the days or dates for a given time segment, CTRL+click the time segment on the left grid ruler.
Activate or Deactivate a Process All processes are Active by default, but you may make any PReS Workflow process Inactive as required. Because making a process active or inactive is a change in the configuration, to make the change effective you will have to send the edited configuration to your PReS Workflow service (See "Send your Configuration" on page 14). To activate or deactivate a process: 1. Right-click the process in question in the Configuration Components pane 2.
If any task converted into a subprocess was previously using local variables, these variables must be removed or transferred to global variables or job information to be usable in the newly created subprocess. Import Processes from Another Configuration File You can import individual processes or groups of processes from a PReS Workflow configuration file without having to import the contents of the entire configuration file.
both include a startup process, the one in the imported configuration will become a standard process. Important considerations l l When importing a PReS Workflow configuration file, your PlanetPress Design and PrintShop Mail document are not physically imported as they are not part of the configuration file itself. In order for the documents to be available, you will need to send each document from PlanetPress Design and PrintShop Mail (see their respective documentation for details).
Using Scripts Scripts can be used to perform various operations, such as to manipulate data, for example. PReS Workflow can perform scripts written in four different scripting languages and also provides an interface for editing scripts. Warning While this chapter provides some very useful and detailed information about scripting within PReS Workflow, its focus is to inform you about the features, variables and functions unique to this environment.
Multiple APIs (methods of communicating with PReS Workflow scripting tools) are available through the scripting engine, in all languages. l l l l l l The Watch object is used to communicate with your current process and configuration. See "The Watch Object" on page 101. You can manipulate PDF files using the PReS Alambic API. See AlambicEdit Library Reference. Note that the PReS Alambic API is part of the PDF Tools. You can manipulate the metadata in your process using the Metadata API.
For information on the available editor options, refer to "Editor Options" on page 714. Import and Export Scripts Both the Script Editor and XSLT Editor let you import and export scripts. Note When you import a script, it replaces any script currently displayed in the editor. To import a script: 1. In the editor, choose File | Import. The Open dialog box appears. 2.
To find strings in a script: Note If you only want to search a particular section of the script, you should select it before performing the following procedure. 1. Choose Search | Find, or press CTRL+F. The Find Text dialog box appears. The last used string is displayed in the Text to find drop-down list box. 2. Set the search settings and options. l l l l l l l l Text to find: Enter a new search string or select a previous search from the dropdown list.
selected text, you move backward only within the script selection. When the search reaches the beginning of the script or script selection, the search finishes. It does not loop back to the beginning. l l From cursor: Select to start the search from the position of the cursor. Entire scope: Select to search the entire script or a script selection. The scope croplands to a script selection if you make a selection before executing the Find. 3. Click OK.
l l l l l l Global: Select to search the entire content of the script. Selected text: Select to find matching text only within a text block you select. The text must be selected before you run the search.
the line number display settings, See "Editor Options" on page 714). To go to a line in a script: 1. Click anywhere in the Script Editor, then choose Search | Go To Line, or press Alt+G. The Go To Line dialog box appears. The last used line numbers are displayed in the Enter new line number drop-down list box. 2. Enter a new line number in the Enter new line number box or select one from drop-down list. 3. Click OK.
Jump to Bookmarks Before you can jump to bookmarks, you must add bookmarks to specific lines in your script (See "Toggle Bookmarks" on the previous page). To jump to a bookmark: l From the editor’s pop-up menu, choose Go To Bookmark and a given bookmark number. If the bookmark you selected was displayed on a line, the cursor jumps to that line. SOAP Server API Reference PReS Workflow offers a SOAP server API Reference allowing jobs to be submitted from third party application using the SOAP protocol.
Description The SubmitJob method allows users to remotely submit files to their PReS Workflow from a SOAP client. The SOAP client has the option to wait for a response file from PReS Workflow SOAP server. Arguments l l l File – base64Binary. This is an array of byte base64 encoded (see http://en.wikipedia.org/wiki/Base64). SubmitJobInfStruc – Structure containing any required information to prepare the file for a valid insertion into a PReS Workflow process. ReturnJobFile – Boolean value.
Note If ReturnJobFile is set to true, the schedule options of the process should be set to a pooling lower than four seconds, so the client application gets a timely response. Note To return the file, the process must be completed before the timeout of the server occurs. The Timeout option can be set in your PReS Workflow preferences.
Return Value l l PostjobResult - Structure containing the following information: Success – Integer indicating the Success/Error level of the operation. A result of 0 means that the operation was successful. l Message – String containing text information about the Success status. l PostjobInfStruc – See point PostJobInfoStruct for details. Note The task index can be retrieved by using the GetProcessTaskList method. See point GetProcessTaskList for details.
Return Value l l GetProcessListResult - Structure containing the following information: Success – Integer indicating the system-defined Success/Error level of the operation. A result of 0 means that the operation was successful. l Message – String containing text information about the Success status. l ProcessList – Structure containing the following information details. l ProcessName – String containing the process name l Active – Boolean value specifying whether the process is currently active.
Return Value l l GetProcessTaskListResult – Structure containing the following information: Success – Integer indicating the system-defined Success/Error level of the operation. A result of 0 means that the operation was successful. l Message – String containing text information about the Success status. l TaskNames – Structure containing the following information details. l TaskName – String containing the name of the task l TaskIndex – Integer : 1 based index of the task.
Return Value l l GetSOAPProcessListResult – Structure containing the following information: Success – Integer indicating the system-defined Success/Error level of the operation. A result of 0 means that the operation was successful. l Message – String containing text information about the Success status. l ProcessList – Structure containing the following information details. l l SOAPActionName – String containing the name of the process as seen in your PReS Workflow.
Note If both FirstPage and LastPage are set to 0, the entire data file is used. SOAP API - SubmitJobInfStruc SubmitJobInfStruc Structure containing any required information to prepare the file for a valid insertion into a PReS Workflow process. l l VariableList – Array of complex type, containing pairs of variable name and variable value.
Variable Name Description Example Usage (VBScript) "Watch.GetJobFileName" on page 106 Retrieves a string containing the job path and file name located in the job spool folder. Example Usage: str = Watch.getjobfilename "Watch.GetOriginalFileName" on page 107 Retrieves a string containing the job's original path and filename. Note: this filename is generally no longer available if it has been captured by Watch. Example Usage: str = Watch.getoriginalfilename "Watch.
Variable Name Description Example Usage (VBScript) "Watch.Log" on page 113 Writes to the Workflow log file, or the message window when in debug - can accept multiple log levels from 1 (red) to 4 (gray). Example Usage: Watch.log "Hello, World!",1 "Watch.ShowMessage" on the next page Displays a popup dialog box to the user (user has to be logged on). Example Usage: Watch.showmessage("Hello, World!") "Watch.
Variable Name Description Example Usage (VBScript) Example Usage: Watch.executeexternalprogram "del *.ps" "c:\" 0 true "Script.ReturnValue" on page 115 Returns a boolean True or False value to a Workflow scripted condition Example Usage: Script.returnvalue = 1 Watch.GetPDFEditObject Is used to manipulate PDF files using the AlambicEdit API. See the AlambicEdit API for more information. Watch.ShowMessage Displays a message to the user. This method is the same as PW_ShowMessage.
Perl $Watch->ShowMessage("test message"); Watch.ExecuteExternalProgram Calls and executes an external program through a specified command line. The program's execution will be directed by the appropriate flags specified as this method's parameters. Syntax Watch.ExecuteExternalProgram const CommandLine: WideString; const WorkingDir: WideString; ShowFlags: Integer; WaitForTerminate: WordBool: integer; const CommandLine: The command line to execute as a widestring.
Examples VBScript Watch.ExecuteExternalProgram "lpr -S 192.168.100.001 -P auto c:\myfile.ps", "c:\", 0, true JavaScript Watch.ExecuteExternalProgram("lpr -S 192.168.100.001 -P auto c:\\myfile.ps", "c:\\", 0, true); Python Watch.ExecuteExternalProgram("lpr -S 192.168.100.001 -P auto c:\\myfile.ps", "c:\\", 0, True) Perl $Watch->ExecuteExternalProgram("lpr -S 192.168.100.001 -P auto c:\myfile.ps", "c:\", 0, true); Watch.GetJobFileName Returns the complete path and file name of the job.
Python s = Watch.GetJobFileName() Watch.Log("The job filename is: " + s, 3) Perl $s = $Watch->GetJobFileName; $Watch->Log("The job filename is: " + $s, 3); Watch.GetOriginalFileName Returns the original name of the file, when it was captured. This method is the same as PW_ GetOriginalFileName. Example VBScript Watch.GetOriginalFileName JavaScript Watch.GetOriginalFileName(); Python Watch.GetOriginalFileName() Perl $Watch->GetOriginalFileName(); Watch.
Python Watch.GetMetadataFileName() Perl $Watch->GetMetadataFileName(); Watch.InputBox Warning Starting version 7.0, the Watch.InputBox function is deprecated and may no longer work due to changes in the way in which the Watch Service functions. This function is completely disabled in PReS Workflow 7.3 and higher. Prompts the user to enter a string. The string is displayed as the window caption. You can specify a message that is displayed above the text box. This method is the same as PW_ InputBox.
VBScript s = Watch.InputBox("Your Name", "Please enter your name", "John Doe") Watch.ShowMessage("Will the real " + s + " please stand up?") JavaScript s = Watch.InputBox("Your Name", "Please enter your name", "John Doe"); Watch.ShowMessage("Will the real " + s + " please stand up?"); Python s = Watch.InputBox("Your Name", "Please enter your name", "John Doe") Watch.
Python s = Watch.GetJobInfo(3) Watch.Log("Jobinfo 3's value is: " + s, 2) Perl $s = $Watch->GetJobInfo(3); $Watch->ShowMessage("Jobinfo 3's value is: " . $s, 2); Watch.SetJobInfo Sets the job information index to a specified string value. Syntax Watch.SetJobInfo(Index: Integer; Value: String) Example VBScript Watch.SetJobInfo 3, "Job info 3 Value" JavaScript Watch.SetJobInfo(3, "Job info 3 Value"); Python Watch.SetJobInfo(3, "Job info 3 Value") Perl $Watch->SetJobInfo(3, "Job info 3 Value"); Watch.
Example VBScript Dim s s = Watch.GetVariable("MyVariable") Watch.Log "MyVariable's value is: " + s, 2 s = Watch.GetVariable("global.MyVariable") Watch.Log "global.MyVariable's value is: " + s, 2 JavaScript var s; s = Watch.GetVariable("MyVariable"); Watch.Log("MyVariable's value is: " + s, 2); s = Watch.GetVariable("global.MyVariable"); Watch.Log("Jobinfo 3's value is: " + s, 2); Python s = Watch.GetVariable("MyVariable") Watch.Log("global.
JavaScript Watch.SetVariable("MyVariable", "Desired value"); Watch.SetVariable("global.MyVariable", "Desired value"); Python Watch.SetVariable("MyVariable", "Desired value") Watch.SetVariable("global.MyVariable", "Desired value") Perl $Watch->SetVariable("MyVariable", "Desired value"); $Watch->SetVariable("global.MyVariable", "Desired value"); Watch.ExpandString Provides access to the emulated job file and to all variables. This function returns a string that is the expanded version of the input string.
Python s= Watch.ExpandString("%y-%m-%d") Watch.Log("Current Date is: " + s, 2) Perl $s = $Watch->ExpandString("%y-%m-%d"); $Watch->Log("Current Date is: " . $s,2); Watch.Log Creates messages that are added to PReS Workflowwatch.log file. PReS Workflow watch.log file is located in ...\Program Files\PReS Workflow 7\PlanetPress Watch\Log\ppw[log date].log. View error messages in the Services Console while PReS Workflow is in Run mode by choosing Tools | Services | Service Console.
Level Description 1 The message is logged as an Error in the log file. 2 The message is logged as a Warning in the log file. 3 The message is logged as Information in the log file. 4 The message only appears when the application runs in Debug mode. Examples In the following example, log() will write an information entry in the watch log that says "this is a log" VBScript Watch.Log "this is a log", 3 JavaScript Watch.Log("this is a log", 3); Python Watch.
VBScript Watch.Sleep 1000 JavaScript Watch.Sleep(1000); Python Watch.Sleep(1000) Perl $Watch->Sleep(1000); Script.ReturnValue Set this variable to 1 (true) or 0 (false) in order to return a true or false status to PReS Workflow, when using your script as a conditional branch. This variable will have no effect if the script is run as an action. Example This example will always return true, as the condition is static. It is, after all, simply an example. You get the idea.
Script.ReturnValue = 0 } Python everythingOK = True if everythingOK == True: Script.ReturnValue = 1 else: Script.ReturnValue = 0 Perl $everythingOK = true; if (everythingOK = true) { $Script->{ReturnValue} = 1; } else { $Script->{ReturnValue} = 0; } Data repository API The Data Repository is a permanent structure to store data that can then be reused, modified or augmented at a later time, by different processes.
The term ... ... is the same as an Excel ... ... is the same as a Database ... Group Sheet Table Key Column Field KeySet Row Record Note Group and key names are case-insensitive. API Reference Obtaining an instance of the Repository Object The Data Repository is accessed via a COM object that exposes methods to store and retrieve data within the Repository. JavaScript var repoObject = new ActiveXObject ("RepositoryLib.
RepoObject.AddGroup("MyGroup",'["FirstKey", "SecondKey"]'); RepoObject.AddGroup("MyGroup","[\"FirstKey\", \"SecondKey\"]"); But the following is incorrect: RepoObject.AddGroup("MyGroup","['FirstKey', 'SecondKey']"); Many methods require using the JSONStringArray type but JSON is not natively supported in VB Script. Therefore, for those methods, only JavaScript sample code is provided.
Name Description AddValue() for information on how to set a value for a key. RemoveKey Removes existing key KeyName from group GroupName. The key to remove must exist in the group, otherwise an error is raised. All values for the key, in all keysets for the group, are removed. Note that when the Group contains a large number of KeySets, this operation may take a while. ListKeys Retrieves the list of all Key names and data types in Group GroupName, stored in a JSONStringObject. You should use JSON.
Name Description newly created KeySet. SetValue Updates multiple keysets in group GroupName by setting the key KeyName to Value for all keysets that match Condition. The condition is specified using basic SQL WHERE syntax. The Condition may be left empty in which case all keysets in GroupName are updated. Note that KeyName must exist in GroupName, otherwise an error is raised. The method returns an array of the keyset ID's that were updated ( [1,2] ), or an empty array ( [] ) if no keysets were updated.
Name Description available keys in KeyValues. Only the keys specified are updated in GroupName while unspecified keys are set to an empty string. RemoveKeySets Deletes all keysets in GroupName that match Condition. The condition is specified using basic SQL WHERE syntax. Condition may be left empty, in which case all keysets in GroupName are deleted. The method returns the number of keysets that were deleted. RemoveKeySetByID Deletes the keyset whose ID equals ID from GroupName.
Name Description sure no other process is accessing the Data Repository. Version Returns the version of the DLL library used by the Repository. AddGroup Creates a group named GroupName and optionally creates keys listed in keyNames. The keyNames parameter may be empty. Syntax AddGroup(GroupName: string, keyNames: JSONStringArray) Examples In each of these examples, the object repoObject is deemed having been obtained through a call to the COM object "RepositoryLib.
Examples In each of these examples, the object repoObject is deemed having been obtained through a call to the COM object "RepositoryLib.WorkflowRepository" (see "Obtaining an instance of the Repository Object" on page 117). JavaScript repoObject.AddKey("Users", "email"); VB Script repoObject.AddKey "Users", "email" AddKeySets Inserts a new keyset inside GroupName and assigns values to keys as specified in KeyValues. Every key specified in KeyValues must exist otherwise an error is raised.
Sample return value The method returns a JSONIntegerArray containing the ID's of all keysets inserted into GroupName: '[131,132]' AddValue Creates a new KeySet by assigning Value to the key KeyName in Group GroupName. Note that KeyName must exist in GroupName, otherwise an error is raised. See AddKey() for information on adding a key to a group. Upon successful completion, the method returns the ID of the newly created KeySet.
ClearAllData Delete all keysets in all groups, while retaining the existing key structure. Syntax ClearAllData() ClearGroupData Deletes all keysets inside GroupName while retaining the existing key structure. Syntax ClearGroupData(GroupName: string) ClearRepository Deletes all groups, keys and keysets from the repository, returning it to a blank state. Use with caution! Syntax ClearRepository() GetKeySets Retrieves Keys values in GroupName for keysets that match Condition.
VB Script repoObject.GetKeySets "Users", "[""FirstName"",""LastName""]", "Gender='M'" Sample return value The method returns a JSONStringArray of key-value pairs. '[{"FirstName": "John","LastName": "Smith"},{"FirstName": "Richard", "LastName": "Doe"}]' GetValue Performs a lookup in group GroupName and retrieves the first value for key KeyName that matches Condition. The condition is specified using basic SQL WHERE syntax.
retrieves email for first user named SmithrepoObject.GetValue "Users", "email", "" // retrieves email for first user ListGroups Retrieves the list of all group names in the Repository, stored in a JSONStringArray. Syntax ListGroups(): JSONStringArray Example In each of these examples, the object repoObject is deemed having been obtained through a call to the COM object "RepositoryLib.WorkflowRepository" (see "Obtaining an instance of the Repository Object" on page 117).
Examples In each of these examples, the object repoObject is deemed having been obtained through a call to the COM object "RepositoryLib.WorkflowRepository" (see "Obtaining an instance of the Repository Object" on page 117). JavaScript var repoObject = new ActiveXObject ("RepositoryLib.WorkflowRepository"); var myList = JSON.parse(repoObject.ListKeys("Internal")); for (var Property in myList) { // Log all key names for group Users to the console Watch.
VB Script repoObject.RemoveGroup "Users" RemoveKey Removes existing key KeyName from group GroupName. The key to remove must exist in the group, otherwise an error is raised. All values for the key, in all keysets for the group, are removed. Note that when the Group contains a large number of KeySets, this operation may take a while.
Examples In each of these examples, the object repoObject is deemed having been obtained through a call to the COM object "RepositoryLib.WorkflowRepository" (see "Obtaining an instance of the Repository Object" on page 117). JavaScript repoObject.RemoveKeySetByID("Users", 10); perform repoObject.RemoveKeySets( "Users", "ID=10" ); // both methods // the same task VB Script repoObject.RemoveKeySetByID "Users", 10 perform repoObject.
RenameGroup Renames group oldName to newName. While this operation has no impact on the data stored in the specified group, it does require any plugin and/or script that uses oldName to be modified to refer to newName. Syntax RenameGroup(oldName, newName: string) Examples In each of these examples, the object repoObject is deemed having been obtained through a call to the COM object "RepositoryLib.WorkflowRepository" (see "Obtaining an instance of the Repository Object" on page 117). JavaScript repoObject.
VB Script repoObject.RenameGroup "Users", "LastName", "SurName" SetValue Updates multiple keysets in group GroupName by setting the key KeyName to Value for all keysets that match Condition. The condition is specified using basic SQL WHERE syntax. The Condition may be left empty in which case all keysets in GroupName are updated. Note that KeyName must exist in GroupName, otherwise an error is raised.
SetValueByID Updates KeyName with Value in group GroupName, where the keyset's ID matches the ID parameter. KeyName must exist in GroupName, otherwise an error is raised. The method returns the ID of the keyset that was updated or -1 if the keyset was not updated. Syntax SetValueByID(GroupName: string, KeyName: string, Value: string, ID: integer): integer64 Note This method is functionally equivalent to using "SetValue" on the previous page with its Condition parameter set to "ID=ID".
Syntax Version(): string Stopping Execution When using a script, you may come to a point where you'd like the task to fail (raise an error) and trigger your On Error tab under certain conditions. This can be done by using the scripting language's built-in error features, described here. Note that the value or description of the error will not be available to your error process if one is used. However, when available, a description of the error message will be logged in the Watch log.
Watch.Log("Job Info 9's value is: " + s,4); } Python In Python, the raise statement is similar to JavaScript and will stop processing unless an except statement is used. See the python documentation. s = Watch.GetJobInfo(9) if not s: raise NameError('Value cannot be empty') else: # Do something with Job Info 9! Watch.Log("Job Info 9's value is: " + s,5) Perl In PERL, die() raises an exception and triggers the On Error tab, unless the unless command is used. See the perl documentation.
with PReS Suite. The Metadata Tools are used extensively in the given example, which is a weekly sales report sent to all the sales associates of a particular company branch. See the "PDF Workflow" on page 179 for more details. PlanetPress Capture workflow A Capture workflow is divided in two steps: creating an output of documents containing the PlanetPress Capture Fields, and retrieving the information from the Anoto Digital Pen to merge it with the original documents.
PlanetPress Capture Workflow PlanetPress Capture, introduced in PlanetPress 7.2 and enhanced ever since, is a set of tools that is used to simplify digital archiving processes by capturing information from a special pen which records everything it writes on paper, as long as this paper contains special Anoto Patterns. Warning There are important considerations to keep in mind when dealing with PlanetPress Capture. Please review them in "PlanetPress Capture Implementation Restrictions" on page 154.
Generating the Capture Patterns Once your document is created, the Capture Fields Generator action task is used to apply the capture patterns to each of your documents and send them to the printer. This printing process will consist of: l Retrieving your data file. l Creating metadata (See "Create Metadata" on page 475). l l l Separating each individual document in the metadata (this can be done in your Design document or through the "Metadata Level Creation" on page 490 action task).
always be self-replicating and have a short polling interval set in their properties. Managing and Post-Processing There are a couple of things that can be done even after documents have been inked. As long as a document remains open, it is still present in the Capture database and be used in a process: l l The "Find Capture Documents" on page 463 input task is used to retrieve a list of documents under specific criteria.
Anoto Digital Pen A digital pen compatible with the Anoto system. These pens contain a camera, processor and memory chip which record each stroke of the pen on a printed Anoto Pattern, and are able to send this information back to PReS Workflow. This document specifically refers to the Anoto DP-201 Digital Pen, not other equipment has been tested.
Client/Server Architecture A multi-server setup where more then one PReS Workflow server are connected as clients to a single PReS Workflow server which has a Capture Database. In this architecture, the Server contains the licenses for the pens, however the Client contains the database of documents and patterns. The Clients communicate with the server to authenticate pens. This architecture is only provided to simplify pen licensing for users with a large number of pens.
Pattern Sequence Pattern Sequences enable the multiplication of the number of available pattern by adding an extra identification to the document. A Pattern Sequence is also attributed to each Anoto Digital Pen, such as an incoming PGC file will contain the Pattern, on which the Pattern Sequence is added from the pen database. The pattern and pattern sequence refer to a specific document in the database.
General Considerations Here are some general considerations in regards to PlanetPress Capture, its environment, the hardware and the software that interacts with it. Please review these considerations carefully as they may impact PlanetPress Capture and its functionality. Warning PlanetPress Capture Fields cannot simply be inserted into an existing document as-is and expected to work properly, efficiently or consistently.
l l Microsoft Access l l Database file (mdb) must be local to the PReS Workflow computer. It cannot be located on a network drive or another server. l Total database size is limited to 4GB of data. l Total size of a single table is 2GB. l May be unstable in large implementations. MySQL l l l l l The recommended ideal setup is a dedicated SQL Server PC, accessed by PReS Workflow through an ODBC connection on the local network.
l l l In MySQL, the 16 megs packet size limit can be an issue if the PDFs created by Capture are larger than this size; An error saying "MySQL Server has gone away" would appear in this case. This can be fixed by configuring the max_allowed_packet setting in the MySQL Configuration (Reference). Also in MySQL, if a timeout occurs on simultaneous record access, resubmitting the PGC for processing should resolve the issue.
l l l l l PGC Files, while not written in plain text, are not encrypted and are readable through either PReS Workflow (even a server that did not generate the document associated with it), or through third-party applications using the Anoto SDK. This means if someone gains access to your PGC storage folder, they may be able to read the signatures, checkmarks and other information contained in it and reproduce them on a document of their choice. It is always better to secure this folder properly.
The Numbers First and foremost, the 20,000 patterns is a fixed number - PReS can only generate 20,000 unique patterns as this is the number of patterns that we license through Anoto. The 20,000 patterns are, however, not all available when generating documents. There are 8 "demo" patterns that are used to generate documents when PlanetPress Capture is in demo mode (no license activated), and react the same way that the bulk of the 20,000 patterns.
Example Say you print 19,000 pages containing a pattern, every day. You may think you'll "run out of patterns" after a single day. But if 18,900 of these documents are being written to and processed within the day, at the end of the day you only have a 100 page difference, possibly due to mistakes, lost pages, or errors during processing. In this specific example, you would run out of patterns only after 10 days, assuming the numbers remained completely static.
"tag" that is added after the pattern's identification (Pattern ID). When a Pattern Sequence is used, each Pattern Sequence can re-use each of the 20,000 available patterns. "Zones", in this case, could refer to a specific region within a city, or a whole city or a province, whatever fits your needs. Pattern Sequences can be handled in 2 different ways: by attaching a Pattern Sequence to a specific pen, or by attaching it to a specific PReS Workflow process.
Note The mobile phone application, "PlanetPress Mobile", which uses Bluetooth communication to receive pen data and transmit it to PReS Workflow, can still be used with both pattern sequence methods, as it is the equivalent of a docking station on the web. PlanetPress Mobile was added to PlanetPress Capture in version 7.4. Contamination The single but critical danger with any implementation that deals with PlanetPress Capture is "Contamination".
Third, contamination (the most common one) can happen if pattern sequences get mixed up, if pens or paper gets swapped between users, etc. For example, again using a shipping company (with example 2-A), if two of the drivers were to meet for a coffee and exchange their pens inadvertently (we hope, anyways), the pens would be signing the "wrong" documents all day and, when docked, would update the wrong documents in the database.
Anoto penDirector The Anoto penDirector is a software driver provided as a download by Objectif Lune Inc. The penDirector creates a bridge between the Anoto Digital Pen and a PlanetPress Capture workflow in PReS Workflow. In order to use penDirector, it needs to be downloaded from the Objectif Lune website, on this page. This software must be installed after PReS Workflow. The setup will install a preconfigured version of penDirector which can be immediately used with PlanetPress Capture.
3. Undock the pen, or remove its protective cap if it is not docked. Make sure the power light on the pen is turned on and green in color. 4. Go in the Bluetooth tab of penDirector and click on Add Pen. 5. Click on Search while the cap is off on the pen. 6. When the pen is found, click on it and then click Add. 7. When asked for the PIN, enter the one noted above. 8. Click OK to save the settings. The settings for Bluetooth PGC handling are separate from the ones used when docking.
PlanetPress Capture Implementation Restrictions This document describes the limitations of the Anoto Digital Pen & Paper Technology, especially in regards to using it within a PReS Workflow implementation. Note that these limitations apply to any Anoto technology implementation and not just our own. Printer limitations Any document printed with Capture Fields (aka Anoto Patterns) must be sent through a Laser printer.
Paper quality The PlanetPress Capture technology, when generating the Anoto Pattern, already accounts for ink dispersion on laser printers and on general-use laser paper. Therefore, using paper that is not of the same quality (for example, one where the dispersion rate is much higher) or the same type (reflective paper) may not permit the pen's camera to read the pattern properly.
This is because the pen's camera (which captures the position of the pen) is located under the pen tip and must fully see the pattern.
Knowing this, the best practice when creating fields is that they have, at the very least, a 7mm margin on each size of the actual area you want to capture from. For example, an effective 30mm wide pattern will actually be 44mm wide using these margins. The margin should be for both the vertical size and the horizontal size.
PlanetPress Capture ICR The term "ICR", which means "Intelligent Character Recognition" is an evolution on the popularly-known "OCR", which is "Optical Character Recognition". The difference between the two is easily explained: While OCR can only recognize characters using the finished shape (for example, in scanned documents and pictures), ICR relies on much more data which is provided by the Anoto Digital Pen: the path that the pen takes, the exact timing of this path, start and stop points, etc.
User Guide). This must be either a Multi-Area Field or a Text Field. l l l The Capture Fields Processor must have the Perform ICR Recognition option checked, and language needs to be selected. Once the ICR data is available, do something with it. This is done by reading the ICR data that is available in the metadata generated by the Get Capture Document task. The metadata is also readable by the Capture Condition task, including the captured text and the reliability of this text.
l l l ICR Value: The alpha, numeric or alphanumeric value that was determined by the ICR engine. ICR Confidence: A percentage value that the ICR engine gives to any specific value, when comparing the pen data with it's character database. ICR Resemblance: A percentage value that defines how closely the value resembles the "average" character shape. Both the Confidence and Resemblance can be used together to make an informed decision on the contents received by ICR.
The following guidelines are applicable when configuring a PlanetPress Capture object that utilizes ICR: l l l l l l l The collected data is expected to be a number, therefore the numeric mask type must be selected, or The collected data is expected to be a letter, therefore the alphabet mask type must be selected, If upper case letters are expected, select Upper case in the Case option menu. The captured characters would be immediately converted to capital letter i.e.
The following diagram illustrates the available mask types. It is recommended to select the mask type that is the closest to the desired result. An alphanumeric field should be used as a last resort. Guidelines for Capture-Ready Fields l l Target: Form designer What: Only one character per Capture field can be recognized. When expecting multiple characters making up a word or phrase, you must make sure that the user only writes one character per field.
Why: To avoid any ink marks that would spill over from one field to another. If both fields A and B are to close in proximity and the ink marks from field A spill over to field B, then the marks captured on field B would be considered as being part of a character written on field B. For example, if a number spills over and is written over two fields like numbers 9, 1 or 7; then the bottom tip of these numbers could be considered as number 1 in the second field.
How: Make sure there’s enough space between each field. You must re-design the document if that’s the case. There’s no minimum value that is required as the distance between 2 fields, except for the 7mm border that is required in order for the Anoto digital pen to recognize the pattern being used. Writing in a Legible Way l l Target: User. What: It is important to write in a legible way i.e. applying yourself by writing well defined numbers and letter that are easily interpreted.
Why: The available filters to interpret the ink marks done with the Anoto digital pen, allow you to select the engine language to be used. Doing so will give you results that are the closest match to the captured data. Multiple cultural characters can be interpreted with ICR once the correct language is selected such as û, à, é, etc. How: This option is available from the Capture Fields Processor task.
Possibility of Interpretation Error in an Automated Process l l Target: Workflow designer What: We cannot be 100% sure that a character would be recognized by PlanetPress Capture as it should. Therefore, the analysis of a value interpreted with ICR should only occur if the level of confidence is superior to a determined level. Why: An automated process can treat the characters incorrectly due to an incorrect interpretation of a value. This occurrence should be minimized as much as possible.
l Any input task l "Create Metadata" on page 475 l "Capture Fields Generator" on page 448 l Print output PGC Handling Process The second process is the PGC Handling process. It receives data from the Anoto Digital pen, updates the Capture database and releases patterns as appropriate.
Post-Processing is generally done using the "Capture Condition" on page 443 task, which verifies the presence or state of the ink on the document or on specific fields. After PGC Handling Here is an example of a process that receives ink data, updates the database, and then verifies whether or not a field that indicates manager attention is required (for example, a box noting the wrong number of items in a delivery slip). If attention is required, the document is sent via email to the manager.
l l The Capture Fields Processor then uses the PGC file to update any documents in the database that the pen wrote on, and closes those documents in the database when they are complete. Capture Condition is where we can check whether a specific field (a "RequireManager" field) has ink contained in it, and if it does, the branch on the right is triggered.
Task Breakdown l The Find Capture Documents task queries the Capture database for documents that correspond to certain specific conditions. For example, here we would look for all documents that are either in an "Error" or a "Partial" state, which means they received ink but are not completed correctly.
to" those states. Two conditions are necessary, and the "Condition is true when" is set to "all items are met". l With this list of documents in the metadata, we Branch off. This is done because we need to build a report that will be sent to an administrator, and only one email should be sent. l l To build the report, inside of the branch we use the Metadata Sequencer to create one sequence for each document, by splitting at the Document level, by 1 occurrence of the level for each sequence.
the Resource action name box to static , and the Resource folder to c:\PReS\http . Then, click OK. 7. Send the configuration to your local PReS Workflow server. 8. Start PReS Workflow services (see "Start and Stop PReS Workflow Service" on page 608). 9. Open your browser and point it to http://127.0.0.1:8080/documentlist , assuming you have not changed the default HTTP port in the HTTP Server Input 2 section.
l l HTML Form Action: An HTML Form in the browser that may contain text and attached files can be filled and sent to a process with the HTTP Server Input task. HTTP Data Submission: A custom application or a server sends the request to PReS Workflow using either a POST or GET command. The application or server then waits for a response from PReS Workflow Tools.
l l Enable server for SSL requests: This enables secure communication between the browser and the server via HTTPS. By enabling this option, you will need to provide for the proper certificates, key and password. While this configuration is beyond the scope of this document, there are plenty of resources on the Internet to explain these systems. Serve HTTP resources: This is where you enable static resources in PReS Workflow.
new request. This should be put at 0 in order to process requests as soon as possible, meaning immediately. And finally, the HTTP Server Input task properties. While these are described in the "HTTP Server Input" on page 214 task properties page, here are a few considerations to keep in mind when using this task: l l l l l The HTTP Action corresponds precisely to the name immediately following the first slash of your address.
3. The XML request file and attachments are saved in a local folder, if the HTTP Action is a valid one (otherwise, the files are deleted). 4. The HTTP service keeps the request from the client open (it does not yet respond ot it), and waits. 5. The HTTP process corresponding to the HTTP Action captures the XML file and attachments and the process begins. 6. The process runs its course just like any other process would (including subprocesses, send to process, etc). 7.
HTTP PDF Invoice Request This straightforward workflow simply receives a GET request from a browser, loads an existing PDF invoice from a folder on the hard drive, and returns it to the browser. To do this, a client (or a web service) would request the following page: http://ppworkflowserver:8080/getinvoice?in=INV999999 Breakdown of this URL: l l http:// : transfer protocol. This could be HTTPS if the SSL certificates are activated in the preferences. ppworkflowserver : name of the machine.
Task Breakdown l l l l The HTTP Server Input task receives a request through the /getinvoice HTTP Action. Because this task either returns an HTML page with an error message or a PDF, the MIME type is Auto-Detect. It checks whether the invoice request exists by checking if the size of the file is less than 1kb using "File Size Condition" on page 380. The condition returns "true" if the file is not found: c:\PReS\archives\pdf\invoices\xmlget('/request[1]/values[1]/invoicenum [1]',Value,KeepCase,NoTrim).
l l Open HTTPBrochureRequest.pw7 and send the configuration to your local PReS Workflow service. Open your browser to http://localhost:8080/generatebrochure Task Breakdown l l l The HTTP Server Input receives the initial request from the browser. Because this is a demonstration, a backup is made of the XML request. It's not suggested to do this every time, especially on servers receiving a large number of requests, as these files do take some amount of space for each request.
The idea is that a PDF file, because it is a formatted document in and of itself, doesn't absolutely need to go through PlanetPress Design to be processed and printed. Additionally, because of the PDF tools in PReS Workflow, you can easily merge, split, print and take parts of the PDF file as required.
l l l l "Run Script" on page 387 tasks can also modify metadata using the Metadata API (See "Using Scripts" on page 87). The "Barcode Scan" on page 267 task can add information to the existing metadata, and creates it if there is none. The "Capture Fields Generator" on page 448, "Capture Fields Processor" on page 453, "Get Capture Document" on page 469 and "Find Capture Documents" on page 463 tasks generate their own metadata.
l l l l l l l l The "Metadata Level Creation" on page 490 creates the Document level of the metadata by placing each PDF data file in its own Document level. It does this by detecting when the Address in the document changes. Then, the "Metadata Fields Management" on page 481 adds a few fields at the Document level in order to properly tag each document with the appropriate information, in this case the Customer ID, Country and Rep ID.
This section describes the implementation details for a Capture OnTheGo process, including how to create, send and submit COTG documents to the Mobile application. About Tasks A task is a plugin or a block that is used to build PReS Workflow processes. Tasks can do multiple things depending on the type of task and where they are placed. You can add as many tasks as you like to your processes and order them in any way you can.
Task Properties Any task you add to your PReS Workflowprocess must be configured using its properties dialog box. Each task's Properties dialog will give you the options to configure that specific, individual task.
Variable properties can also be mixed, meaning you can combine, within a single variable property box, any number and order of variable types. You can, for example, do the following for an output file name: %O_@(1,1,1,30, KeepCase,Trim)_%y-%m-%d.txt. This would translate in the original file name, followed by part of the first line of a text data file, then the current date.
You can quickly identify variable information that is already present in your variable properties as such: l l l l l A percentage sign identifies standard variables, as well as standard and custom job info variables — %f, for example. A backslash indicates a control character — \004, for example. An at sign (@) indicates a data selection for emulations other than database — @ (1,1,1,1,17,KeepCase,Trim), for example.
a Folder Capture input task and enter *.* in the Masks box, the input task will grab all the files that are put in the source folder. If you enter *.mdb instead, the task will only take the those database files that have an mdb extension. You can use any standard wildcard character in PReS Workflow. Technical Masks are case-insensitive, since the Windows platform does not support case-sensitive file names (yes, you can have mixed case in a file name but that's visual fluff - the OS itself does not care).
Technical Filename containing brackets can be a hassle when attempting to capture them with a mask and using sets or ranges. You can capture a set that contains an opening bracket ( [[] ) , but not a closing bracket as the closing bracket always ends the set or range. There is no escape character available in masks. Date and Time Format To simplify things and to prevent errors, date and time formats have been standardized. l l Date are entered and displayed as yyyy/MM/dd (2007/06/13, for example).
Input Tasks Input tasks are the starting point to any process and determine what file this process will being with. Each process must begin with an input tasks, and although a given process may have multiple input tasks, no task can have more than one initial input task. Initial Input Tasks Initial input tasks are always at the beginning of a process and are always triggered when the process starts.
This is an important consideration when scheduling a task, as the Folder Capture will keep capturing files as long as new files are added, even if it means continuing to capture and process outside its scheduled time. It is also important that while the Folder Capture input task is processing files it keeps a copy of each file in a temporary folder, and will not delete any of these files until it has finished processing all of them. This may cause issues with running out of disk space.
l l l Backup input files: Check this to save a copy of each data file that is captured by your input. These files are saved in the PReS Suite Workflow Tools working folders under the "Backup" folder. Backup filename: Enter the filename that you wish the input data file backup to be saved under. Delete Existing Metadata: Check to remove any metadata from memory. This option is disabled on initial input tasks, and is checked by default on secondary input tasks.
l l Add CRLF after last line: Check if you want the plugin to automatically add a new line at the end of the file. Remove the checkmark to leave the file as-is, useful in the creation of CSV files for example. Delete Metadata: Check to delete any metadata attached to your data file. "Other" Tab l Job Information group l l l l l Information elements: indicates what job infos are automatically created by the input task.
ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output. The On Error tab can be used to overwrite the default behaviors. l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked.
error, the contents of the variables selected in this window will be available to the rest of your process, or as long as they are not overwritten. Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc.
Output Depending on the options, each email is sent as a data file, followed by each of its attachments sequentially. Technical If you use Email input tasks to capture data encoded using a Double-Byte character set (such as those used for Japanese or Chinese, for instance), it is preferable to use attachments rather than the email body to carry the data from its source to the input task, as data corruption is less likely to occur using this method.
l l l Nothing: Select to limit those messages used by this task to those that do not specify any subject. “From” contains: Select to limit those messages used by this task to those that are sent from a specific address. The address you enter in the box below can include variables. “To” contains: Select to limit those messages used by this task to those that are sent to a specific address. The address you enter in the box below can include variables.
"Other" Tab l Job Information group l l l l l Information elements: indicates what job infos are automatically created by the input task. Add lines before first data page: Using the arrows keys you can add any job information directly at the beginning of your data file. Backup input files: Check this to save a copy of each data file that is captured by your input. These files are saved in the PReS Suite Workflow Tools working folders under the "Backup" folder.
On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output.
l l Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Output The output to this task is a series of individual files, one after the other. These files are not modified in any way from when they are captured from the source folder. Note As with any task that can refer to network resources, it is important to understand the considerations involved with paths and permissions of these resources. Please refer to the Network Considerations page in the Advanced Configuration and Options chapter (Reference Guide, in English only).
validation of the RegEx being specified. l l l l l l l Sort files by: Select a given sorting method to prompt PReS Workflow to sort the files in the source folder before taking them (and thus to take them in a specific order). Select None to let PReS Workflow take the files without sorting them first. Sort order: If you selected a sorting method in the Sort files by box, select the order in which you want the files to be sorted.
l l Backup filename: Enter the filename that you wish the input data file backup to be saved under. Delete Existing Metadata: Check to remove any metadata from memory. This option is disabled on initial input tasks, and is checked by default on secondary input tasks. Job Information definitions l l %1 - Source File Name. Contains the file name (excluding path but including extension) of the file name that is captured. Equivalent to using the %o system variable.
l l l l l l Log Message: Check this option to enable logging a custom error message in the PReS Workflow log file and in the Windows Application Events. Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message. Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID.
Input Folder Listing captures nothing, however it does read the input folders (and, if selected, subfolders) and gathers information about each file in that folder. Processing Folder Listing loops through the files and, for each file, generates an XML node with information about the file. Output The output is an XML file containing information about each file. If the Sub-directories option was checked, the structure of the XML also contains the folder structure as it is present on the drive.
Note The
On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output.
l l Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Output The output to this task is a series of individual files, one after the other. These files are not modified in any way from when they are captured from the source FTP server. Properties General tab l FTP Server: Enter the IP address or host name of the FTP server to poll. l User name: Enter the name of a user account on the FTP server. l l l Password: If account named in the User name box is password protected, enter the password here. Port number: Set to use a specific port number.
l l Backup filename: Enter the filename that you wish the input data file backup to be saved under. Delete Existing Metadata: Check to remove any metadata from memory. This option is disabled on initial input tasks, and is checked by default on secondary input tasks. Job Information definitions l l l l %1 - User name: Contains the user name that was used to connect to the FTP server. This is useful if this task is used as a secondary input and the information is defined dynamically.
iteration. l l l l l l l l Stop Branch: If the task is in a branch of the process, the branch is stopped and the job file is returned to the process after the branch. The branch will not produce any output. If the task is not on a branch, the entire process will be stopped. Stop Process: The process is stopped and no more processing is done. No further output is produced.
HTTP Client Input HTTP Client Input tasks use the HTTP protocol to issue HTTP GET commands (queries) to HTTP servers. Replies received from the HTTP servers are used as jobfiles and are thus passed on to following tasks. Input This initial input task retrieves a single file as specified in the URL option. This file may be of any format, even formats that are not readable by PReS Workflow. Processing No processing is done by this task. The file retrieved is not changed in any way.
l l l l Add lines before first data page: Using the arrows keys you can add any job information directly at the beginning of your data file. Backup input files: Check this to save a copy of each data file that is captured by your input. These files are saved in the PReS Suite Workflow Tools working folders under the "Backup" folder. Backup filename: Enter the filename that you wish the input data file backup to be saved under. Delete Existing Metadata: Check to remove any metadata from memory.
l l l l l l l l Stop Branch: If the task is in a branch of the process, the branch is stopped and the job file is returned to the process after the branch. The branch will not produce any output. If the task is not on a branch, the entire process will be stopped. Stop Process: The process is stopped and no more processing is done. No further output is produced.
HTTP Server Input HTTP Server Input tasks are used to receive HTTP requests made via GET or POST commands and to send replies to the servers from which the requests were made. The HTTP server supports both http and e. For HTTPS Support information, see HTTP Server Input User Options.
incoming XML file cannot be more than 400MB, which because of CDATA is reduced to around 200MB. To help in this situation, you may elect to omit CDATA from the attachment, which can be changed in HTTP Server Input User Options. Please note that this limitation also affects incoming binary files (sent through file upload in a form), regardless of CDATA settings. Processing Depending on the options chosen in the HTTP Server Input task properties, the task may choose to ignore some of the files.
enter "MakePDF" here, you could trigger the process by accessing http://127.0.0.1:8080/MakePDF . This is also what your HTML Form's action should be. l l MIME Type: Select the MIME type that best suits the files PReS Workflow will be receiving as input. Loop each attachment as a data file: When receiving attachments through a POST request (HTML Form), this option will make the HTTP Server Input task loop through each attachment. Each data file is an XML with the accompanied file.
l l l Backup input files: Check this to save a copy of each data file that is captured by your input. These files are saved in the PReS Suite Workflow Tools working folders under the "Backup" folder. Backup filename: Enter the filename that you wish the input data file backup to be saved under. Delete Existing Metadata: Check to remove any metadata from memory. This option is disabled on initial input tasks, and is checked by default on secondary input tasks.
l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
Processing No processing is done by this task. Output The output of this task is the same as the input - a data file and job infos that are sent from a task that generated an error. General Tab l The Input Error Bin task does not have any specific properties unique to it, since it only receives input directly from tasks in other processes when an error is generated. For more information, see the chapter on "Debugging and Error Handling" on page 53.
By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output. The On Error tab can be used to overwrite the default behaviors.
error, the contents of the variables selected in this window will be available to the rest of your process, or as long as they are not overwritten. Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc.
Technical SOAP communication is non-trivial and requires a certain understanding of XML and the SOAP protocol. Using the SOAP tasks pre-supposes this knowledge and this documentation does not attempt to provide it. The Input SOAP Task only responds to a single SOAP action by the client: SubmitJob. Within this request however, a secondary action (SubmitSOAPActionName) can be specified - this is what the SOAP Action corresponds to in this task's properties.
On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output.
l l Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Processing When the job is received through LPR, it is saved as a job file. No further processing is done on the file. Output The task outputs the job file as is, with no evaluation or modification. Properties General tab l LPD queue name: Enter the queue name specified in the printer queue on the remote computer or computers. "Other" Tab l Job Information group l l l l l Information elements: indicates what job infos are automatically created by the input task.
l l l %3 - Job name: Contains the name of the job as specified by the software that sent the job. %4 - Source file name: Contains the name of the job file as specified by the software that sent the job. %5 - Sender's IP address: Contains the IP address from which the job was sent. On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723.
l l l l Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values.
The Merge PDF Files input task performs just like any other input: once the process has completed, control is transferred back to the input one last time to check if new files meeting the mask have come in. This means that the merging of PDF files that are not all present at the start of the process may take several passes, which may have an adverse effect on the overall performance and the size of the resulting PDF.
each separate folder, not across folders. The subfolders themselves are always processed in alphabetical order, regardless of the sort order. l l l Sort directories first: If you selected a sorting method in the Sort files by box, and if you want the folders present in the source folder to be sorted first, select this option. Optimize resulting PDF: Select to specify whether the resulting PDF should be optimized.
Job Information definitions l %1 - PDF Directory: Contains the folder from which the data was captured. Examples & Use Cases This task is put into effect in the following use cases and example processes: l Daily Sales Report from PDF Files On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723.
l l l l l l Log Message: Check this option to enable logging a custom error message in the PReS Workflow log file and in the Windows Application Events. Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message. Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID.
Input This task does not poll an input, it sits there and waits for a job file to be sent through the Serial connection. Processing When the job is received through the Serial connection, it is saved as a job file. No further processing is done on the file. Output The task outputs the job file as is, with no evaluation or modification. General Tab l Since Serial Input tasks have no specific task configurable properties, this section contains no property information.
On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output.
l l Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
files in the queue. Once all the files are gone, the task polls the FTP folder again to see if new files are present and, if so, the process continues with these files. Otherwise, the process ends. Output The output to this task is a series of individual files, one after the other. These files are not modified in any way from when they are captured from the source FTP server. Properties General tab l Server Settings group l FTP Server: Enter the IP address or host name of the FTP server to poll.
directory is usually under the server main user directory and generally includes the user’s name. For example, if "/tmp/temp/copy_pending" is entered, it does not point to the "/tmp/temp/copy_pending" directory but to the "/users/support/tmp/temp/copy_ pending" directory. l l l Delete remote file: Check this option to delete the file after it has been retrieved by Workflow. Connection mode group: This group is only relevant to the FTPS protocol and appears when it is selected.
"Other" Tab l Job Information group l l l l l Information elements: indicates what job infos are automatically created by the input task. Add lines before first data page: Using the arrows keys you can add any job information directly at the beginning of your data file. Backup input files: Check this to save a copy of each data file that is captured by your input. These files are saved in the PReS Suite Workflow Tools working folders under the "Backup" folder.
l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
from most emails sent to it. This is due to a technical limitation that will be resolved in a future version. Processing The task reads the incoming SMTP request and provides the data within its body. Output Depending on the Data Location option, the output is different: l Envelope: The request file in XML format, including all email fields (from, to, cc, bcc, subject, body) as well as additional header fields (email client information, attachments, etc).
l Unzip attached file: Select to unzip the attached files. l l Zip password: Enter the password required to unzip the attached files (if any). Note that you can use variables and data selections. Conditions: Defines a filter on capturing files from the SMTP Service's hotfolder. When a condition is added, only files that match this filter are captured, the rest remain untouched. “Subject” contains: Select to limit those messages used by this task to those with a specific subject.
Job Information definitions l %1 - Date Received: Contains the date and time at which the email was received. l %2 - Originator Name: Contains the Name of the sender (in the from field). l %3 - Originator Address: Contains the Email address of the sender (in the from field). l %4 - Recipients: Contains the recipient(s) of the email (in the to field). l %5 - CC: Contains the Carbon Copy recipient if there is one (in the cc field).
l l l l l l l l Stop Branch: If the task is in a branch of the process, the branch is stopped and the job file is returned to the process after the branch. The branch will not produce any output. If the task is not on a branch, the entire process will be stopped. Stop Process: The process is stopped and no more processing is done. No further output is produced.
Example In this example, the SMTP Input plugin is used to capture incoming emails data that must meet certain conditions as the subject that contains "Work to do" and the sender that contains "client@company.com ". The process then redirects the content of those emails to an extraction and finally to a PDF printing.
Telnet Input The Telnet Input Task (also known as the Raw Socket Printing Input) receives files sent to a specific port.
multiple Telnet input tasks. To turn on or off the Telnet logging option, see the user options (see "Telnet Input plugin preferences" on page 705). Input This task does not poll an input, it sits there and waits for a job file to be sent through the Telnet port. Processing When the job is received through Telnet, it is saved as a job file. No further processing is done on the file. Output The task outputs the job file as is, with no evaluation or modification.
l l Backup filename: Enter the filename that you wish the input data file backup to be saved under. Delete Existing Metadata: Check to remove any metadata from memory. This option is disabled on initial input tasks, and is checked by default on secondary input tasks. Job Information definitions l This task does not generate any job information. On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723.
l l l l l Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message. Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file.
form of print jobs. This queue can be shared, so as to be able to receive jobs sent from local as well as remote users. To ensure that the spooled files created by PReS Workflow queue remain in the spool folder, the printer queue must be paused. Input The WinQueue input regularly polls the selected printer queue for new jobs. When a new job is available, it is captured automatically by this task. Processing The print job, by default, is in EMF format.
l Spool Print Jobs in RAW Format: Select to output in RAW format, which is the exactly the data that the computer receives (and is not converted in any way). l Create PDF (With Metadata): Select to output a PDF which can be used by the Document Input (PDF Input) feature in PReS Workflow. l l Optimize Resulting PDF: The resulting PDF is optimized for size and caching options are enabled. This reduces the size of the PDFs (depending on some factors), but may take more time to output the PDF.
On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output.
l l Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Variable properties may include: l Static data. l Standard Variables. See "Standard Variables" on page 593. l Local and Global Variables. See "Manipulate Local Variables" on page 630. l Job Infos. See "Job Info Variables" on page 592. l Data and Metadata Selections. See "Data selections" on page 22. l Printer Control Characters. See "Shared Printer Queue Properties" on page 67. These are normally only used in printer outputs.
l l l l l l l l Global Variables: Contains a list of global variables in this configuration. If no global variables exist, this item is disabled. Control Characters: Contains a list of control characters that can be used in printers. Get Data Value: Brings up the Data Selector, retrieves the value you select and places it in the variable properties box. This information becomes static and does not change between each datapage and job file.
l l l l l Cutting an input or output task will replace it with an unknown task. See Cutting, Copying and Pasting Tasks and Branches Creating a new branch will create an unknown output task in that branch. See Adding Branches. Using Branch From Here... will create an unknown output task below that branch. See Adding Branches. Opening a configuration that contains additional plugins that are not installed on that system will cause these plugins to be replaced by unknown tasks.
l Wildcards: Two wildcards are available in masks. l l l Asterisk (*): Supports any number of characters. *.txt would pick up any text file, file*.txt would pick up any file starting with file and any characters: file1.txt, filetest.txt. Question Mark (?): Supports a single character. file?.txt would pick up File1.txt or filea.txt , but not file13.txt or filetest.txt. Brackets: Specifies a set of supported characters, or range of characters.
Input This task can support files in any emulation, however, the actual file that should be used is one that is compatible with the selected PlanetPress Design document. Processing This task takes the PostScript version of the document (.ps7), ads the trigger and then the active data file to it. If metadata is present, the output is based on this metadata (unselected data pages will not generate output, the sort order will be respected, etc). Otherwise the complete data file is merged.
l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
Task Properties General tab l l l l l l l l Action group l Add: Select if you want the task to add content to the job file. l Remove: Select if you want the task to remove content from the job file. Content: Select what the task will actually add or remove. Select Text file to add the whole content of a text file to the beginning or end of the job file.
without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output. The On Error tab can be used to overwrite the default behaviors. l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
Task Properties General tab l Search mode group: Select your chosen search mode within this group. l l l l l Search whole file: Select if you want the entire data stream to be searched as if it were a single string of text. When this option is selected, PReS Workflow loads the entire file in memory. It offers more flexibility, since search expressions may span across multiple lines and may result in more successful hits. Note that since this option uses more memory, it may affect performance.
l l l l l At the beginning of a line: Select to indicate that the search string must be the first string on the line. At the end of a line: Select to indicate that the search string must be the last string on the line. At column: Select to indicate that the search string must be in a specific column. Specify the column number (the value must be greater then 0) in the Column value box below. Between specific words: Select to indicate that the search string must be between specific words.
On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output.
l l Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Processing The task reads the image and detects the presence of the selected supported barcode types. When a barcode is detected, the data it contains is read and added to the Data Page level of the metadata. Technical This task does not recognize more than one level of the metadata Document. This means that if you are intending to define separate documents, you should use the Metadata Level Creation task after the Barcode Scan.
Barcode types Description Code93 Code 93 symbology. Compressed form of Code 39. Code128 Code128 symbology. Very dense code, used extensively worldwide. Codabar Codabar symbology. Used in libraries and blood banks. Inter2of5 Interleaved 2 of 5 symbology. Used in warehouse, industrial applications. Add2 2 additional digits code for UPC-based symbologies. Used to indicate magazines and newspaper issue numbers. Add5 5 additional digits code for UPC-based symbologies.
Note The fewer barcode types are selected, the faster the plugin performs. Selecting only the expected barcodes is therefore a good practice. Barcode Orientations Barcode orientations represent a barcode orientation on an image. For example, when the leftto-right option is checked, the task will try to read the barcode value assuming that the barcode data should be read in a left-to-right fashion. Note The fewer orientations are selected, the faster the task performs.
The Barcode Scan task character replacement option will allow successful barcode reading of all non-printable characters in a given barcode. The value specified in the Replace non-printable character with option will be found in place of any non-printable character in the BarcodeValue and Barcode_x_Value metadata fields, while the original barcode value (i.e. with non-printable characters) will be available in the BarcodeBase64_x_value metadata field.
l Action: In the initial input tasks, this group is disabled and defaults to Stop Process. In all other tasks where the On Error tab is present, the following options are available: l l l l l l l l l Default: By default, the task is ignored as if it did not exist and the error is logged before continuing the branch or process; the job file is passed on to the next task in the process.
Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task. These comments are saved when the dialog is closed with the OK button, and are displayed in the Task Comments Pane.
l l l l l l l BarcodeBase64_1_Value: Metadata field containing the value of the first barcode, encoded in Base64. Barcode_1_Type: Metadata field containing the type of the first barcode (ex. EAN13, UPCA …). Barcode_1_Orientation: Metadata field containing the orientation of the first barcode. Barcode_1_Top: Metadata field providing the distance (in pixels) from the top of the page to the top of the first barcode.
Change Emulation Change Emulation action tasks are used to tell the tasks that follow them to use a different emulation to format the data they receive. So these tasks do not perform any operation as such on the data, but rather they modify the way subsequent tasks process the data they receive. Change Emulation action tasks are typically used when a secondary input task brings new data that is not structured like the initial data into the process.
By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output. The On Error tab can be used to overwrite the default behaviors.
error, the contents of the variables selected in this window will be available to the rest of your process, or as long as they are not overwritten. Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc.
In the case of a PDF data file, two things can happen. The PDF can be used as a data file for a Design document, or it can be part of a straight PDF workflow. When this is the case, this task will rather apply the active metadata to the PDF data file (see "PDF Workflow" on page 179 for more information on this). Output The output of this task is always, exclusively, a PDF file, optionally optimized and optionally with fresh metadata.
l Set document permissions: Select to enter the Permissions password. l l Allow printing: Select to let users print the generated PDF files. l Allow changing the document: Select to let users edit the generated PDF files. l l l l l Allow content copying: Select to let users copy content from the generated PDF files. Allow form filling: Select to let users enter information in the form fields included in the generated PDF files.
l Show: Select the information you want Adobe Acrobat or Adobe Reader (or other PDF viewer) to display with the generated PDF. Select Page only to leave the tabs area to the left of the PDF pages empty. Select Bookmarks and page to display the contents of the Bookmarks tab (you use data selection objects to create bookmarks in PReS) alongside the PDF pages. Select Page tab and Page to display the content of the Pages tab (thumbnails of each PDF pages) alongside the PDF pages.
l l l l l Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message. Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file.
l General: l Compress text and line art l Auto-rotate pages l Optimize for fast web view l Author: PReS l Keywords: PReS; Create PDF plugin l Monochrome images : l l l l l l Compression: CCITT l Pixels per inch: 1200 Grayscale images : l Compression: Auto l down sampling : Bicubic l Pixels per inch: 300 Color images : l Compression: Auto l down sampling : Bicubic l Pixels per inch: 150 Security : l Allow printing l Allow changing the document l Allow content copying l
Database Query Database Query action task retrieves data from various databases to use as input data. The data received by the task may be kept as is or converted to the CSV, Fixed Length Columns or XML format. Database Query action tasks are not considered input tasks as such, because they cannot be used to start a process. Although they cannot be used to get the process’ initial input, they can be used to gather secondary input (see "Input Tasks" on page 189).
Processing A connection to the selected database is made, the data is retrieved, and an output in the selected emulation format is generated. Output The result of the query is output in the selected data format. The current emulation is changed to the selected format. Metadata and jobinfos are not modified in any way. Properties Database Connection tab l Database group l l l Table/Query: Select the table or query containing the information you need as your input data.
which character to use. You may select the replacement character from the list or type your own. l l Emulation options group: Options from this group change based on the selected output file emulation.
field, use the Configure Width button. Doing this disables the Default width box. l l XML Emulation: If you selected XML in the Output file emulation box, the following options are available: l l l l l l l Configure Width: Click to set the width of each field in the generated file. The displayed Configure Width dialog box lists all the fields in the file that will be generated and indicates their widths.
l l Import Config: If you previously created and exported a PReS Workflow Database Connection configuration, click this button to import it. This saves you the trouble of configuring the connection every time. Client-side Cursor: When this option is enabled, the complete result set is downloaded before processing starts, and changing records is done by PReS Workflow.
paste it to this box. Bear in mind that if the Parse normally option is not selected, any backslashes included in the connection string that is not doubled will be disregarded. Once your connection string is displayed in this box, you can edit it by adding variables or data selections. l SQL statement: Enter your SQL statement. Remember that you may use variables and data selections in your statement. On Error Tab The On Error tab is common to all tasks.
l l l l l Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message. Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file.
Processing Every file in the ZIP is extracted to the specified location. If a folder structure exists in the ZIP, it is respected in the output folder. Output This task outputs the data file it received with no modification. Metadata and job files are not touched either. Properties General Tab l l l l l l l Zip file name: Enter the name of the zipped file. In this variable property box, you may enter static characters, variables, job information elements, data selections, or any combination of these.
running as a whole, and output tasks will not generate output. The On Error tab can be used to overwrite the default behaviors. l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
Task Properties General tab l l l Host: Select the IP address of the PReS Image host to which you want the request to be sent. Refresh: Click to update the list of IP addresses displayed in the Host drop-down list box. Documents: Select a specific PlanetPress Design document if you want all the jobs to be generated with that document. To use a document chosen at run-time for each job, enter a dynamic document name using a combination of text, variables and data selections.
l Output type: Select the output file type that you want. l l l l l l l PDF: The output will be a PDF file. If you select PDF, the DPI and Color Depth options (see below) are disabled and the options available in the PDF tab are enabled. JPEG: The output will be a JPEG file. JPEG is a lossy compression image format that creates small files, compressing continuous tone images (such as scanned photographs) well. TIFF: The output will be a TIFF file.
l Data Stream group: Determines what is output by the Digital Action task: l l l l l l l l Use Digital as new data stream: Use the file generated by the task for the rest of the process. Use original data stream (without document): Use the same data file as what was input to this task. Use original data stream (with document): Uses the PostScript data generated before image is created.
l XML and PDI: Select if you want this task to add both an XML and a PDI index file to the generated document. Job Options tab If you chose PDF as the output type in the General tab, use this tab to choose the appropriate PDF options. Note that all the options available in this tab are only used with PDF files. l l Job options: Select the PDF output option that best describes your needs. This loads all the standard settings for the selected usage scenario. These settings can be changed as required.
you must be sure that the data that will be selected at run-time will not contain any parentheses, as this would cause the task to fail. If you suspect that the data may contain parentheses, you should use a Run script action task (see Run Script Action Task Property) with a Strip() function to strip them out. l l Monochrome images group l l l Keywords: You may enter keywords for the document.
Subsample to use a pixel in the center of the sample area and replace the entire area with that pixel value. This method is significantly faster, but results in images that are less smooth. Select Bicubic to use a weighted average to determine pixel shades. This method is the slowest but most precise and results in the smoothest tonal gradations. l l Color images group l l l l Grayscale resolution: Select the resolution to use for grayscale images.
options of the generated PDF files. l Allow printing: Select to let users print the generated PDF files. l Allow changing the document: Select to let users edit the generated PDF files. l l l l l Allow form filling: Select to let users enter information in the form fields included in the generated PDF files. PDF open password: Enter a password in this box only if you want to prevent users who does not have this password from opening the generated PDF files.
contents of the Bookmarks tab (you use data selection objects to create bookmarks in PReS) alongside the PDF pages. Select Page tab and Page to display the content of the Pages tab (thumbnails of each PDF pages) alongside the PDF pages. Select Full screen to hide all screen contents except the PDF page, and expand the PDF page to the maximum size it can occupy onscreen.
the settings to work, the Add PDF to PReS Search database must be checked. However, you can override which database will be updating using the option in this window, Override global PReS Search Database settings. The database options then activate. l l l l l l l Database type: Select the type of the database in which you want to create a table (Access, or SQL Server).
You can use Download to Printer action tasks to send various types of files, such as attachments, documents and fonts that are used in PlanetPress Design documents that are executed directly on the printers. For images you should rather use Send Images to Printer action tasks (See "Send Images to Printer" on page 326), as they provide image quality and conversion options. Input Any file that you wish to upload to the printer.
l l Keep file extension: Select to use extensions when saving files. When this option is selected, if the task receives a file with the “txt” extension, for example, it will keep this extension even if it renames the file (as specified in the File name box). Print confirmation page: Select to print the Variable content document download confirmation page when the download is successful. On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723.
l l l l Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values.
(Reference Guide, in English only). There are some important things to consider when using the External Program task: l l The executable file must accept so-called "command-line options" and be able to run without any sort of user interaction. Only certain programs are able to do this and may refer to it as "command-line" or "automation" features. The process will always wait for the executable file to finish before it continues to the next task, and does not have any timeout setting.
l l l l Start in: Enter the folder in which the external program is to run. This is important, for example, if the program is to generate files that are to be picked up in a specific location for further processing, or if it requires resources that are located in a specific folder. Leave blank to run the program in the folder of the executable file. Run minimized: Select to prevent a window (a DOS box, for instance) from being displayed on the desktop.
On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output.
l l Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Properties General tab l External file: The path to the file you want the job file to be replaced with. You may browse to the file using the browse button on the right of the field. Examples & Use Cases This task is put into effect in the following use cases and example processes: l HTTP PDF Invoice Request On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723.
l l l l l l l Stop Process: The process is stopped and no more processing is done. No further output is produced. Log Message: Check this option to enable logging a custom error message in the PReS Workflow log file and in the Windows Application Events. Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message.
Note When adding this task to your process, you will be asked if you want to add the task as an Action or a Condition. This task should only be used as an Action. If used as a condition, it will always return False. The task does not modify the job file in any way, its only output is the change in the specified variable where the result is stored. Technical The expression itself must be written in a format understood by the VBSCript scripting language.
expression would be %9*2 . l l Store result in: Variable data field containing the job information, local or global variable in which to store the result. For job information use %1 through %9, for local variables use %{variable} and for global variables use %{global.variable}. Use value of Variable/JobInfo # expression: Use the contents of the variable entered in Store result in:, which is assumed to be a digit between 1 and 9.
l l File l Import: Lets you open an existing XSLT script from an XSL, XSLT or TXT file. l Export: Lets you save the current XSLT script as a file. l Print: Prints the current XSLT script. Edit l Undo: Undo the last edit. l Cut: Cut the current selection (only available if there is selected text in the editor). l l l l l l Delete: Delete the current selection (only available if there is selected text in the editor). Select All: Select all of the contents of the editor.
saved). l l Script running from: Choose if the script should be run from the editor text box, or from an external script file. Script filename and path: Either enter the full path of the XSLT Script, or click the Browse button to navigate to the file. This option is only available if you choose external script file in the Script running from option. Push to Repository The Push to Repository Action Task adds data to the PReS Workflow data repository. The task may only add one KeySet per action.
l Key set: Displays a list of keys for the selected group. l l l l l l l Key: Displays the key name in the group. Value: Enter a value for the key, which will be inserted in the KeySet. This value can be dynamic, including data selections, metadata selections, variables and other data. Update: Check to update the key with new data. For the Update column to be active, the Update base on option must be checked.
overwrite the default behaviors. l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output.
l l Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Processing The script is executed. The script can modify anything such as the data file, job infos, metadata, or even other files on the operating system. Output Whatever file the Run Script action generates, metadata it modifies or creates, etc. Technical Note about conditions: When using Run Script as a condition, the output of the task can be within the branch or on the main trunk. To control the output, use the "Script.ReturnValue" on page 115 variable in your script.
l Search l Find: Brings up the Find dialog. l Find Again: Repeats the previous search and finds the next occurrence. l Replace: Brings up the Replace dialog. l l l Language l VBScript: Select if your script is written in VBScript. l JavaScript: Select if your script is written in JavaScript. l Perl: Select if your script is written in Perl. l Python: Select if your script is written in Pyton.
The On Error tab will be triggered if your script has an execution error (such as syntax error, etc) as well as when raising an error from within your script. For more information, see On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723.
l l l l Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values.
supported by this task. Processing The appropriate changes are made to the data file (replacing text). Output The modified data file is output from this task. Metadata is not modified in any way if it is present. Properties General Tab l l l Find: Enter the string of data for which to search. In this variable property box, you may enter static characters, variables, job information elements, data selections, or any combination of these. Replace with: Enter the string of data to use as a replacement.
ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output. The On Error tab can be used to overwrite the default behaviors. l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked.
error, the contents of the variables selected in this window will be available to the rest of your process, or as long as they are not overwritten. Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc.
Processing The currently active image data file converted to postscript. The image's resolution, scan orientation, and quality can be modified, depending on the selected option. All files are converted into PostScript format for storage on the printer. If a virtual drive, the file is automatically sent to it. Output A postscript file containing the necessary code to save the data file on the hard drive.
images by 75% when it converts those image to PostScript. The default compression level is 70%. l l l l Send to Virtual Drive of: Select the computers and / or printers to which the images are to be sent. Refresh: Click to prompt PReS Workflow to look again for available printers and computers. Hard disk name and path: You may enter the name and path of the hard disk to which you want to send the images.
l l l l l l l Stop Process: The process is stopped and no more processing is done. No further output is produced. Log Message: Check this option to enable logging a custom error message in the PReS Workflow log file and in the Windows Application Events. Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message.
Workflow will wait for the task to be completed before going on to the next task in the configuration. Note As with any task that can refer to network resources, it is important to understand the considerations involved with paths and permissions of these resources. Please refer to the Network Considerations page in the Advanced Configuration and Options chapter (Reference Guide, in English only). Input Any data file in any format.
On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output.
l l Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Output The original data file, metadata and job infos are not modified, they are passed on to the next task. Set Job Infos and Variables action task properties are as follows: General tab l l Var/Info#: Lists all job infos, local variables in the current process and global variables in the configuration. Click on the variable you want to change. Value: Enter the value that you want to associate with the selected job information element or custom variable.
iteration. l l l l l l l l Stop Branch: If the task is in a branch of the process, the branch is stopped and the job file is returned to the process after the branch. The branch will not produce any output. If the task is not on a branch, the entire process will be stopped. Stop Process: The process is stopped and no more processing is done. No further output is produced.
SOAP Client plugin SOAP Client plugin tasks can be used as input, output and action tasks, although their basic function is to generate output. SOAP (Simple Object Access Protocol) is a light protocol that defines a standard XML format used to communicate among systems across different architectures, languages, and operating systems. A SOAP request is an XML-based Remote Procedure Call (RPC) sent using the HTTP transport protocol.
Note The WSDL Address of a PReS Workflow SOAP server is the following: http://127.0.0.1:8080/wsdl/isoapact (assuming you are on the same machine and did not change the default HTTP port). l l l l l l l l l l l Get: Click to get the WSDL file from the SOAP server and populate the Service box below. Service: Choose an available Web service from this drop-down list to populate the Method box below. You may also enter the service name directly if the WSDL file cannot be found.
Advanced tab l Domain: Enter the domain for the authentication on the SOAP server. The Domain is optional even when authentication is used. l user name: Enter the user name for the authentication, if required. l Password: Enter the password for the above user name. l Allow invalid security certificate: Check to ignore SSL certificates that are invalid. On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723.
l l l l l Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message. Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file.
These characters, like other printer control characters that control how printers interpret and print jobs, are not meant to be printed. If your print job is bound for an HP compatible printer, it may include these characters even when printing to a PostScript printer that does not recognize them. PReS Workflow provides an easy way to automatically filter these characters through its Standard Filter action.
running as a whole, and output tasks will not generate output. The On Error tab can be used to overwrite the default behaviors. l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
Output The data file in its new encoding format. Metadata, job info and variables are unchanged. Properties General tab l l l l Source encoding: Select the current data encoding. Note that the source encoding is not selected automatically and you must therefore select the proper encoding from this list in order for the conversion process to be performed successfully. Target encoding: Select the encoding to which you want the data to be converted.
l l l l l l l l l Default: By default, the task is ignored as if it did not exist and the error is logged before continuing the branch or process; the job file is passed on to the next task in the process. When an error occurs in a loop (or in a plugin that acts like a loop), the loop may log the error, terminate the current iteration and proceed with the next iteration.
Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task. These comments are saved when the dialog is closed with the OK button, and are displayed in the Task Comments Pane. Windows Print Converter Windows Print Converter action tasks are designed to convert Windows print files into Line Printer files, that can then be used in a variety of other PReS Workflow tasks.
Properties General tab l EMF to XY group: Select this option if the file received by this task is a Windows print file. This will prompt the task to perform the first phase of the process, and thus convert the file to an XML file. If this option is not selected, the input file will not be converted to an XML file (note that the task will fail if the file it receives is not an XML file). The settings included in this group fine tune the process.
font's mean character width is multiplied with. The value for the mean character width is taken from the corresponding font's attributes (for texts which are printed justified, it is suggested to raise this value up to about 2). For example, if the mean character width of the font example shown here corresponds to the width of the blank character (for other fonts it may be another sign).
l l Character per inch (CPI): The number of individual characters per inch on a line of text. Line per inch (LPI): The number of lines of text per inch. Data Splitters Splitter action tasks are used to single data files into multiple data files. You can use such tasks, for example, to split files that contain statements for multiple clients into smaller files that each contain a single client statement.
channel in Channel Skip), the output data will be different from the input data, but the change will not be significant. Let us imagine that a splitter action task processes the following data file using the ASCII emulation: Data line1 of page 1 Data line2 of page 1 Last data line of page 1 Data line1 of page 2 ...and so forth...
Input A Database Emulation data file. Processing The file is separated into multiple chunks according to the rules set in the task's properties. Output Multiple data files, sent one after the other to the rest of the tasks in the process. Metadata, job infos and user variables are not modified by this task. Properties General tab l l l l l Split group: Use this group to indicate how you want the file to be split.
l l l l l l l l Match case: Select to force the splitter to match the character casing when resolving the Field value change or Field value condition. If this option is selected, a change from “DAY” to “Day” will be considered as a valid field value change, and “DAY” and “Day” will not be considered as equal values. Where to split group: Options from this group are used to define a number of pages or records before or after which the file is to be split.
overwrite the default behaviors. l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
Properties General tab l Split data file on emulated page group: Select to split the data file based on pages (rather than on a word found within the emulated data) and to activate the option from this group, which is used to tailor exactly how you want the page based splitting process to take place. l l Page(s) per output: Enter the number of pages to include in the file generated by the splitter in this edit box below or use the spin buttons.
l l Trim selection: Select to force the splitter to strip empty trailing characters. When this option is not selected, blank trailing characters, if any, are considered in the matching process, so the word “DAY” will not be considered as matching the word “DAY”. Note that this setting applies only to the Word change option. Where to split: By default, the task splits the file at the beginning of the line on which the condition is met (the default value is 0).
running as a whole, and output tasks will not generate output. The On Error tab can be used to overwrite the default behaviors. l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
Properties General Tab l l l l l l Split data file on: Use this box to choose the item on which top split the file. The options available depend on whether or not the Use emulation box is checked (see below). Use emulation: Check to emulate the data before splitting the file. This lets you split the file on a word, a word change, a page number, a database field value or a database field change.
l Where to split group l l l l Pages: Enter exactly where to split the file. Enter 1 to split the file 1 page before or after the string, 2 to split the file 2 pages before or after the string, or 0 to split the file immediately before or after the string. Before or after: In the previous box, you entered exactly where you wanted to split the file, here is where you specify whether you want the split before or after.
to split the file immediately before or after the string. l l l Split when word changed: You may not want to split the file every time the string of characters entered above changes, but only every other time, or every third time. If so, enter the number of times in this box. A Page Number: If you choose A page number in the Split data file on list box (the Use emulation option must be selected), the following boxes are displayed.
l Where to split group l l l l Pages or records: Enter exactly where to split the file. Enter 1 to split the file 1 page or record before or after the string, 2 to split the file 2 pages or records before or after the string, or 0 to split the file immediately before or after the string. Before or after: In the previous box, you entered where you wanted to split the file.
l Split when condition found: You may not want to split the file every time the string of characters changes, but only every other time, or every third time. If so, enter the number of times in this box. On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723.
l l l ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Properties General tab l Split data file on page group: Select to split the data file based on pages (rather than on a word found within the data stream) and to activate the options from this group, which are used to tailor exactly how you want the page based splitting process to take place. l l l l Page breaks on form feed: Select if you want to start a new data page whenever a form feed character is found.
this box. Enter 1, for example, to split the file at the beginning of the line that precedes the line on which the search word is found. l l l Before: If you entered a value other than 0 in the Where to split box, select this option if you want to split the file a given number of lines before the search word. After: If you entered a value other than 0 in the Where to split box, select this option if you want to split the file a given number of lines after the search word.
l l l l l l Log Message: Check this option to enable logging a custom error message in the PReS Workflow log file and in the Windows Application Events. Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message. Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID.
Note This feature is part of the PDF Tools, which is only available in PReS Workflow. Input A PDF Emulation data file. Processing The file is separated into multiple chunks according to the rules set in the task's properties. Output Multiple data files, sent one after the other to the rest of the tasks in the process. Metadata, job infos and user variables are not modified by this task.
combination of these. You may also use the Get Data button to get a static string of characters from the sample data file. If you use this option, the coordinates of the data you will select will be added to the Left, Right, Top and Bottom boxes below. l l l l l l l l l l Left: Enter a value corresponding to the left coordinate on which the splitter must start searching for the region.
l Split PDF file based on Metadata group: l l Metadata Level: Determines on which level of the metadata the split occurs. This can be Group, Document to Data page. Sequencing based on: l l l l l The following number of occurrences of the level: Determine a sequence based on the number of instances found for the metadata level currently processed.
running as a whole, and output tasks will not generate output. The On Error tab can be used to overwrite the default behaviors. l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
l Split method: Use this box only if you want to edit the standard XSLT script that will be used to split the XML file. First use the Standard XML splitter option to define the standard settings. Then, to change the standard XSLT script, select Advanced XML splitter and edit the script as required. l Standard XML splitter The following options are only displayed when the Standard XML splitter option is selected in the Split method box.
l l l l l Use UTF8 encoding: Select if you want to use the UTF8 encoding to process the file. Use file’s encoding: Select if you want to use the XML file’s own encoding to process the file. Advanced XML splitter: The following options and buttons are only displayed when the Advanced XML splitter option is selected in the Split method box. Note that you should not use this option before you have completed all the required settings using the Standard XML splitter option.
l Browse button: Click this button and browse to select the XSLT engine you want the XML splitter to use. On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification.
l l l ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Technical Branches, Loops and other process logic tasks do not generally modify the job file, though some may change system variables. The only exception is the Run Script action, which can be a condition that also modifies the data. Warning Branches, loops and conditions do NOT modify metadata in any way. Furthermore, even if a branch does a backup of jobinfos and the data file, it does not back up the metadata. Keep this in mind when designing a process.
Properties Backup Tab l l l l Backup job file: Select if you want PReS Workflow to use identical copies of the job file for the main and secondary branches. When this option is not selected, the file generated by the output task located at the end of the secondary branch is used as the job file for the main branch. Note that if the secondary branch ends with a Delete output task, the main branch will not receive any job file.
ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output. The On Error tab can be used to overwrite the default behaviors. l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked.
error, the contents of the variables selected in this window will be available to the rest of your process, or as long as they are not overwritten. Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc.
Properties General tab l l File name mask: Enter one file name mask or multiple masks separated by a semicolon (;). See Masks. The condition will be tested True only in the case of an exact match, so consider using wildcard characters. Invert condition result: Select to toggle the result of the condition (true becomes false and vice versa). On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723.
l l l l l l Log Message: Check this option to enable logging a custom error message in the PReS Workflow log file and in the Windows Application Events. Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message. Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID.
Properties General tab l l l File size is: Select whether the condition is to check if the job file is smaller (less than) or larger (more than) then the specified value. Kbytes: Enter the minimum (more than) or maximum (less than) size setting in kilobytes. Invert condition result: Select to toggle the result of the condition (true becomes false and vice versa).
l l l l l l l l Stop Branch: If the task is in a branch of the process, the branch is stopped and the job file is returned to the process after the branch. The branch will not produce any output. If the task is not on a branch, the entire process will be stopped. Stop Process: The process is stopped and no more processing is done. No further output is produced.
Go Sub The GoSub action task transfers the execution of the calling process to the specified subprocess. When a process encounters a GoSub action, it halts its own execution, start the subprocess and waits for it to complete before resuming its workflow with the next task. Every subprocess starts with a BeginSub input task and ends with a EndSub output task, both of which have nothing to configure and cannot be replaced or deleted. The simply represents entry and exit points for the subprocess.
ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output. The On Error tab can be used to overwrite the default behaviors. l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked.
error, the contents of the variables selected in this window will be available to the rest of your process, or as long as they are not overwritten. Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc.
with Printer Queue Output task, for example, the second time the Loop action task will be performed, it will use the PostScript file generated by the output task. On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification.
l l l ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Input Any data file, in any format. Processing The script is executed. The script can modify anything such as the data file, job infos, metadata, or even other files on the operating system. Output Whatever file the Run Script action generates, metadata it modifies or creates, etc. Technical Note about conditions: When using Run Script as a condition, the output of the task can be within the branch or on the main trunk. To control the output, use the "Script.
l l l l l Find: Brings up the Find dialog. l Find Again: Repeats the previous search and finds the next occurrence. l Replace: Brings up the Replace dialog. Go To Line: Brings up the Go To Line dialog where you can enter a line number and jump directly to that line. Language l VBScript: Select if your script is written in VBScript. l JavaScript: Select if your script is written in JavaScript. l Perl: Select if your script is written in Perl.
Warning With the Run Script action, the On Error tab is accessible by right-clicking on the action in your process and clicking Advanced Properties. The On Error tab will be triggered if your script has an execution error (such as syntax error, etc) as well as when raising an error from within your script. For more information, see On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723.
l l l l l Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message. Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file.
This task is dual-purpose: It can be used either as an Action task, or as an Output task. In either case, it does not directly produce an output, though the process it calls may produce one or more outputs. In either case, the called process will ignore the input task along with its job infos and schedule, and use the job file, job infos, metadata and variables from the current process. General tab l Process: The name of the target process to send current job to.
l l l l l l l Stop Process: The process is stopped and no more processing is done. No further output is produced. Log Message: Check this option to enable logging a custom error message in the PReS Workflow log file and in the Windows Application Events. Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message.
retrieve error and other status messages that printers send out, such as being out of paper or having low toner. PReS Workflow uses the SNMP protocol in the form of an SNMP Condition, in to ways: l l To check the status of printers on your network against values you set in a condition, and to return a true or false value. This is called setting a Printer condition in the SNMP condition's Properties dialog box.
l l l l Description: When you click Get info, if PReS Workflow is able to communicate with the device, it displays its description here. Condition type: Select Printer Queue to test a standard printer status condition or User Defined to test a status identified using a printer specific identification code. Bear in mind that the failure to comply with any of the test conditions selected below will make the whole condition False.
hard disk, or to modem mode. Using an SNMP condition, PReS Workflow can communicate with a device located at a given IP address and request the status of the object identified by a given MIB OID number. Object Identifiers are typically assigned and registered by device manufacturers. They are based on a standard known as Abstract Syntax Notation One (often referred to as the ASN.1 standard). On Error Tab The On Error tab is common to all tasks.
l l l l Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values.
can be used to test whether or not the first string is equal to the second one, whether it is equal or lower than the second one, etc. The logic of text conditions can sometimes be tricky, especially if it includes variable strings, so you should test it thoroughly. Properties General tab l l l l l l String: If you want to test the presence of a given string at a given location, enter the string in this box.
l l l l Compare to string: You cannot enter a comparison string when either “Is found” or “Is not found” is selected in the Operator box. Enter the second string of the comparison in this box. As with the String box, you can enter a static string, a variable or a data selection in this box. Page range: Select Any page if you do not want to specify a precise data page. Select Pages to specify individual pages or page ranges.
l l l l l l l Stop Process: The process is stopped and no more processing is done. No further output is produced. Log Message: Check this option to enable logging a custom error message in the PReS Workflow log file and in the Windows Application Events. Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message.
l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
l l l Time division: Select the desired time interval. Each block in the grid corresponds to the selected time interval. Invert condition result: Select to toggle the result of the condition (true becomes false and vice versa). Grid: Select separate or contiguous time blocks. Click a block to toggle it on or off. Click and drag to toggle multiple blocks on or off. Click date or day at the top of the grid to toggle the whole date or day on or off.
l l l l l l Log Message: Check this option to enable logging a custom error message in the PReS Workflow log file and in the Windows Application Events. Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message. Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID.
Create MRDX The Create MRDX action task is used to register a job on a Suretrac server using an MRDX file. The MRDX contains information about the job and its finishing, as well as integrity features use by SureTrac. This task requires a PDF file as an input, along with metadata generated through a document that contains PitneyBowes Scan Codes. Properties General Tab l Register Job to the SureTrac Server group: Check this option to enable the group.
overwrite the default behaviors. l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
Input Any data file present on a SharePoint document store, even those not compatible with PReS Workflow emulations, and the properties of these files. Processing The task connects to the selected Document store and retrieves a copy of files according to the specified rules. The files may be deleted or marked as checked out depending on the options selected, otherwise they are untouched. Output The output to this task is a series of individual files, one after the other.
l l Do not download checked out documents: If the document is set as "Checked Out" in SharePoint, it will be ignored. Action Group l l l Download the document: Simply download the document and do not modify it in SharePoint. Download the document and mark it as checked out in SharePoint: Download the document and mark it as Checked Out in SharePoint. This is useful for preventing files to be downloaded more than once.
Job Information definitions l l %1 - Source file name: Contains the name of the current captured file. %2 - Directory: Contains the name of the SharePoint director from which the current file was captured. On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723.
l l l l l Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message. Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file.
Laserfiche is a provider of digital document and records management systems. Laserfiche has two components: the Laserfiche server, which hosts the repository, and the Laserfiche client, which serves as the user’s interface with the repository.
l l l l Volume: A list allowing to choose among available Laserfiche volumes. Configure Tags: Click to open the Configure Tags dialog. See LaserFiche Repository Output - Configure Tags. Configure Templates: Click to open the Configure Templates dialog. See LaserFiche Repository Output - Configure Templates. PReS archive folder: Folder path of the folder capture of the current process. This field is optional and should only be set when publishing PReS Workflow archives that have PDI files.
l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Restrictions l l Each Laserfiche Repository Output task uses a connection to Laserfiche.
Note This task will automatically "loop" through the metadata and repeat its action for each of your metadata's data pages. This task should not be placed after a Metadata Sequencer task, otherwise it will run as many times as there are metadata sequences, which will result in decreased performance. Input Any compatible data file, requires metadata to be present. Processing The task parses each level of the metadata and, for each field of the specified name it finds, a lookup is made.
l l Lookup Column: The name of the column in the Microsoft® Excel® worksheet that corresponds to the contents of the Lookup Field. Action: What to do with the resulting data from the Microsoft® Excel® worksheet. This can be: l l l l l l l Add Field: Creates a new field with the data. This may cause multiple fields to be created. Replace field value: Replaces any existing field with the new content. Only the last result will be displayed. If the field does not exist, it will create it.
l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
Note Microsoft® Word® needs to be installed for this task to be functional and to test the connection. Input A compatible Microsoft Word Document (see notes). Processing The Word document is converted into a PDF file. If a Mail Merge is made, the mail merge is done in the document before the document is converted into a PDF file. The conversion is done through the use of a printer queue - the document is printed to this queue and the print job is converted to PDF.
Properties General tab l l Microsoft Word Document: Enter a Microsoft® Word® document or template, or click the browse button to navigate to the location of the document. The supported extensions are: *.doc, *.docx, *.dot and *.dotx. Perform Mail Merge: Check when providing a Microsoft® Word® document or template configured for mail merge. l l l l l l Use settings specified in document: Selected to instruct the task to use the connection string and SQL statements stored in the DOC file.
On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output.
l l Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
l l If the database path is specified in the Microsoft® Word® document, the mail merge has to be performed with the settings specified in the document, otherwise the database path provided in the task is ignored and can cause different conflicts. To use custom settings, the Microsoft® Word® document should contain only mail merge fields with no database path entered. The Microsoft® Word® to PDF action task allows specifying the path of the database and the query to use.
l l l Store ID: Enter a valid Capture OnTheGo Server user name (mandatory). Password: Enter the password (mandatory) that corresponds to the Store ID entered above. Show password: Check this box if you want to see the password you type in the Password box. Deposit Tab In the Deposit tab, you enter information regarding the document you are making available to Capture OnTheGo users. l Document to Publish group: This is where you specify the document location and type.
on a single line, granted that you use a semi-colon to separate each one. Also note that there cannot be any spaces before or after each group or user name and that the names are case insensitive. Click any given line to edit the information appearing on this line. To remove a group of users or a single user, make a selection in the list and then click the button marked with an X. l l Categories: Enter at least one valid Capture OnTheGo document category in this box.
l l Stored on a User Device for: Enter the number of days for which the document is to remain on a user’s device once downloaded. If you leave this box empty or enter a value of 0, the document will never automatically expire on the devices. Keep in repository group: The boxes found in this group let you specify how long the document is to remain in the repository (even if they are not downloaded to the user's device).
Processing The task connects to the selected Document store and uploads the current data file. If the file already exists, it will be overwritten and, if this option is selected, marked as "checked in". The information accompanying the file (the SharePoint metadata) is either updated or created. Output The output of this task is the original data file. Properties General Tab l l l SharePoint Site: The name of the SharePoint site where you want to send the files.
name corresponds exactly to the Field Name in the SharePoint Document Library. If this option is checked, the Field Information will change to "Use PReS Index (PDF/A)". l Field Type: The type of field as set in the SharePoint Document Library. The following SharePoint field types are supported by the SharePoint output task: l Single line of text: This type may contain a string of any type of characters. This is the most flexible type of field.
Examples & Use Cases This task is put into effect in the following use cases and example processes: l Capture Post Processing Workflow On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification.
l l l l Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values.
Input Any data file with a valid Emulation. Metadata is optional and can be used to specify the fax number and information to send the file. Alternatively, a TIFF file in the proper page size and compression (CCITT Group 4) can be used. Processing If a data file with metadata is used, the data file is merged with the selected PlanetPress Design document, converted into a multi-page TIFF file with CCITT Group 4 compression, and sent to the PReS Fax host specified in the properties.
PReS Image PReS Image output tasks are used to make request to PReS Image, which creates image files which it then archives or emails. Since this task is an output, it is not possible to immediately act on the generated image before continuing. When necessary to immediately retrieve the generated file, "Digital Action" on page 292 should be used instead.
Processing & Output Multiple things can happen, depending on the options chosen and the type of data this task receives: l l l If the data file and a document are selected, and Printer Centric mode is used, the data file is sent to the PReS Image host which merges the data and document to produce output.
task. l l List only documents using VDX compilation: Check to ensure that only documents that are compatible with the VDX compilation method are shown in the list, if producing VDX output. Run mode group l l l l Optimized PostScript Stream: Select to merge the selected document with the data received by this task before sending it to PReS Image. Note that some features, such as the Time and Date functions, require that this option be selected.
l l l l l l l Color depth: Enter the color depth of the output image in bits per pixel (bpp). The color depth is measured in bits, because each pixel of the output image can be described with a varied number of bits. A higher bit number allows for more colors. It also increases the image file size. A 1-bit color depth produces monochrome images.
l l Automatically Add Extension: Check if you want the correct extension for the image type to be appended to the file name automatically, rather than having to add it in the Filename box. The Output Type determines the extension to be used. Index group: This group lets you specify which type of index must be created for each document generated by this task. PDI files are used by PReS Search as indexing information.
l l l l l Author: You may enter the name of the author of the document. Since this is a variable property box, you may use variables and data selections and let PReS Workflow interpret this information at run-time. Subject: You may enter the subject of the document. Since this is a variable property box, you may use variables and data selections and let PReS Workflow interpret this information at run-time.
compression. Select Auto to let the application choose the best compression method automatically. Note that configurations that were created with an earlier version of PReS Workflow and that included tasks set not to use any compression will by default be set to use the Flate compression method. l l l Downsampling: Select the down sampling option. Down sampling reduces image size by breaking images down into small areas in which multiple pixels are replaced by single pixels.
Bicubic to use a weighted average to determine pixel shades. This method is the slowest but most precise and results in the smoothest tonal gradations. l l Resolution: Select the resolution to use for color images. Note that this setting has an impact on the color down-sampling process. Security group l Set document permissions: Select to enter the Permissions password. l l Allow printing: Select to let users print the generated PDF files.
l Initial view group l l Zoom factor: Select the magnification at which you want Adobe Acrobat or Adobe Reader (or other PDF viewer) to open the generated PDF. Choose the Fit in window option to display the entire page using the available screen space, or choose a percentage of the actual document size. Show: Select the information you want Adobe Acrobat or Adobe Reader (or other PDF viewer) to display with the generated PDF. Select Page only to leave the tabs area to the left of the PDF pages empty.
l l Use Windows NT Integrated security: Select to use your Windows user name and password to log onto the SQL database. User ID: Enter the user id required to access the database to which you are adding new PDI files from the generated PDF files. If you are using an SQL database, enter the login name you chose when you configured the SQL database (refer to the “Using PReSSearch with an SQL Server Database” section of the PReS Search User Guide).
RU2256225, and AU773011. Capture Condition The Capture Condition checks the status or field contents of a capture document that has been processed by the Capture Field Processor action task. Input A data file in PGC or PDF format that is accompanied by valid Metadata. This metadata must contain Capture information and is generally available after a "Capture Fields Processor" on page 453 or "Find Capture Documents" on page 463 task.
l Condition based on Document Status: Select this to base the condition on the state of the document l l l l l l l Document is closed: Condition will be true if the document is closed (all relevant Capture Fields are filled). Document is complete: Condition will be true if the document is still open, but all appropriate Capture Fields are filled. Document is partial: Condition will be true if the document is still open but only part of the appropriate Capture Fields are filled.
clicking on a document, the "PDF Viewer" on page 663 appears and displays all of the capture fields. Double-click on a Capture field to automatically add its name to the Field Name box. l Condition: Defines what should trigger the condition: l Ink is Present: Triggered by the presence or absence of ink in the field. l l l l l l l l l All: Ink should be present in all fields of this name in your document. Index: The specified index of the capture field of this name should contain ink.
l Content Status: Triggered when the field is in a specific status. A Drop-down provides a way to select which status will trigger this condition to be true. l Complete: The field contains ink and no error was detected. l Empty: No ink was found in the field. l l l l Error: A logical error was detected in the field. This can happen, for example, if a field was re-written when it should not, a List Field set to only accept one option contains ink in both options, etc.
l Capture Post Processing Workflow l Capture Web Manager Workflow On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification.
l l l ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Input The Capture Field Generator action task expects to receive a regular data file that corresponds to the Capture-Ready document that uses it, along with Metadata generated using the same data file and document. This means that this task must be preceded by at least the Create Metadata task. This metadata must also be correctly separated at the documents level, either in the CaptureReady document's properties or through the Metadata Level Creation task.
job, every action made by this task will be rolled back as if they hadn't happened. Output The Capture fields Generator action task will output either a PDF and Metadata, or an Optimized PostScript Stream file without Metadata. Properties Pattern Generator action task properties are as follows: l l l Capture Document: Choose the PlanetPress Design capture ready document that will be used to generate the output including the capture fields.
l l Fail if document doesn't contain at least one capture field: If the static or dynamic document that tries to pass through this task does not contain any capture fields, an error will be generated. Simulate pattern area on final document: When retrieving the document from the database with the Get Capture Document, each Capture Field is simulated using a grey box.
l l l l l l l l Stop Branch: If the task is in a branch of the process, the branch is stopped and the job file is returned to the process after the branch. The branch will not produce any output. If the task is not on a branch, the entire process will be stopped. Stop Process: The process is stopped and no more processing is done. No further output is produced.
"Anoto" and the Anoto logotype are trademarks owned by Anoto AB. PLANETPRESS CAPTURE is based on Anoto Digital Pen and Paper Technology, which is covered by over 200 patents worldwide, including but not limited to US6663008, US7172131, US7248250, US7281668, JP3872498, JP3842283, CN1595440, SE517445, RU2256225, and AU773011.
Logical errors do not cause this task to exit. For example, if a List Item Capture Field is set to only accept a single option but contains ink in more than one option, or if a Capture Field that does not accept re-writing receives more ink, the task will still complete. The inks that are relevant to logical errors are still added to the PDF document, but they are added on a separate "error" layer.
Technical There is currently no method of obtaining the information from a PGC except through a successful processing of this task, or via the use of the PlanetPress Capture API within a Script (see "Using Scripts" on page 87) Properties Capture Fields Processor action task properties are as follows: l l PGC Name: This value will be added to the output metadata, as well as the Capture Database, to link the PGC to the document it updates.
updating the wrong document. When out of bounds ink is found, the document will be set in the "Error" status. (see note below) l l Split PGC by document: Check to treat each document as a separate PGC file. This removes the need to use a Capture PGC splitter before this task, however the PGC Splitter remains useful when using self-replicating processes to accelerate PGC processing.
l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
as a split. Patterns that do not match any document are sent individually, one Pattern ID per split. Output One or more PGC file, separated as described above. Task Properties General tab l Pattern sequence group: Determines what Pattern Sequence will be assigned to each PGC file. l Type: Specify from where the Pattern Sequence should be taken. l l l l None: Do not use a Pattern Sequence. Pen Information: Use the Pattern Sequence assigned to the pen in the PlanetPress Capture Database.
l Action: In the initial input tasks, this group is disabled and defaults to Stop Process. In all other tasks where the On Error tab is present, the following options are available: l l l l l l l l l Default: By default, the task is ignored as if it did not exist and the error is logged before continuing the branch or process; the job file is passed on to the next task in the process.
Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task. These comments are saved when the dialog is closed with the OK button, and are displayed in the Task Comments Pane. "Anoto" and the Anoto logotype are trademarks owned by Anoto AB.
through the Capture Fields Generator. The ID must correspond to a document in the Capture database, or the task will fail with an error. l Metadata Level: A drop-down list containing all of the levels of Metadata. Choose the one where the ICR data will be added. On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723.
l l l l Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values.
Technical The Find Capture Document task makes multiple simultaneous statements to the database when requesting a list of documents. For this task to work, the option "Allow multiple statements" must be checked in the ODBC connection setup done in the control panel. Input Because this task in an input task, it does not use the current job file in your process, even when used as a secondary input task.
l Filter: The selected filter type. This can be any of the following: l l l l l l l l l l Document Name: The name of the document, as specified in the Document Name property of the "Capture Fields Generator" on page 448. Date Generated: The date, in YYYY-MM-DD format, when the document was generated through the Capture Field Generator. Date Closed: The date, in YYYY-MM-DD format, when the document was closed by the Capture Field Processor or Get Capture Document tasks.
l l l l l l l l l l l l l Less than or equal to: Numerical comparison, where anything lower or equal to than the specified value is included. Greater than or equal to: Numerical comparison, where anything higher or equal to than the specified value is included. Contains: Inclusive string comparison, documents where the specified value is present within the chosen filter are included.
Warning The Advanced Data File option will generate a high number of queries into the Capture Database, and will be slower than a regular data file by orders of magnitude.
l l l l l l l l Stop Branch: If the task is in a branch of the process, the branch is stopped and the job file is returned to the process after the branch. The branch will not produce any output. If the task is not on a branch, the entire process will be stopped. Stop Process: The process is stopped and no more processing is done. No further output is produced.
Get Capture Document The Get Capture Document action task is used after the Capture Fields Processor to retrieve all documents that have been updated. Input A data file in PGC or PDF format that is accompanied by valid Metadata. This metadata must contain Capture information and is generally available after a "Capture Fields Processor" on page 453 or "Find Capture Documents" on page 463 task. However, it is also possible to directly retrieve the required information from a specific Document ID.
l l ICR_[FieldName]_Val : The value of the text that was recognized by the ICR engine, for the field named [FieldName]. If the field is not and ICR field or if that field contains no ink, the value will be empty. ICR_[FieldName]_Cfd : The confidence value (in percentage) of the engine for the value provided.
On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output.
l l Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Processing The ink contained in the PGC file is converted into an EPS layer, which is then applied on an blank, empty PDF file of the size specified in the task's properties. If more than one Pattern ID is found in the PGC file, each separate Pattern ID will generate a new page on which its ink is applied. Output A PDF file with a blank background and only the ink data found in the PGC file. Properties General Tab l PDF page size: Choose the page size of the output PDF.
running as a whole, and output tasks will not generate output. The On Error tab can be used to overwrite the default behaviors. l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
Processing If a data file and document are selected, the metadata is generated by merging the data file and document and retrieving only the metadata generated by this merge. The Metadata levels will reflect those defined in the document, including separation for Group and Document, metadata fields, etc. l l In PDF emulation, the size and orientation attributes for each page are set in the metadata. In all other emulations, those attributes remain blank.
l Basic Functional Capture Workflow l Capture Web Manager Workflow l Daily Sales Report from PDF Files On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification.
l l l l Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values.
Output The PDF file with embedded metadata (the metadata is not deleted from the PDF File on extraction, so this task will always output a PDF with embedded metadata). Properties General Tab l l Extract metadata into PDF job file: the metadata is extracted from the current data file (which is assumed to be a PDF file in which metadata has been previously embedded), and it becomes the current metadata from this point on, overwriting any current metadata file that may already be set.
l l l l l l l l Stop Branch: If the task is in a branch of the process, the branch is stopped and the job file is returned to the process after the branch. The branch will not produce any output. If the task is not on a branch, the entire process will be stopped. Stop Process: The process is stopped and no more processing is done. No further output is produced.
Metadata Fields Management The Metadata Fields Management task can be used to add new fields into your metadata, either for every element or through conditions. Note This task will automatically "loop" through the metadata and repeat its action for each of your metadata's datapage. This task should not be placed after a Metadata Sequencer. Input Any data file with accompanying metadata. Processing Fields are added, removed, modified, etc, according to the actions defined in the task properties.
l l l Sum: Calculate the sum of all values found in all fields of a given name, at a given level. The resulting number is formatted by default with the dot decimal separator. Delete: Delete the metadata field if it exists and disables the Field information column's Field value option. Field Information: Specify the metadata node level, field name and field value of the specified action. l l l l Level: Choose between Job, Group, Document, Datapage.
On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output.
l l Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
l l Metadata Fields Management actions on the page level are not possible since the entire task execution is based on the data page node. The task raises an error if the selected Metadata Fields Management action is Sum and if one of the field values is not numeric. The task supports approximately 15 digits of precision in a range from 2.23 x 10-308 to 1.79 x 10308. Metadata File Management The Metadata File Management action task is used to execute actions on Metadata files.
l Metadata Filename: Enter a static or variable name for the metadata file to load. Not active when the delete action is chosen. On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification.
l l l ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Output The original data file is output, along with the modified metadata. Properties General Tab l Filter levels: Rules for deselecting nodes at the Group, Document or Data page level. Note that currently unselected nodes are ignored. l l l l l Group: Select the metadata Group nodes (the nodes only) based on the specified rule(s). Document: Select the metadata Document nodes (the nodes only) based on the specified rule(s).
l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
Properties General Tab l l Document: Create a new Document level. Note: Attributes and Fields are deleted for all new Document levels created as well as existing Groups. Group: Create a new Group level. Note Attributes and Fields are deleted for all new Group levels created. l l Delimiter defines if the Condition parameter is triggering the beginning or the end of a Group or Document. If the delimiter option is set to None, the action is not performed.
l l l l l l l l l Default: By default, the task is ignored as if it did not exist and the error is logged before continuing the branch or process; the job file is passed on to the next task in the process. When an error occurs in a loop (or in a plugin that acts like a loop), the loop may log the error, terminate the current iteration and proceed with the next iteration.
Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task. These comments are saved when the dialog is closed with the OK button, and are displayed in the Task Comments Pane.
1. WinQueue Input: Intercepts a printed data file sent to a Windows printer queue. 2. Metadata Level Creation:Begins a new document node when “Page 1 of” is found on a data page. l Action:Document l Delimiter:Begins when l Rule:(@(?,1,1,1,9,KeepCase,NoTrim) IS EQUAL TO Page 1 of) 3. Metadata Sequencer: Splits the data file on each metadata document node level.
Properties General Tab l Metadata level: Select the metadata level to process. l Sequencing is based on l l l The following number of occurrences of the level: Determine a sequence based on the number of instances found for the metadata level currently processed. For example, if the Metadata level is set to Group, and this value is set to 3, each sequence contains 3 groups (except, possibly, the last one, depending on the number of groups left in the last sequence).
General Tab l Group: Sorts the metadata by group. l Document: Sorts the metadata by document. l Data page: Sorts the metadata by data page. For each parameter, three columns are available: Sort By, Then by, Then by (again). This lets you sort your document level in three different orders sequentially. Sorts are always done from left to right, top to bottom, giving you a total of 9 sorting possibilities.
l Action: In the initial input tasks, this group is disabled and defaults to Stop Process. In all other tasks where the On Error tab is present, the following options are available: l l l l l l l l l Default: By default, the task is ignored as if it did not exist and the error is logged before continuing the branch or process; the job file is passed on to the next task in the process.
Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task. These comments are saved when the dialog is closed with the OK button, and are displayed in the Task Comments Pane. Metadata to PDI The Metadata to PDI task takes the active metadata and generates a PDI using the information in that metadata.
l Index Group: l l PDI: Only generate a PDI file. PDI and XML: Generate both the PDI and an XML equivalent (not used by PReS Search). On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification.
l l l l Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values.
l l l l All PlanetPress Design document templates must use the n-up object on both the front and the back pages of the duplex document. Each instance of the n-up object must have the “change data page with each repeat” option checked. The total number of repeats on each page (vertical X horizontal) must correspond to the number specified in the Number of virtual pages per physical page option..
ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output. The On Error tab can be used to overwrite the default behaviors. l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked.
error, the contents of the variables selected in this window will be available to the rest of your process, or as long as they are not overwritten. Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc.
Data Mapper Tab The Data Mapper tab generates a Record Set from a specific source: data mapping on the appropriate source (Current Data File, Database or PDF/VT data file), Retrieving items from the Connect Database (filter setting) or uses the current job Metadata. The resulting Record Set is given to the Content Creation part of the task.
l l l l l l l l Clear the rule: Click to delete all rules in the list. Note: This cannot be undone. Import a rule: Click to open the Browse dialog and load a Rules file. This will load its rules into the list. Export the rule: Click to open a Save dialog and save the Rules file to disk. Rule Viewer: Displays a text-based view of the condition using operators and parentheses. Sort contents: Defines how records are sorted.
Note Once the All In One plugin has been executed with this option selected, any task that attempts to access records in the database will fail. Content Creation Tab The Content Creation tab generates Content Items either by merging a Record Set with a Template, or by processing a PDF/VT file into individual content items. l Template: Select the appropriate template or option to execute it: l l l l "None" filename: Select to skip Content Creation completely. "%o": Select to use a dynamic template name.
Connect Proxy Tab This tab is common to all OL Connect tasks and defines where to process the jobs sent through these tasks. When these fields are empty, they use the defaults set in the OL Connect User Options page of the preferences. Note Defaults are not used unless the configuration is sent to the Workflow service. l OL Connect Proxy Address: Enter the machine name or IP Address where the OL Connect Server resides. l Port: Enter the port to use to communicate with the OL Connect Server.
iteration. l l l l l l l l Stop Branch: If the task is in a branch of the process, the branch is stopped and the job file is returned to the process after the branch. The branch will not produce any output. If the task is not on a branch, the entire process will be stopped. Stop Process: The process is stopped and no more processing is done. No further output is produced.
Sort Parameters The Search Parameters define how to sort the entities retrieved from the Connect Database using either the Retrieve Items task, or the Filter source in the All in One Action Task's Data Mapper task. l Sort items based on: Lists the different sorts to apply to the entities. l l l Name: Click and enter the name for the Value or the Property to sort on. Type: Select whether the Name option refers to a Property or a Value within the entity.
each recipient. Properties General Tab l Template l l l l "%o": Select to use a dynamic template name. Click on %o to change the expression that determines the name of the template to use. Template Names: Select the appropriate template. Adding template is done through the Send to Workflow option in the Designer Module. Update Records from Metadata: If the process metadata has been modified by any Metadata related task, check to use the updated metadata.
Note When no Sender Address is specified in both the Create Email Content task and the template, sending the email will fail with an error (W4240 - Invalid email address format for sender). l Use Authentication: Check to enable authentication to the SMTP server. l l l l Password: Enter the password for the above user name. Start TLS: Check to connect to the SMTP server using TLS (also called "SSL").
l Password: Enter the password expected by the OL Connect Server for the above user name. On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification.
l l l ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Note The result of a Retrieve Items task cannot be used with a Job Creation Preset. Use the IDs in the metadata instead (see the Properties below). Processing The task prepares the content items or content sets for printing, tagging them as printable. Only the content items that are part of the job will generate output. Output The task outputs a Print Job ready to be sent to the Create Output task for printing. Properties General Tab l Job Preset file: Select which Job Preset to use to generate the job.
l OL Connect Proxy Address: Enter the machine name or IP Address where the OL Connect Server resides. l Port: Enter the port to use to communicate with the OL Connect Server. Default: 9340 l User name: Enter the user name expected by the OL Connect Server. l Password: Enter the password expected by the OL Connect Server for the above user name. On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723.
l l l l l Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message. Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file.
Processing The job is sent to the OL Connect Server for processing. Output Depending on the options set, either a simple metadata file with information about processing is returned, or the actual output file created by the server. Properties The Create Output action task properties are as follows: General Tab l Output Preset file: Select which Output Preset to use to generate the output.
Note Defaults are not used unless the configuration is sent to the Workflow service. l OL Connect Proxy Address: Enter the machine name or IP Address where the OL Connect Server resides. l Port: Enter the port to use to communicate with the OL Connect Server. Default: 9340 l User name: Enter the user name expected by the OL Connect Server. l Password: Enter the password expected by the OL Connect Server for the above user name. On Error Tab The On Error tab is common to all tasks.
l l l l l l l Stop Process: The process is stopped and no more processing is done. No further output is produced. Log Message: Check this option to enable logging a custom error message in the PReS Workflow log file and in the Windows Application Events. Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message.
Input Any data file supported by the selected PReS Document. Processing The input data file is merged with the selected PReS Document. Output The output is a PDF/VT with default quality settings. The metadata embedded within the PDF/VT is the one generated by the PReS Document.
l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
to use. l Alternatively, select a configuration name. Adding configurations to this list is done through the Send to Workflow option in the Designer module. Click the Open data model of selected configuration button to view the data model attached to the chosen configuration in the DataMapper module, to verify that the right one is used. Note When the data mapping configuration provides multiple records, the preview is created based on the first record.
Note The Metadata option requires that entries in the metadata have matching field names in the data model of the template. When they have, the values are passed to the template and the personalization scripts of the template will have access to the values through the record's data fields. (See the Designer help: Adding Variable Data). Using JSON In web environments, it is common to send and retrieve data from a server using an AJAX request (typically invoked from within a JavaScript).
A JSON string containing a local variable and various lookups: { "jobid":"%{jobid}", "account":"lookup(OLCS_jobs, account, jobid, '%{jobid}')", "datafile_name":"lookup(OLCS_jobs, datafile_name, jobid, '% {jobid}')", "pages":"lookup(OLCS_jobs, pages, jobid, '%{jobid}')", "documents":"lookup(OLCS_jobs, documents, jobid, '%{jobid}')", "recordsetid":"lookup(OLCS_jobs, recordsetid, jobid, '%{jobid}')" } An example where the entire JSON string is provided in Job Info 1: %1 A JSON string constructed with informati
OL Connect Proxy Tab l Server Connect Settings l l l l Connect Proxy Address: Enter the machine name or IP Address where the OL Connect Server resides. Port: Enter the port to use to communicate with the OL Connect Server. Default: 9340. User name: Enter the user name expected by the OL Connect Server. Password: Enter the password expected by the OL Connect Server for the above user name. On Error Tab The On Error tab is common to all tasks.
l l l l l l Log Message: Check this option to enable logging a custom error message in the PReS Workflow log file and in the Windows Application Events. Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message. Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID.
Input This task can receive either the information regarding a valid Record Set (which can be the output of the Create Record Set task, or a Record Set retrieved using the Retrieve Entities task) or a PDF/VT File. Processing In the case of a record set and template, this task loops through each record in the Record Set. For each record, an one or more pages are generated using the record's data and these pages are saved as a content item in the database.
Connect Proxy Tab This tab is common to all OL Connect tasks and defines where to process the jobs sent through these tasks. When these fields are empty, they use the defaults set in the OL Connect User Options page of the preferences. Note Defaults are not used unless the configuration is sent to the Workflow service. l OL Connect Proxy Address: Enter the machine name or IP Address where the OL Connect Server resides. l Port: Enter the port to use to communicate with the OL Connect Server.
iteration. l l l l l l l l Stop Branch: If the task is in a branch of the process, the branch is stopped and the job file is returned to the process after the branch. The branch will not produce any output. If the task is not on a branch, the entire process will be stopped. Stop Process: The process is stopped and no more processing is done. No further output is produced.
Create Web Content The Create Web Content action task generates the output of the HTML Context of a specified template and returns the HTML code to PReS Workflow for further processing and return to the requester. Generally, this task is placed within an HTTP Server Workflow. Input This task must receive the information regarding a valid Record Set. This can be the output of the Create Record Set task, or a Record Set retrieved using the Retrieve Entities task.
l Update Records from Metadata: If the process metadata has been modified by any Metadata related task, check to use the updated metadata. Otherwise, only the ID of the current job is sent, and the metadata on the Server is used. Connect Proxy Tab This tab is common to all OL Connect tasks and defines where to process the jobs sent through these tasks. When these fields are empty, they use the defaults set in the OL Connect User Options page of the preferences.
l l l l l l l l l Default: By default, the task is ignored as if it did not exist and the error is logged before continuing the branch or process; the job file is passed on to the next task in the process. When an error occurs in a loop (or in a plugin that acts like a loop), the loop may log the error, terminate the current iteration and proceed with the next iteration.
Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task. These comments are saved when the dialog is closed with the OK button, and are displayed in the Task Comments Pane. Execute Data Mapping The Execute Data Mapping action task generates a record set by executing a data mapping configuration on a data source. It can also automatically create a record set from a PDF/VT file without using a data mapping configuration.
Properties General Tab l l l Data mapping configuration: Enter the full path to a valid data mapping configuration (.oldatamapper) file, or use the Browse button to find the path. Data Source or PDF/VT file: Enter the full path to a valid data source compatible with the above data mapping configuration or a PDF/VT file, or use the Browse button to find the path. Output Type group: l l l Output IDs in Metadata: Select to only output the Record and Job IDs in the metadata.
l Password: Enter the password expected by the OL Connect Server for the above user name. On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification.
l l l ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Output The same metadata that is input. Properties l Set types to mark for deletion based on metadata content: l l l Job Set: Tag any Job set created by the Create Job task or the Retrieve Items task set to retrieve Job Sets. Content Set: Tag any Content set created by the Create Print Content task or the Retrieve Items task set to retrieve Content Sets. Record Set: Tag any Record set created by the Execute Data Mapping task or the Retrieve Items task set to retrieve Record Sets.
ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output. The On Error tab can be used to overwrite the default behaviors. l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked.
error, the contents of the variables selected in this window will be available to the rest of your process, or as long as they are not overwritten. Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc.
On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output.
l l Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Workflow processes in Connect Send For help on the configuration of Workflow processes in a Connect Send solution, see Workflow processes in a Connect Send solution. Job Processor The Job Processor plugin is an output plugin that appears in the Plug-in Bar of Workflow under OL Connect Send. Input The Job Processor plugin must be added to a Workflow job transfer process that starts with an HTTP Server Input. The Job Processor plugin is the only other task in that process.
If OL Connect Send is unlicensed, the plugin stores the incoming job in the target folder using the specified file name, but it does not save any information in the database. The end user will receive a message in the Notification Area (also called "system tray") confirming the unlicensed status, and the printer driver will not request another web page. In licensed mode, the plugin will store all relevant information about each job in the OL Connect Send database.
Database connection The Job Processor plugin works with a database to store all relevant job information. This database is a HyperSQL Database (HSQLDB, see https://en.wikipedia.org/wiki/HSQL_ Database_Engine). It is installed as a service with the name OL Connect Send DBServer (the internal service name is OLCSServer). Communication between the plugin and the database occurs using port 9001 (the default port for HSQLDB).
Note If no extension is defined by the user for the file name, the default “.ps” extension is added automatically, as the incoming print jobs are PostScript files. Workflow variables Variables can and should be used to create dynamic file and folder names for each print job. This enables separating licensed and unlicensed jobs and/or storing the files by domain, machine and even user name.
l Plug-in Information l l License: Shows whether a license for OL Connect Send could be found. If not, OL Connect Send will be running in unlicensed (default) mode. Protocol version: Here the plugin shows which protocol version is used. The OL Connect Send components communicate with each other by using a well-defined and versioned protocol. As long as these components use the same protocol version, the job transfer will work even if the plugins themselves are changed.
l l l l l l l Stop Process: The process is stopped and no more processing is done. No further output is produced. Log Message: Check this option to enable logging a custom error message in the PReS Workflow log file and in the Windows Application Events. Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message.
The plugin appears in the Plug-in Bar of Workflow under OL Connect Send. Typically, it is used in the OL Connect Send interaction process, just after the initial HTTP Server Input plugin. The Get Job Data plugin gets all relevant information for the dedicated print job using the Unique Job ID. Whenever an OL Connect Send Printer Driver is sending a print job to the OL Connect Send Job Processor plugin, it creates a unique ID string composed from 10 upper- and lowercase letters and digits e.g. “ri0zZdluLp”.
processing. l Read from Variable: When selecting this option, any existing Workflow variable can be chosen via the drop-down field. In this case, the plugin reads the Job ID from that variable. Select Returning Type Depending on this setting the plugin gets status information about the job before it has arrived or it gets information after the job has been completely received.
l l Job UID: This is the 10 (ten) character long Unique Job Identifier string. Date/Time stamp: This is the time when the matching job was initially created in the database. It is stored in UTC format plus time zone indicator inside the database. It will differ from the time stamp logged by the OL Connect Send Printer Driver as well as by the OL Connect Send Job Processor. Note The Printer Driver machine time stamp in the Printer Driver log may significantly differ from this value.
l l l Domain / Workgroup Indicator: This domain name is the real domain name or only a workgroup name. For explanations about domains, domain names, users, user names, user domains, logged on users vs. application running users, machine names etc. please refer to the respective Windows help pages or ask your system administrator. Machine name: The name of the machine the OL Connect Send Printer Driver is running on as retrieved by the respective Windows API.
l l l l l Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message. Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file.
Note The Get Data plugin gets data from the OL Connect Send database which means it only works when Connect is in LICENSED mode. Properties General Tab Filter options Filters are required for: l Start and end date (down to minutes) l Domain(s) l User(s) l Machine name(s) Except for start and end dates, it is possible to pass a list of multiple search criteria, separated with semicolons, containing: l Workflow variables l Job variables l Names.
Example 1 A valid user name search string, entered in the Filter Users field, would be: %\{global.User};helen;%1;george napier This would look for all entries, where the user name is either: l as currently stored in the global Workflow variable User l "helen" l as stored in the job variable number 1 l equals "george napier" (case insensitive). These search criteria are combined with OR. Example 2 The domain name entered in the Filter Domains field is objmtl.objectiflune.
and minute is a colon) It is possible to define the same date for From Date/Time as for To Date/Time. However, entering the same info (without time information) would lead to getting no entries.
Returned information For each job received by the OL Connect Send Job Processor plugin the following values will be available. l l Job UID: This is the 10 (ten) character long Unique Job Identifier string. Date/Time stamp: This is the time when the matching job was initially created in the database. It is stored in UTC format plus time zone indicator inside the database. It will differ from the time stamp logged by the OL Connect Send Printer Driver as well as by the OL Connect Send Job Processor.
l l l l l Original file size: The size of the print job - NOT the size of the document file. Domain (workgroup) name: The name of the domain or workgroup the printing user belongs to. This is not necessarily the name of the domain the machine itself belongs to. Domain / Workgroup Indicator: This domain name is the real domain name or only a workgroup name. For explanations about domains, domain names, users, user names, user domains, logged on users vs. application running users, machine names etc.
l l l l l l l Stop Process: The process is stopped and no more processing is done. No further output is produced. Log Message: Check this option to enable logging a custom error message in the PReS Workflow log file and in the Windows Application Events. Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message.
together. Since this task can retrieve items at any level, it can be used to generate metadata used in multiple tasks. Input The task requires no input file, but any input information such as metadata, job information or data file can be used to specify which items to retrieve. Processing The task requests the items on the OL Connect Server using the conditions set in the task properties. Only the condition information and the return metadata are exchanged.
l l l l l l l Switch conditions: Click to swap two conditions on the same level, or two groups of conditions. Delete the selected condition: Click to delete the currently selected conditions in the list. Clear the rule: Click to delete all rules in the list. Note: This cannot be undone. Import a rule: Click to open the Browse dialog and load a Rules file. This will load its rules into the list. Export the rule: Click to open a Save dialog and save the Rules file to disk.
often used to separate mail routes, provinces, or cities. l Sort items based on: Use the [...] to open the Sort Parameters dialog and define how documents are sorted within the group, for example by Zip Code. Connect Proxy Tab This tab is common to all OL Connect tasks and defines where to process the jobs sent through these tasks. When these fields are empty, they use the defaults set in the OL Connect User Options page of the preferences.
l l l l l l l l l Default: By default, the task is ignored as if it did not exist and the error is logged before continuing the branch or process; the job file is passed on to the next task in the process. When an error occurs in a loop (or in a plugin that acts like a loop), the loop may log the error, terminate the current iteration and proceed with the next iteration.
Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task. These comments are saved when the dialog is closed with the OK button, and are displayed in the Task Comments Pane. Pick Parameters The Search Parameters define how the to pick entities retrieved from the Connect Database using the Retrieve Items task and place them together in Documents or Groups. Items are picked using either Properties or Values.
(such as record-level properties), the Metadata should be split using the Metadata Sequencer task first. Output The task outputs metadata that is identical to the input Metadata. Only the entries on the OL Connect Server side. Properties General Tab l l Entity: Use the drop-down to select the entity type of which to set the properties.
l l User name: Enter the user name expected by the OL Connect Server. Password: Enter the password expected by the OL Connect Server for the above user name. On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification.
l l l l Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values.
PReS Image output task, PReS Workflow considers its job done once it has sent its request to PReS Image, not once PReS Image has finished generating the actual image file. Other tasks available in PReS Workflow can be used to generate output, such as Digital Action, Create VDX and PrintForm action tasks. Unlike output tasks, action tasks are only considered completed once the output file has been generated.
l Capture Web Manager Workflow On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723. By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output.
l l l ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file. Store the ID in variable: Select in which jobinfo, local or global variable you want to store the error ID. Reset to defaults: Resets all options in this tab to their default values. When storing the message or ID, if they are stored in a jobinfo they will be available in any error handling process where errors are being forwarded.
Properties General tab l FTP Server: Enter the IP address or host name of the FTP server. l Port number: Set the plugin to use a specific port number. l l Use FTP Client default port number: Use the value as specified in the Preferences (port 21 is the default value). FTP Port: Enter the specific port number to use when Use FTP Client default port number is unchecked. Enter a value between 1 and 9999. Note: There is no validation to ensure the port is available.
l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
In the case of "string" type data, SOAP Client plugin tasks normalize all line endings to a single line feed character. Properties General tab l WSDL address: Enter the URL address of the WSDL file, or choose a previously selected address from the drop-down list. Note The WSDL Address of a PReS Workflow SOAP server is the following: http://127.0.0.1:8080/wsdl/isoapact (assuming you are on the same machine and did not change the default HTTP port).
l l l Value: Lets you enter fixed or variable values. To exchange variable information between the Web service and PReS Workflow, you must use job information variables %1 to %9 or variable %c (which contains the entire job file). Note that return values (arguments which are used to return information to the SOAP Client) are displayed in bold font. Namespace: Displays the namespace of the arguments associated with the selected method.
the process. When an error occurs in a loop (or in a plugin that acts like a loop), the loop may log the error, terminate the current iteration and proceed with the next iteration. l l l l l l l l Stop Branch: If the task is in a branch of the process, the branch is stopped and the job file is returned to the process after the branch. The branch will not produce any output. If the task is not on a branch, the entire process will be stopped.
with the OK button, and are displayed in the Task Comments Pane. Print Using a Windows Driver Printing Using a Windows Driver output tasks are used to send jobs to a local or network printer without going through a PReS Workflow printer queue. Since the printer driver itself is not necessarily postscript, we cannot optimize the print file, so using a Windows Driver Output will always generate a larger and slower print job. However, this output can work with nonpostscript printers such as HP PCL printers.
Windows print driver, which takes the relay for the actual printing part, so there is no way for your PReS Workflow Tool to ensure that all the settings you make will be applied to the printed document. l l Job name: Enter the job’s file name. By default, the variable %f (Job File Name) is used. You may use a different variable, but you may not use a data selection. This information may be used for the printer’s banner page. Job owner name: Enter the job owner name. You may use a PReS Workflow variable.
By default, any action task, branch, splitter or condition that generates an error will simply be ignored, and the task just under it (not within a branch) will be given control of the job file without any modification. Any initial input task that generates an error will stop the process from running as a whole, and output tasks will not generate output. The On Error tab can be used to overwrite the default behaviors.
error, the contents of the variables selected in this window will be available to the rest of your process, or as long as they are not overwritten. Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc.
Folder output will simply place the file in the destination. Sending this same file to an LPR or WinQueue output will produce no output as these queues expect valid PostScript. Properties General tab l l Queues: Select the queues to which you want to send the output. Documents: Select None if you want the data to print as is. Select a specific PlanetPress Design document if you want all the jobs to be printed with that document.
corresponding to each printer’s capacity (as set in the PReS Workflow Printer Queue Options dialog box—See "Print Using a Windows Driver" on page 577) will be sent to each one of the selected printer queues. If two queues were selected, the first one sending jobs to a printer that prints 500 pages a minute, and the second one sending jobs to a smaller printer printing 50 pages a minute, the first queue will receive roughly ten times more pages than the second one.
l l l Send to Process: Check this option to send the job file to an error management process. Error Process drop-down: Enabled only when the Send to Process option is checked. Lists any process of which the initial input task is the Input Error Bin task. Action: In the initial input tasks, this group is disabled and defaults to Stop Process.
Common Errors Though some error messages are specific to a task in particular, others may apply to any and all tasks because they are related more to the system than to PReS itself. Some examples would be W3813, W3830, W3991, W4005. These correspond to issues such as not having any space to write files, permission errors on folders or files, etc. Comments Tab The Comments tab is common to all tasks. It contains a single text area (Task comments) that lets you write comments about the task.
Properties Recipients tab l l l l l To: Enter the email address(es) of the recipient(s). Remember this is a variable property box and you can therefore use various schemes to use email addresses that change with each job at run-time. Cc: Specify addresses to which copies of the generated emails are to be sent. Bcc: Specify discreet addresses (other recipients will not be able to see these addresses) to which copies of the generated emails are to be sent.
l l l l l l File: Select additional files to include as attachments. You may enter the file name directly and use text, variables and data selections. You may also use the Browse button to navigate and select the file. To add the file to list displayed in the Attach box, you must the click the downward pointing arrow button. Attach: Lists the files that will be attached to the messages sent from PReS Workflow for this task.
l l l l l Outgoing mail (SMTP): Enter the IP address of the mail server PReS Workflow is to use to send emails via SMTP. Port: Specify the outgoing SMTP Port if it is different from the default port (25). Server requires authentication: Select if the outgoing server mentioned above requires authentication. To use authentication you must enter information in the Account name and Password boxes below.
l l l l l l l l Stop Branch: If the task is in a branch of the process, the branch is stopped and the job file is returned to the process after the branch. The branch will not produce any output. If the task is not on a branch, the entire process will be stopped. Stop Process: The process is stopped and no more processing is done. No further output is produced.
Send to Folder Send to Folder output tasks send the files they receive to a local folder. They perform the same function as Send to Folder action tasks, with the only difference being that in this case, PReS Workflow will not wait for the task to be completed before going on to the next task in the configuration. The following describes the properties specific to Send to Folder output tasks.
This feature is part of the PDF Tools, which is only available in PReS Workflow. l Separator string: This option is used to add a separator string between the content of each file when the Concatenate files option is selected. On Error Tab The On Error tab is common to all tasks. Details can be found in the" Task Properties Dialog" on page 723.
l l l l l Message: Enabled only when the Log Message option is checked. Enter a message that will be logged in the PReS Workflow log file. You can use any variables available in PReS Workflow to customize the message. Store the message in variable: Select in which jobinfo, local or global variable you want to store the message content. ID: Enter an error ID. This ID will be visible in the Windows Event Viewer. However, the ID is not visible in the PReS Workflow log file.
l l l Global Variables are available by all processes and tasks within the configuration, and any modification made to them affects all tasks and configurations. For more information see "Manipulate Global Variables" on page 632. Local Variables are specific to an instance of a process. That is to say, when a process changes the information in a local variable, it changes it only for that process and only for that specific instance of the process.
You can set the value of a job info within your process in two ways: l l Use the Set Job Info and Variable action task. See "Set Job Infos and Variables" on page 332. You can use Scripts. See the chapter "Using Scripts" on page 87. Considerations on Job Infos: l l l While the initial job infos are created by the input task, they can be overwritten by the Set Job Info and Variables Action Task, by a Script, or by any secondary input task in the process.
Variable Name Example value when interpreted including the file extension. %z Job File Size in bytes. 34134 %o Original File Name invoice_june2nd.
Variable Name Example value when interpreted %h Current Hour 18 %n Current Minute 03 %s Current Second 41 %v Current Millisecond 24 %u Unique 13char string (will be different every time it is used) 0ZIS4CW8U47VI00 %t Current Temporary Folder C:\Documents and Settings\All Users\Application Data\Objectif Lune\PReS Workflow 7\PlanetPress Watch\Spool\6.tmp\ %e Current Metadata Filename job00ZAIZ2C4FXON16CE6C566.dat.meta %E Current Metadata Path and Filename C:\Documents and Settings\Al
Variable Name Example value when interpreted Iteration Index (always the innermost loop) The %i Loop Count Variable In version 7.4, the %i variable is introduced. Its value is equivalent to the current iteration of loops inside of a process. It always contains the value of the innermost loop, and only certain tasks trigger the counter to start. Here is an example process and the value of %i during this process: Initial input tasks do not modify the value of %i.
l Get Capture Document l Loop l Capture PGC Splitter l PrintShop Mail Error Handling Variables The following variables are available in error-handling tasks (that start with the Error Bin Input task). Note that these are new in PReS Workflow 7.4 and are not available in previous versions. Variable Name % {error.process} Name of the process where the error was triggered % {error.tasktype} The type of task that triggered the error % {error.
Manipulate Local Variables Note For information about Global Variables see Global Variables. Local Variables are set at the level of the Process and are not shared with any other process or instance of that process. Local variables can be used anywhere that accepts variables by using it's namee, surrounded by curly brackets and preceded by a percent sign (for example: % {myLocalVariable}).
l Right-click on the variable name in the Configuration Components Area. l Click Rename l Type in the new name of the variable, then press Enter on your keyboard. While renaming a variable will correctly rename all references to it in task properties or wherever else it is used in a task, it will not change the references in any script within a Run Script task. Deleting a variable, on the other hand, does not delete any reference to it.
To add a global variable from the Configuration Components pane: 1. Right-Click on Global Variables. 2. Click Insert, then Insert Global Variable. The new variable will appear as GlobalVar or GlobalVarX (the name is automatically incremented). To add a global variable from the Ribbon: 1. Click on the Home tab of the PReS Workflow Ribbon. 2. Click Global Variable in the Variables group. The new variable will appear as GlobalVar or GlobalVarX (the name is automatically incremented).
Script task. Deleting a variable, on the other hand, does not delete any reference to it. In both the case where a script refers to a variable and it is renamed, or in the case of deleting a variable, any task or script that refers to it will cease to function and will generate an error. You can set the value of a variable within your process in two ways: l l Use the Set Job Info and Variable action task. See "Set Job Infos and Variables" on page 332. You can use Scripts.
l For information about Global Variables, see "Working With Variables" on page 591. Create a New Configuration When you start PReS Workflow, it always opens the configuration file that is active on the PlanetPress Watch service. If you create a new configuration, PReS Workflow automatically creates a process that includes a "Folder Capture" on page 199 initial input task and a "Send to Folder" on page 589 output task. You can then edit and save your new configuration.
Note You can also open a configuration file from a previous version of PReS Workflow by changing the File Type selector to the desired version (for example, .pw6 for PlanetPress Watch /Server configurations from Version 6) Saving and Sending Saving and Sending a Configuration The core of the PReS Suite workflow tools is the PReS Watch service which, once started, constantly runs in the background to perform the tasks included in its current configuration file.
Sending a Configuration PReS Workflow Configuration saves entire configurations in the form of a single file. Like any other file, configuration files may be saved and reopened, as well as rename as desired. Simply saving a configuration has no effect on the configuration actually used by the PReS Workflowwhen it is started. To change any currently active configuration, you must use the Send Configuration command.
and restart. Since PReS Workflow service reads its configuration file when it starts up, when you resume processing, PReS Workflow service will continue using the old configuration. Exit PReS Workflow Configuration Program Once you are done using PReS Workflow, you can close the configuration program. It is important to note that closing PReS Workflow Configuration Program does not stop any of PReS Workflow services or stop processing.
About Related Programs and Services Services are programs that run in the background and automatically perform tasks that often do not require any user interaction. With the exception of PReS Workflow Configuration, all the programs used by PReS Workflow are run as service applications. PReS Workflow can thus use them as required without the need for any user interaction.
l l l l l l LPR (Line Printer Requester) Output service: Sends jobs to an LPD server or LPD compatible printers. The LPD/LPR printing protocol is a common way to send print jobs that, in turn, use the TCP/IP protocol to communicate through the network. PReS Image: Outputs jobs as PDF files or in a variety of image formats. You can also use PReS Image to archive and/or email the files it creates. You can use PReS Search to search the PDF files PReS Image creates.
Start and Stop PReS Workflow Service As with most Windows services, PReS Workflow can be started and stopped automatically when a Windows session is opened and closed. The other option is to start, stop or pause PReS Workflow manually using the PReS Workflow Configuration program. Note The current PReS Workflow status is always displayed in the lower-right corner of the PReS Workflow Configuration program window. To start PReS Workflow services via PReS Workflow Configuration program: 1.
Note If you send a new configuration when PReS Workflow is paused, it will continue using the old configuration when you resume processing until you stop and restart it. To resume your PReS Workflow service after pausing it: 1. Click Tools in the PReS Workflow Ribbon. 2. Click Resume in the Services Status group. The PReS Workflow Tool service starts performing jobs again.
The Interface This chapter centers on the PReS Workflow Configuration program, which you use to create and edit your configurations. The basic user interface elements are as follows: 1. The PReS Workflow button. See "PReS Workflow Button" on page 619. 2. The Quick Access Toolbar. See " The Quick Access Toolbar" on page 730. 3. The Ribbon Tabs. See "The PReS Workflow Ribbon" on page 731.
4. A Group within the Ribbon 5. The Process area. See " The Process Area" on page 719. 6. A specific link (aka a "component", "button" or "link"). 7. The Dockable panels including "The Plug-in Bar" on page 675, " The Object Inspector Pane" on page 674 and "The Debug Information Pane" on page 672. 8. The status bar. This displays your current software version and status of the PReS Service. 9. The Configuration Components pane. See "The Configuration Components Pane" on page 621. 10. The Messages Pane.
The Configuration Components pane, the Object Inspector and the Messages area can each be displayed inside its own window, whether docked or undocked, but they can also be displayed attached or combined inside the same window. l l l When separate areas are displayed simultaneously, they appear in different sections of the Program window. When attached areas are displayed simultaneously, they appear side-by-side or above one another inside sub-windows.
Show or Hide Areas of the Program Window You can choose to hide or display any of the customizable areas in PReS Workflow program. Hidden areas will still contain the same information but will not be visible. To show or hide a Program window area: l In the PReS Workflow Ribbon, click the View tab. l From the Show/Hide group, click on any area name to hide or display it. A "highlighted" (orange) button means the area is displayed somewhere on your screen(s). A dim (blue) button means the area is hidden.
button when the shape of a tab appears at the bottom of the rectangle. To switch between combined area: l At the bottom of the combined area, click the tab of the area you want to bring to the top. If all the tabs are not displayed, use the left and right arrows to navigate between them. The left and right arrows lets you show hidden tabs.
To take an area out of a combined area, do one of the following: l l Click the tab displaying the name of the area you want to take out and move the mouse pointer so as to drag the area away from the combined area. As you drag, a rectangle is displayed to show the landing position. Release the mouse button when the rectangle is away from the combined area. Double-click the tab of the area you want to take out of the combined area. The area will jump outside of the combined area. To attach areas: 1.
3. Resize each part of the new group as desired. Attaching an area to a group of combined areas. The rectangle showing the landing position is not tabbed and the area will therefore be moved next to the combined area. To maximize or restore attached areas, do one of the following: l To maximize a vertically attached area, click the upward pointing arrow on its title bar. l To restore a vertically attached area, click the downward pointing arrow on its title bar.
Page 617
A) Click to maximize this area. B) Click to restore this currently maximized area. C) Click to maximize this area. D) Click to restore this currently maximized area. To take an attached area out of a group, do one of the following: l l Click the title bar displaying the name of the attached area you want to take out and move the mouse pointer so as to drag the area away from the group. As you drag, a rectangle is displayed to show the landing position.
To change the language used by the PReS Workflow Configuration program: 1. Click the PReS Workflow button, then click Select Language. The Select Language dialog box appears. This box lists all the languages that can be used by PReS Workflow as well as the Use System Default Locale check box. 2. Select the desired language. 3. Use System Default Locale: Select to mirror your language settings, as defined in the Regional and Language Options of the Windows Control Panel.
l l l Save: Saves the current configuration. If the file is new and has not yet been saved, or if the configuration is the loaded directly from the service, the Save As dialog is displayed instead. See "Saving and Sending" on page 603. Save As: Saves the current configuration under a new name. It does not overwrite any existing configuration file, unless an existing file is selected and overwritten manually by the user.
The Configuration Components Pane The Configuration Components pane displays processes, subprocesses, variables, documents and printer queues. It also lets you add any of these components using the rightclick menu. Components Area Sections l Processes: Displays a list of processes in your configuration. Right-click on a process to access a drop-down menu that offers these choices: l l Insert Startup Process: Inserts a new process as a Startup Process.
l l Group, Ungroup: Triggers grouping functionality. l Properties...: Displays the process' properties for error handling. Global Variables: Displays a list of variables that are shared between all your processes. Right-click on a Global Variable to access a drop-down menu that offers these choices: l Insert Global Variable: Creates a new global variable l Cut, Copy, Paste: Controls the clipboard. l Delete: Deletes the global variable from the configuration.
l PPS/PSM Documents: Displays a list of PReS Connect and PrintShop Mail Design document that have been imported into PReS Workflow. Right-click on a document to access a drop-down menu that offers these choices: l l l Cut, Copy, Paste: Controls the clipboard. Delete: Deletes the document from the configuration, as well as the Workflow Tools Working Folders. l Refresh: Regenerates a PostScript Cache from the original document's PTK file. l Group, Ungroup: Triggers grouping functionality.
Processes and Subprocesses The Processes component displays a list of processes in your configuration while the Subprocesses component displays a list of subprocesses. Process Properties To have access to the properties of a process or subprocess: l Right-Click on the Process in the Configuration Components Area. l Select Properties. You can also double-click on the process to show its options.
l l l l l As soon as possible: Select to have the process run continuously. Clear to enable the Time Grid to fine-tune the schedule of the process. Day(s) to keep backup: Indicate the number of days to keep backups of jobs processed by input tasks. Note that backups will only be kept for those input tasks that have the Keep backup file option selected and that they are required to resubmit input files.
The Time Grid The PReS Workflow Process Options dialog box includes a time grid that lets you set exactly when you want a process to run. The grid is composed of blocks that represent time periods on a given day. To activate the Time Grid, the "As soon as possible" option must be unchecked. In the Time Grid, a blue block will indicate that the process is active within that time block. While blocks mean the process will not be active.
l Click on any block to select / deselect it. l Click and drag from one block to another to toggle all blocks between the two. l Shift-click on any block to toggle all blocks from the top-left corner of the grid to the block you click.
l l l To select all of the time segments for a given day or date, click the day or date on the top grid ruler. To deselect all of the time segments for a given day or date, CTRL+click the day or date on the top grid ruler. To select all the days or dates for a given time segment, click the time segment on the left grid ruler. To deselect all the days or dates for a given time segment, CTRL+click the time segment on the left grid ruler.
Create a New Process You can create a new process in a two different ways: l l In the Ribbon, go to the Home tab and click the Process button in the Processes group. In the Configuration Components pane, right-click on any process or the Processes folder and select Insert Process. Regardless of the method, a new process is created with a default name (Process1, Process2, etc), Input Task and Output Task. The defaults are configurable in the "Default Configuration behavior preferences" on page 681 screen.
Manipulate Local Variables Note For information about Global Variables see Global Variables. Local Variables are set at the level of the Process and are not shared with any other process or instance of that process. Local variables can be used anywhere that accepts variables by using it's namee, surrounded by curly brackets and preceded by a percent sign (for example: % {myLocalVariable}).
l Type in the new name of the variable, then press Enter on your keyboard. While renaming a variable will correctly rename all references to it in task properties or wherever else it is used in a task, it will not change the references in any script within a Run Script task. Deleting a variable, on the other hand, does not delete any reference to it.
Convert a Branch to a Subprocess To allow for maximum flexibility and backward compatibility with the subprocess feature, the Convert to subprocess option lets users transform existing processes easily. This option is available whenever a Branch task is selected; right-clicking on it will display the contextual menu, which holds the Convert to subprocess option.
it's name preceded by "global." and surrounded by curly brackets (for example: % {global.myGlobalVariable}). Global variables are generally used to keep information that applies to multiple locations but need to be changed easily. For example, a lot of uses use them to set a server's IP, a printer name, or folder location that is used by multiple processes.
l Right-click on the variable name in the Configuration Components Area and click Delete. To rename a variable: l Right-click on the variable name in the Configuration Components Area. l Click Rename l Type in the new name of the variable, then press Enter on your keyboard. While renaming a variable will correctly rename all references to it in task properties or wherever else it is used in a task, it will not change the references in any script within a Run Script task.
Internet Explorer). l l l l Sample Data File(s): Displays a list of sample files that are included in the data mapping configuration. Double-click on a file to use it as a sample data file for the active process. Document Templates: Displays a list of templates that can be used in content creation tasks: "Create Email Content" on page 509, "Create Web Content" on page 531 and "Create Print Content" on page 527.
l outputcreation contains archives of the Output Presets (.OL-outputpreset) l template contains archives of the templates (.OL-template) l workflow contains archives of Workflow configurations received by the server. The archives are saved using the template named followed by a timestamp. A maximum of 30 of each instance of a resource is kept (meaning if you have 10 different templates, a maximum of 300 files will be present in the archive\template folder).
Document Properties Options Identification Tab The information here is read-only and gives you information on the document. l l l Document: The file name of the document, as entered in PlanetPress Design. This is the name of the file saved in PlanetPress Design, or the name you give it when you add a printer-resident document in your PReS Workflow Configuration. It may have a PTK extension (if it has been sent to PReS Workflow from PlanetPress Design), or a PS extension (if it is printer-resident).
l Document location group (enabled only when using Printer-Centric mode) l l l l l On printer hard disk: Select if the PlanetPress Design document is on the printer's hard drive. In printer flash memory: Select if the PlanetPress Design document is on the printer's flash memory. RAM: Select if the PlanetPress Design document is on the printer's RAM (Random Access Memory).
Data Files When sending a PlanetPress Design Document from PlanetPress Design to PReS Workflow, all data files used in the document are automatically sent to PReS Workflow along with the Design Document. These data files appear under the Documents section of the Configuration Components. To set an attached data file as a sample data file in a process: 1. Make sure the Documents section is visible by clicking the 2. Expand the document (name.ptk) by clicking the button if it appears. button. 3.
not appear in the Configuration Components but it follows the data file and can be viewed from the Metadata tab whenever the data file is viewed through the Data Selector. Use Attached Document Preview When sending a PlanetPress Design Document from PlanetPress Design to PReS Workflow, a PDF Preview of the job's output is automatically sent to PReS Workflow along with the Design Document. This preview appears under the Documents section of the Configuration Components.
To add a resident document in the Configuration Components pane: 1. In the PReS Workflow Configuration Components pane, click the Documents button and choose Insert | Resident Document. The Add Resident Document dialog box is displayed. 2. Enter the document’s name. Note that the name you enter must exactly match the actual document name or PReS Workflow will not be able to use it on the printer or remote PReS Workflow server. 3. Click OK.
To modify the settings of a document assigned to a printer queue: The settings available in this window are the same as the Printer Settings dialog of a document properties in the Documents list of the Configuration Components Area, but they are specifically for this document on this printer queue. See " View Document Properties" on page 636 for more details. l Double-click on the document located within a printer queue. The Document Properties dialog appears.
Copy Mouse Pointer Prohibited Mouse Pointer Moving Configuration Components Using Drag & Drop: l Click on the component and hold the mouse button. l Move the component to the location where you want to drop it. l Let go of the mouse button. Using the clipboard buttons: l Click on the component you want to move. l Go to the Home tab of the ribbon. l Click the Cut button in the Clipboard group. l Click on the new location where you want the component.
l Click on the new location where you want the component. l Do CTRL+V (paste) on your keyboard. Copying components You can make a copy of any component in the Configuration Components pane, with the only exception being Documents (of which you can only have one copy). Copying components is done using the same methods as moving them, with the following differences: l l To move components using the clipboard buttons and contextual menu, replace "Cut" by "Copy". Otherwise the methods are the same.
Rename Objects in the Configuration Components Pane You can rename processes, groups, and printer queues in the Configuration Components pane. PlanetPress Design Documents (ptk/ptz files) are different and cannot be renamed or modified using PReS Workflow. You can, on the other hand, change the name of printerresident documents. Note Names cannot begin with a number. They can only contain the following ASCII characters: underscore, upper and lower case letters of the alphabet, all digits 0 through 9.
To reorder selected objects in the Configuration Components pane: 1. Click an object or group. 2. In the PReS Workflow ribbon, go to the View tab then click Order in the Arrange group, then select one of the following: l l l l Up One Level to move the item one level up in the hierarchy. If the item is already the top object in the category, or within a group, this command has no effect. Down One Level to move the item one level down in the hierarchy.
To add a group in the Configuration Components pane: l In the Configuration Components pane, click a category and choose View | Arrange | Group. A new group is added at the end of the category. To add objects to an existing group: l Drag-and-drop the objects onto the group. The objects are added as the last objects in the group. To remove objects from a group: l Drag-and-drop the objects out of the group. The objects are removed from the group.
Delete Objects and Groups from the Configuration Components Pane To delete a process, document, or printer queue: l Click a process, document, or printer queue, then press DELETE. In the case of processes and printer queues, the object is deleted. If there is only one process in the configuration, you cannot delete it; there must be at least one process in the configuration. If you delete the last configured process, a process with two unknown tasks remains.
Note Printer activations are normally given to you by the activations department electronically, including a file that will automatically add all your printers in this dialog. To display the Activate a Printer dialog, click the button from the Help menu. The printer list displays the following information l l l License Number: Reference number of the activation, linked to your customer account. Magic Number: The magic number generated by the printer.
using a local or network account. The first time you start the PReS Workflow Configuration program, the application automatically asks you to choose an account (see procedure below). You can also manually start this procedure from the PReS Workflow Tools by following this procedure: 1. Click on the Tools tab in PReS Workflow Ribbon, then click Configure Services. 2.
3. Click OK. PReS Workflow applies the user account information to all the services (PReS Workflow, PReS Fax, PReS Image, LPD input, Serial input, Telnet input, FTP output, LPR output), that run on this computer (with the exception of PReS Messenger, which always runs under the Local System account). The PReS Workflow Configuration program does not test user names and passwords, but merely associates them with the services that require them.
l l l l l l l Self-Replicating Process: Check this if you want the process to replicate itself in the background when multiple input files are received simultaneously. When this is checked, the input task polls its source once, determines the number of files to process, then replicates itself up to the maximum allowed and treats the files simultaneously. The initial process runs again once it has completed itself and replicates again as necessary, until all files have been processed.
third or fourth week. l l l Select Last to have the process run only on the last week. Time division: Select the duration of each daily segment in the time grid. If you select 00:15, each segment will represent only 15 minutes and each day will be made up of 96 blocks (4 blocks per hour times 24 hours). If you select 24:00, each segment will represent an entire day.
l Click on any block to select / deselect it. l Click and drag from one block to another to toggle all blocks between the two. l Shift-click on any block to toggle all blocks from the top-left corner of the grid to the block you click.
l l l To select all of the time segments for a given day or date, click the day or date on the top grid ruler. To deselect all of the time segments for a given day or date, CTRL+click the day or date on the top grid ruler. To select all the days or dates for a given time segment, click the time segment on the left grid ruler. To deselect all the days or dates for a given time segment, CTRL+click the time segment on the left grid ruler.
Advanced SQL Statement Dialog The Advanced SQL Statement dialog is available by clicking the Edit SQL button from the Database Query action task. You can enter a custom SQL query in this dialog, using the language supported by the database you select in the Database Query action task. The dialog is separated in two parts: l The left part displays the available tables in your database. Click the Show Tables button to display them.
jobs to the server. Technical Messenger communications (between different part of the PReS Workflow) is limited to within the same Class C subnet. This means that PReS Workflow on 192.168.1.23 cannot send a job to a PReS Image on 192.168.100.54. This limitation has been removed in PReS Workflow 7.3 and higher. To open the Access Manager 1. Open PlanetPress Design. 2. In the Ribbon, go in Tools | Managers | Access Manager. The Access Manager dialog box is displayed.
Page 658
To manually add a new entry in the list l Open the Access Manager l Make sure you are in the Messenger tab. l In the IP address box, enter the IP address of the remote machine. l Click on the l Add the necessary permissions l Click OK l Restart the Messenger service. button.
l l l l 127.0.0.1: The local computer. Typically this IP should have all the accesses checked. 255.255.255.255: Everyone on the same subnet. This is equivalent to hard-coding the current subnet, such as 192.168.1.255 or 10.0.0.255. 192.168.0.42 : A single IP address. This can be any valid address on the same subnet. 10.0.255.255: Any IP in the 10.0.X.X range. To automatically detect machines on the network and add them 1.
continue processing after it has found an "Allow" checkmark. There is no concept of "Deny", meaning if any "Allow" permission is given, there is no way to later remove it for certain IPs or IP ranges. l l l The configuration of the Access Manager is saved in a file on the hard drive which can be edited manually. See Access Manager hosts.allow File. HTTP, FTP and SOAP communication is not limited to the local subnet on any version where these plugins appear.
SOAP Access The SOAP tab of the Access Manager controls access from SOAP clients to local processes and SOAP processes. Each user name entered in this dialog can have access to one or more processes. To add a new SOAP user 1. Click on the button. 2. Enter the following information under the Username column for the new entry that was created: l l User name: An alphanumerical user name for the user. Password: A password to protect the user.
l Administrator: Choose the permission type l l l User: Can access none, some, or all of the processes, selected individually in the Permissions section. Admin: Has access to all processes and features. When this option is selected, the Permissions section is grayed out an all options are selected in it. Disabled: Has access to nothing. The result is the same as not having this user defined at all, but has the advantage that a disabled user can be reactivated with a simple click. 3.
Technical The PDF Viewer is not currently standalone and cannot be used to display PDFs outside of PReS Workflow.
The PDF Viewer To open the PDF Viewer: In the Documents section of the Configuration Components pane, expand a document present in the list. Then, right-click on the document's Preview, and click Open in PDF Viewer.
The PDF Viewer is accessible through one of the following methods: l l l In the Documents section of the Configuration Components pane, expand a document present in the list. Then, right-click on the document's Preview, and click Open in PDF Viewer. Click View as PDF in the Debug toolbar. This will show the current data file in the viewer (assuming it is a PDF). If the viewer is opened during debugging, the current state of the PDF will be displayed (instead of the original data file).
To open the PReS Workflow Service Console via the PReS Workflow Configuration program: l Choose Tools | Service Console. A) The PReS Workflow services monitored by the PReS Workflow Service Console. B) The run-time information provided by the console. Note The log window only displays the 1000 most recent lines. Older lines are hidden as new ones appear to replace them. To view the log messages generated by a service: l Click the service in question in Services pane, on the left hand side.
To clear the Messages area of the PReS Workflow Service Console: l Click in the Messages area of the Service Console, and from the right-click menu choose Clear. To save the information from the Messages area of the PReS Workflow Service Console: 1. Click in the Messages area of the Service Console, and from the right-click menu choose Save to file. The Save As dialog box appears. 2. Navigate to a location, enter a file name, then click OK. The complete content of the Messages area is saved.
l Open PReS Workflow l Go to the Tools tab. l Click the Data Repository Manager button in the Managers group. Warning Any change made within the Date Repository Manager is immediate, and irreversible. Deleting data from this interface may impact running processes if such processes access the data saved in the repository. This includes clearing a group, or clearing the repository. Toolbar Buttons l Group section l l l l Add Key: Click to add a key to the currently selected group.
l l Management section l l l l l Refresh: Click to load any changes made to the repository since it was last opened or refreshed. Check Repository: Click to verify the integrity of the database, as well as reclaim any disk space from Clear Group Data: Click to delete all the KeySets in the currently selected group, leaving the key definitions intact. Warning: This action cannot be undone. Clear All Data: Click to delete every KeySet of every group in the Repository.
l Press CTRL+N to add a new item: l If a group is selected, will create a new group. l If a key is selected, will create a new key within the selected group. l If in the Group Key Sets, will create a new keyset. l Press F2 to rename a group or a key l Press Delete to remove Group or Key from the Repository, or a KeySet. Tip You can look up those shortcuts by right-clicking the item you want to interact with, and looking at the contextual menu.
The Debug Information Pane The Debug Information pane displays the current values of variables and other information useful in debugging processes (see "Debugging and Error Handling" on page 53). It is divided in 4 sections: l l l l Job Information: Displays the Job Info variables, as well as the job's file name, size, last edit date and presence of metadata (see "Job Info Variables" on page 592).
Warning Deleting an expression or clearing the expression list cannot be undone! The Message Area Pane The Messages area is used in Debug mode to indicate the status of your PReS Workflow process as the sample data file is processed and used to generate output. When your PReS Workflow runs in Debug mode, the Messages area displays useful processing and error information. Messages are displayed in different colors (debug levels) in the Message area.
The Message Area will only display information while running in Debug mode. It does not display information from other running services, and will not display the log of any process running in a live configuration (submitted to PReS Workflow Service). To learn more about debugging a process, refer to "Debugging and Error Handling" on page 53. The Object Inspector Pane The Object Inspector displays the properties of the object selected in the Configuration Components pane (not the Process Area, however).
Note When you select a group (folder), no information is displayed in the Object Inspector, because what is really selected is the group heading and not the items included in the group. The Plug-in Bar PReS Workflow offers a constantly increasing number of plugins, while always allowing third party plugins to be installed and set up to be used by PReS Workflow. The PReS Workflow Plug-in Bar lists all plugins available in PReS Workflow, and is divided into categories, which users can customize at will.
l OL Connect l Outputs Note An Uncategorized category is dynamically created if your PReS Workflow finds any plugin that would not be part of the existing Plug-in Bar. User-defined plugins and third party application plugins falls into such a category. Settings & customization The Plug-in Bar can be customized according to your needs and the plugins you most frequently used.
To import a plugin: 1. Click on the popup control ( ). 2. Click on Import Plugin. 3. Browse to the location of the plugin DLL file. 4. Click on Open. 5. New plugins appear in the Uncategorized category. Preferences PReS Workflow lets you configure a variety of options, from how the application itself looks or behaves, to plugin specific options.
l "HTTP Server Input 2 plugin preferences" on page 701 l "LPD Input plugin preferences" on page 702 l "Serial Input plugin preferences" on page 703 l SMTP Input l "Telnet Input plugin preferences" on page 705 l "PReSFax plugin preferences" on page 705 l "FTP Output Service preferences" on page 708 l "PReS Image preferences" on page 709 l "LPR Output preferences" on page 712 l "PrintShop Web Connect Service preferences" on page 714 Note Preferences are saved automatically and applied imme
Colors l l l l Variable properties: Select a color for the labels identifying variable property boxes. Debug: Select the color applied to the PReS Workflow Process area background when in debug mode. Highlighted tasks and branches: Select the background color for highlighted tasks and branches in the Process Area’s invisible grid. Disabled tasks and branches: Select the background color for disabled tasks and branches in the Process Area’s invisible grid.
l l Sunken active property: Select to use a recessed effect to display the currently selected property. Border active property: Select to display a border around the currently selected property. l Show lines: Select to display lines between elements. l Line style: Select a style for the lines. l Reset to default button: Click to reset all the Object Inspector options to their default values.
Default Configuration behavior preferences l l l l l Use default configuration: Check to use default input and output tasks when you create a new process. If this group is not selected, each new process you will add will begin and end with unknown tasks. Default input task: Select an input task to use as the default input task when you add a new process. Click the Configure button located to the right of this box to set the properties of the selected input task.
l l l l l l l l l l l Invalid name: Select to have PReS Workflow warn you when you try to rename an object in the Configuration Components incorrectly. Names can include letters, numbers, and underscores; the first character of a name cannot be a number. Printer queues update: Select to have PReS Workflow prompt you when adding a document to a group under the Documents category in the Configuration Components pane.
l l l l l l l l l l Prompt on overwrite of a document: Select to have PReS Workflow prompt for confirmation when a document that is being imported using File | Import Document is about to overwrite an existing document. Prompt on Document overwrite when service is running: Select to have PReS Workflow prompt for confirmation when a document that is being imported using File | Import Document is about to overwrite an existing document.
configuration file. Imported components can overwrite existing components, or be renamed automatically with unique names. Sample Data behavior preferences Sample Data behavior preferences control the way theData Selectordisplays the sample data file. Preferences l l l Select Font button: Click to access the Font dialog box to select the font in which the Data Selector displays the sample data file.
l l l Tree: Enter the NetWare Directory Services (NDS) tree where the user resides. This is the user you entered in the user name text box. Click Trees to navigate to the desired tree. You must enter a value for the Tree text box. Context: Enter the context on the NDS tree where the user you enter in the user name text box resides. Server: Enter the server where the NDS tree you entered in the Tree text box resides.
l Document and Pattern Database group l l l Use ODBC Database: Check to ignore the default location for the Microsoft Access database (MDB) and use an ODBC connection to your own database location instead. ODBC Settings: Click to open the "PlanetPress Capture ODBC Settings" on page 689 dialog. l Test Connection: Click to verify the connection to the ODBC Database. l Reset Database: Click to reset the database to its original status. l l Status: Displays the status of the database.
Database itself. The database can be stored locally or remotely, regardless of the Server/Client mode specified. PlanetPress Document Manager The PlanetPress Capture Document Manager dialog is used to manage all the documents present in the PlanetPress Capture database that are currently open. Options and Controls Documents Lookup Group l Filter by: Select what information you want to look for in the documents database.
l l l l l l Less than: If the mask and database information are both numbers, the mask will be a smaller number. Greater than: If the mask and database information are both numbers, the mask will be a larger number. Less than or equal to: If the mask and database information are both numbers, the mask will either be smaller or equal to the database information.
PlanetPress Capture ODBC Settings This dialog is used to set up the connection to a PlanetPress Capture Database through an ODBC connection. To access this dialog, See "PlanetPress Capture preferences" on page 685. Settings l l l l Name: Click to displays and choose from a drop-down of each DSN (Data Source Name) available on the system, along with it's source (User DSN or System DSN) and the driver it uses (database type). Type: Click to display a drop-down of supported database types.
Type correspond exactly to the one used by the DSN, and is part of the supported database types. Database Considerations (ODBC) Technical On 64-bit operating systems, the ODBC Data Sources created by the Data Source (ODBC) icon in the Administrative Tools will not appear here, as PReS Suite is 32-bit and cannot access the 64-bit data sources. In order to create an ODBC connection visible by PReS, you will need to access the 32-bit version of the ODBC manager, available in C:\Windows\SysWOW64\odbcad32.
l MySQL l l l l l Database can be in any location, but performance will depend on the speed of the connection between PReS and the MySQL server. MySQL's performance has been slower than SQL Server and SQL Server Express during our tests. By default, MySQL is configured not to allow any SQL request larger than 16 megs. In the event where 2 requests are made simultaneously on the same record, MySQL will queue one of the requests and execute it once the first one is done.
Pen Data List: Displays a list of registered pens and those pens you just added. l l l Pen ID: The serial number of pen, as written on the Anoto Digital Pen. You can doubleclick this area to edit the Pen ID if necessary. Pattern Sequence: The pattern sequence the pen is assigned to. You can double-click this area and edit the pattern sequence as required. User ID: The name of the user assigned to this pen. You can double-click this area to edit the user ID. This can also be custom information.
Multiple pens can be registered at once simply by writing on the registration pattern and then docking each pen before clicking the Read PGC File button. If the pen that is being registered already exists in the pen database, the Replace User ID (Description) dialog appears, with the following options: l Pen ID: Displays the Pen ID (serial number) to identify the pen l Old desc.: Displays the content of the User ID field for the pen as it is now. l New desc.
Options and Controls PlanetPress Capture Pen Licenses Group l l Import License...: Click to open the Import License dialog. Browse to a PPLIC (PlanetPress License) file on your computer and open it to import the license. The PPLIC overwrites your current license, however it may contain more than one Pen Pack (your previous one and one you just purchased) and will display them individually. License List: Displays the licenses that have been added to this system.
l l l l Port: Enter the port to use to communicate with the OL Connect Server. Default: 9340 User name: Enter the user name expected by the OL Connect Server. Password: Enter the password expected by the OL Connect Server for the above user name. Email Creation Settings l l Mail Host: Enter the default SMTP Server host or IP Address. Sender address: Enter the default email address used as the sender (FROM) address. l User name: Enter the default user name for the SMTP Server if it requires it.
two fragments will need to be exactly one beside the other with no space or overlap between them. When this value is at 1, a very large space or overlap will be accepted. This may case "false positives" and separate words and text blocks may be considered as a single word if the value is too high. Accepted values range from 0 to 1. The default value is 0.3, recommended values are between 0.05 and 0.30. Delta Height Defines the tolerance for the height and position difference between two target fragments.
value, the higher the chance of a space being added between two characters. A value too low may add spaces where they do not belong. Accepted values range from 0 to 0.5. The default value is 0.3, recommended values are between 0.25 and 0.40. General and logging preferences General plugin preferences control the level of detail added to the PReS Workflow log file.
Preferences l PReS Alambic options group l l l Let me set up how many instances to run: Select this option if you want to limit the number of instances of the Alambic that PReS Workflow can run. Then enter the number of instances, a value ranging from 1 to 32, in the box below. When this option is not selected, PReS Workflow starts a minimum of three instances and a maximum of eight, based on the number of CPUs available on the server. Note that this does affects self-replicating processes.
(sent through file upload in a form), regardless of CDATA settings. Preferences l l l Port: Select the TCP port to use. The default port is 8080, the official HTTP alternate port, so as not to interfere with the standard HTTP port (80). To block any regular HTTP traffic (for example if only using HTTPS connections) the port can be set to 0. Time out: Set the timeout period in seconds. The default value is 120 seconds.
http server preferences. Note SSL is used to accept secured, encrypted requests from web clients and requires a certificate delivered by an approved authority. SSL can also be called HTTPS, though that is a misnomer. For more information on SSL and how to purchase a certificate, please see Q10694 on SSL.com. l l l l Disable SOAP Server: Check to disable all SOAP Server functionality. Verbose log: Select to enable to keep a verbose log.
Resulting XML Structure in HTTP Request Envelope email@example.
The available HTTP Server Input 2 preferences are as follows: l Serve HTTP resource: Check to activate static resource serving. l l Resource action name: Enter a name that will be simulated as a folder in your HTTP structure. For example, if you enter images in this box, you would refer to any files in this folder as href="images/file.ext" . Resource folder: Type the path of the folder where your resources are located, or click the Browse button and choose the folder in the browse dialog.
Preferences l Protocol options group l l l l l Log all Winsock and network messages: Select to have PReS Workflow keep a log of all Winsock and other network messages that occur through the LPD service. These are messages related to jobs being sent from other systems through LPR, and being received by PReS Workflow via LPD. Since these messages can accumulate, you have the option of not logging them. Log files are kept in the Log folder, which is located in the PReS Workflow installation folder.
Preferences l Serial settings group l l l l l l l l Serial port: Select the port of the computer where the Serial input is connected to (COM1 through COM8). Baud rate: Select the baud rate of the Serial input. The baud rate is the number of bits transferred per second. The transferred bits include the start bit, the data bits, the parity bit (if defined), and the stop bits. Data bits: Select the number of data bits defining the incoming data file on this serial port.
Telnet Input plugin preferences The Telnet input plugin preferences control the log of the PReS Workflow Telnet Capture service. Since PReS Workflow lets you monitor multiple Telnet inputs simultaneously, the port setting for all Telnet input tasks cannot be set in the Preferences. Preferences l l Log all Winsock and network messages (very verbose): Select to have PReS Workflow keep a log of all Winsock and other network messages that occur from the Telnet input.
l Fax service: Select the faxing program to which PReS Fax sends its documents for faxing. Each faxing program has its own options and changing this option also changes the options below to reflect the following: l WinFax Pro l Dialing format: Select how you want PReS Fax to read the fax number in the data selection and send it to WinFax PRO.
l l l l l Report Successes: Select to have PReS Fax generate a report whenever one of the faxes in the PReS Fax Job reaches its destination successfully or at least as far as the Windows Fax service is concerned. Folder: Enter or select the location of the report file. PReS Fax generates report file names automatically with the file name extension PFX.
is also copied with the report file and can be printed, sent by e-mail, or archived as specified by the PReS Workflow process. l l Expand folder paths in UNC (Universal Naming Conventions) format: Select to have PReS Fax use complete network server path names (\\servername\sharename\path\filename).
Options l Protocol Options Group l l l l Log all Winsock and network messages: Select to have PReS Workflow keep a log of all Winsock and other network messages that occur through the FTP output. These messages are related to jobs sent from PReS Workflow to a server via an FTP output, which in turn uses the FTP output service. Log files are kept in the Log folder, which is located in the PReS Workflow installation folder. They are named ftpdate.
PReS Image 1 or logging tab l l Administrator’s address(es): Enter one or more system administrator email addresses to which error and other messages related to the creation of PDFs/images by PReS Image are sent. Separate multiple email addresses with semi-colons (;). Send to the administrator group l l l l l l l l l Daily log: Select to send an email to the administrator every day at midnight (according to the local system clock) reporting the daily activity of PReS Image.
PReS Image 2 or database tab Add PDF to PReS Search database group: Select to populate a PReS Search database using the documents created by PReS Image and to activate the related options. Refer to the PReS Search User Guide for more information on this PReS Workflow software. l l l l l l l Database type: Select the type of the database in which you want to create a table (Access, or SQL Server).
PReS Image 4 or login tab l l Use Microsoft Outlook: Select to use Microsoft Outlook on the host computer running PReS Image to send the error messages to the administrators. The host computer must be running Outlook, and PReS Workflow must have access to Outlook. Outgoing emails appear in the outbox of Outlook, and is sent whenever Outlook is set to send email.
Options l Protocol options group l l l l l Print banner pages between jobs: Select to print banner pages between each job processed and output from the LPR output. The banner page includes details of the job being printed, including the job file name and the user name on the host computer running the LPR output client. No source port range restriction: Select to remove any restrictions on the port PReS Workflow uses to send the job file via the LPR/LPD protocol.
l Polling interval (seconds): Select the period of time—the default is 4 seconds—for which PReS Workflow is to wait when it finishes dispatching jobs to the LPR printer queues before polling the LPR output folder again. PrintShop Web Connect Service preferences PrintShop Web Connect service preferences control the credentials to log into the PrintShop Web server. The available preferences are as follows: l l User name: Enter the user name of a valid PrintShop Web user, mostly operators.
mode, text you enter overwrites existing text. You can also press INSERT to toggle between the two modes. l l l l l l l l l Use tab character: Select to use the tab character instead of spaces to represent tabs in the program file. Clear to use spaces to represent tabs. You must clear the Smart tab option to use this option. Smart tab: Select to use smart tabs. A smart tab advances with reference to the preceding line.
l l l l l l l l l Persistent blocks: Select to have any text you enter immediately after selecting a block of code appended to that block of code as part of the selection. When you select this option, you can also use the arrow keys to move within the code without affecting the selected code. You must select the Enable selection option to use the Persistent blocks option. Overwrite blocks: Select to have any text you enter immediately after selecting a block of code replace that block of code.
order. Tab stops are measured in number of space characters. For example, a value of 20 places the tab stop at the 20th space character. You can also use the dropdown list to select a previously entered value. l Display l Display Options Group l l l l l Editor font: Use to select the font the Editor uses to display the program code. Select the Use monospace fonts only option to restrict the fonts available to fixed width fonts.
l l l Line numbers on page: Select to display code line numbers at the left edge of the Code area. If you clear both this and the Line numbers on gutter option, no line numbers appear alongside the lines of code. Line numbers on gutter: Select to display code line numbers in the gutter between the Commands and Code areas. Selecting this option has effect only if you selected the Gutter option.
The Process Area The Process area, which is always available and visible, holds all the tasks, branches, conditions and comments that make up the selected process. The Process area is built like an invisible grid divided by rows (horizontal) and columns (vertical). When adding a new Action task, a new row is added. When adding a Branch or Condition, a new column appears (unless there is already a column at that level).
To zoom in or out on the PReS Workflow Process Area: 1. Click on the View tab of the Ribbon. 2. Click on Zoom Out in the Navigate group to zoom out, and Zoom In to zoom in. Adding Tasks You can add as many tasks as you want to your process by using the Plug-in Bar in PReS Workflow program. To insert a task: 1. Open the Plug-in Bar by clicking on its tab. If you can't see the Plug-in Bar tab, click on the View tab in the Ribbon and make sure the Plug-in Bar is highlighted in the Show/Hide section. 2.
Adding Branches The PReS Workflow Configuration program offers two different commands when it comes to adding new branches to a process: You can add a new branch, by dragging and dropping a branch, from the Process Logic category of the Plug-in Bar, into your process. Branches can be added using the Adding Tasks method. You can add a new branch that contains all of the tasks below the point where you insert the branch.
Note You cannot replace a task by a branch or a condition. Trying to paste or drop a branch or condition over a task will insert it before the task instead. The contrary is also true, you cannot replace a branch or condition with a task. Warning When you replace a task, you lose all the properties you set in this task.
Task Properties Dialog Any task you add to your PReS Workflow process must be configured using its Properties dialog box. Each task's Properties Dialog will give you the options to configure that specific, individual task. Properties of one task do not directly affect the properties of another task, however there are some software preferences that may affect tasks in one way or another (see "Preferences" on page 677).
l ID: Select the error ID you want to attribute to the error log. l Reset to defaults: Resets all options in this tab to their default values. The error management system (the On error tab and the Error Bin Input task), however, are only triggered when there is an error within the task functionality - that is, a plugin error. These kinds of errors are triggers if the plugin cannot communicate with a service, another task, if the plugin crashes, etc.
There are a few things to keep in mind when pasting tasks: l l l l l When you cut a task or branch, it disappears from the Process Area but is kept in your clipboard until it is pasted somewhere else. You can cut or copy a task or branch from one process and paste it in another process or subprocess. When you cut an input or output task, it is replaced with an Unknown Task, that you will need to replace with another task for the process to be functional.
Note You can paste only the properties of the On Error tab of any task or branch on another one. To copy and paste the On Error properties of a task or branch: 1. Copy or cut a task or branch from which you want the On Error properties. 2. Select the task or branch where you want to paste the On Error properties. 3. From the Home tab in the Ribbon, choose Paste On Error (or right-click and select Paste On Error from the drop-down menu).
To duplicate a task or branch, the same method applies but with a slight difference: 1. In PReS Workflow Process area, click the icon of the task or branch you want to duplicate. 2. While holding down the mouse button, press and hold down the CTRL key and drag the icon task or branch over another task or branch. 3. Release the mouse button to drop the dragged item and release the CTRL key. The dropped task or branch is copied above the item over which it was dropped.
Resize Rows and Columns of the Process Area Resize the rows and columns of PReS Workflow Process area in which tasks are located to better visualize the organization of your process. To resize rows and columns of the PReS Workflow Tools Process area: 1. In the PReS Workflow Tools Process area, place your cursor over the separator line dividing each section of row or column rulers. 2. When the cursor changes appearance, click and drag up or down to resize rows, or left or right to resize columns.
To use a variable document: 1. Click on the %o entry in the document list 2. Type the variable properties or use the right-click menu to insert the correct variable properties. 3. Click OK on the dialog. At run-time, if PReS Workflow cannot find the document name generated by those variables, the task will fail. Highlight a Task or Branch The Highlight command lets you toggle the background color of selected tasks and branches.
thereafter decided to redo those commands, you could use the Redo command three times in a row to redo those commands. Note that all commands in PReS Workflow Configuration can be redone. To redo a command: l From the Quick Access Toolbar, choose Redo. The Quick Access Toolbar PReS Workflow Quick Access Toolbar is displayed, by default, on the right side of the PReS Workflow button and provides one-click shortcuts to commonly used functions and features.
Note The Quick Access Toolbar buttons cannot be moved or re-ordered. If you wish to reorder them, you will need to remove all the buttons and re-add them in the desired order. The PReS Workflow Ribbon The PReS Workflow Ribbon centralizes commands, organizing them into a set of Tabs, each tab containing groups of controls. Each tab on the Ribbon displays the commands that are most relevant to a given feature set.
l The View tab includes the Arrange, Navigate and Show/Hide groups. l l l l The Navigate group contains a Processes control to select any existing process of the currently loaded configuration, as well as a Highlight control to mark a given node, a Zoom Out for a quick overview of the currently selected process, and Go to Child/Go to Parent to move around a given process logical nodes (branches or conditions).
l l The Services group contains: l l l l l The Configure Services control loads the PReS Workflow Services dialog to configure the user account PReS Workflow should use. The Service Console button opens the The PReS Workflow Service Console, allowing to monitor real-time information on the configuration execution. The Document Manager button opens the PlanetPress Capture Document Manager. The Pen Manager button opens the PlanetPress Capture Pen Management Tool.
The Task Comments Pane The Task Comments pane displays comments relevant to the currently selected items, such as the contents of the Comments tab of any task in the currently selected process. The Task Comments pane cannot be used to edit the comments themselves - only to see them. To edit the comments, the properties of the task must be opened, and the comments changed in the Comments tab.
Copyright Information Copyright © 1994-2017 Objectif Lune Inc. All Rights Reserved. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any other language or computer language in whole or in part, in any form or by any means, whether it be electronic, mechanical, magnetic, optical, manual or otherwise, without prior written consent of Objectif Lune Inc. Objectif Lune Inc.
Legal Notices and Acknowledgements PReS Workflow, Copyright © 2017, Objectif Lune Inc. All rights reserved. The license agreements for the associated open source third party components can be downloaded here. This application uses the following third party components: l l l l l l l Apache Javascript Support (Rhino) version 1.7.3 which is licensed under the terms of the Mozilla License Version 1.1. The source code can be obtained from the following location: https://developer.mozilla.
l l l l l l l l l l l l Jacob Java Com Bridge which is licensed under the terms of the GNU Lesser General Public License Version 2. The source code for this can be obtained from the following location: http://sourceforge.net/projects/jacob-project/files/jacob-project/ JavaCraft JSch Copyright © 2002 - 2012 Atsuhiko Yamanaka, JCraft Inc. All rights reserved. JavaSysMon Copyright © 2009 ThoughtWorks, Inc. All rights reserved.
l l l l l l l l l l l Relique CSV Driver which is licensed under the terms of the Lesser General Public License Version 2.0. This can be obtained from the following location: http://sourceforge.net/p/csvjdbc/code/ci/master/tree/ Rhino 1.6R7 and 1.7R2 which are licensed under the terms of the Mozilla License Version 1.1. The source code for this can be obtained from the following location: https://developer.mozilla.
Portions of certain libraries included in this application which are distributed under the terms of the Mozilla Public License have been modified. To obtain copies of the modified libraries please contact your local Objective Lune Support team. This application also uses the following components which are distributed under the terms of the Apache Software License Version 2.
l Apache ServiceMix l Apache Tomcat l Apache WSS4J l Apache Xalan l Apache Xerces2 Java Parser l Apache XMLGraphics l Apache XML-RPC l Barcode4j l Google Collections l Google GSON l Jetty l LMAX Disruptor l OPS4J Pax Web l org.json.simple l Spring Dynamic Modules l StAX l XMLBeans Eclipse Technology: This Software includes unmodified Eclipse redistributables, which are available at www.eclipse.org.
l freemarker/ext/jsp/web-app_2_4.xsd l freemarker/ext/jsp/web-app_2_5.xsd l freemarker/ext/jsp/web-jsptaglibrary_1_1.dtd l freemarker/ext/jsp/web-jsptaglibrary_1_2.dtd l freemarker/ext/jsp/web-jsptaglibrary_2_0.xsd l freemarker/ext/jsp/web-jsptaglibrary_2_1.
