8.18.32016-03-14

Digital Action

Digital Action action tasks generates the same types of documents generated by PlanetPress Image output tasks. Since Digital Action tasks are not output tasks, the documents they create are typically passed on to the following task. The image files they generate are always saved, along with their index files (if any), to an archive folder.

Differences between Digital Action and Image tasks:

• Digital Action is an Action Task and cannot be the last task in a branch or process. Image is an output task, and has to be placed at the end of a process or branch.
• In PlanetPress Workflow 7.2.4 and older, Digital Action does not update the PlanetPress Search Database, even if a PDI is generated and even if the option is checked in the preferences. This behavior was changed starting in PlanetPress Workflow 7.3.
• Digital Action can accept PostScript (.ps) files as an input, even if they are not generated by any PlanetPress tools.

Task Properties

General tab

• Host: Select the IP address of the PlanetPress 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 runtime for each job, enter a dynamic document name using a combination of text, variables and data selections. To enable the dynamic document name box, click inside it. To disable it, press Enter. Note that in the later case, you must be certain that the documents that will be chosen at runtime will in fact be available locally or at the selected host.

  While the Do not use a document (passthrough) is visible in this list, it is not compatible with the PlanetPress Image output if the PostScript was not generated by merging a design document with data in PlanetPress Workflow. In order to generate an image in passthrough mode with external PostScript, please use the Digital Action task.

• 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
  • Printer centric: Select to send the document along with the trigger and data to PlanetPress Image.
  • Optimized PostScript Stream: Select to merge the selected document with the data received by this task before sending it to PlanetPress Image. Note that some features, such as the Time and Date PlanetPress Talk functions, require that this option be selected.
• Add job information to the document: Select to add the available job info variables in the “header” of the generated output file.
• Output type: Select the output file type that you want.
  • 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. TIFF is a higher quality format that is one of the standards for document exchange, useful for eventual printing or archiving. You have a choice of the following compressed TIFF formats: TIFF Group 3, TIFF Group 4, and TIFF Packed bits. You can also use the uncompressed TIFF format, which produces the largest files with the highest quality. TIFF is a versatile and platform-independent format. It is used in many digitizing projects as the format of choice for the digital masters. The TIFF Group 3 and Group 4 formats are efficient for document storage.
  • The AutoStore, DocAccel and KYOcapture formats also generate TIFF files along with special XML that are meant for these specialized systems.
• DPI: Enter the dots per inch (dpi) resolution of the output image. This property is enabled for all output types except PDF.
• 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. 8-bits produce grayscale images (in PlanetPress Design you can have 8-bit color images, but these are reduced to grayscale if you select 8-bit here), while 24-bits produce full color images. For JPEG output, you cannot select a monochrome (1 bpp) color depth. For TIFF G3 and TIFF G4, monochrome (1 bpp) is the only Color depth option you can select. This property is enabled for all output types except PDF.
• Multi-page: Select to generate a single file containing multiple pages. When this option is not selected, PlanetPress Image creates a file for each page included in the output file. This property is enabled for all output types except PDF and JPEG.
  Add page number: Select to put a page number on each page included in the output file. This option goes with the Multiple TIFF option and is only visible if either the AutoStore, DocAccel or KYOcapture format is selected.
• Data Stream group: Determines what is output by the Digital Action task:
  • 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.
• Save a copy: Optional when the "Use Digital as the new data stream" option is checked, otherwise is always checked. Keeps a copy of the digital output onto the specified folder.
• Folder and filename: Enter the path of the folder to which output files generated by this task are to be archived. PDF index files (PDI and XML) are also put in this folder. This edit box is enabled when the Save a copy option is selected. To prevent each new file from overwriting the previous one, you should use variable names. As with any variable property box, you can use any combination of text, variables and data selections. When multiple files are generated for a single job (such as for multiple TIFFs), each file name includes a sequence number, such as in Invoice0, Invoice1, Invoice2. If you use file name masks that include dots, such as Statement.%y.@(1,1,1,1,25,KeepCase,Trim) or Job.%f, for example, you must add quotation marks at the beginning and end of the file name (“Statement.%y.%m.@(1,1,1,1,25,KeepCase,Trim)” or ”Job.%f”). Otherwise, when the file is saved, anything appearing after the last dot is replaced by the file’s extension characters (and the file name thus becomes Statement.2005.pdf instead of Statement.2005.255842.pdf, or Job.tif instead of Job.544872.tif). Failing to add the quotation marks may result in files being overwritten.
• Automatically Add Extension: Check if you want the correct extension for the image type to be appended to the filename automatically, rather than having to add it in the Filename box. The Output Type determines the extension to be used.
• Add PDF to PlanetPress Search database: Check to update the PlanetPress Search database with each new PDF generated.
• 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 PlanetPress Search as indexing information.
  • None: Select if you do not want this task to add an index file to the generated document.
  • PDI: Select if you want this task to add a PDI index file to the generated document.
  • 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.

• 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. Note that if you make changes and then select a different output option, your changes will be lost. PlanetPress Image supports numerous PDF standards: Standard, High Quality, Custom, and a variety of PDF/VT, PDF/A and PDF/X formats.
• General group
  • ASCII format: Select to create the PDF file using ASCII characters (instead of the usual 8-bit binary format). This option produces a file suitable for transmission over a 7-bit ASCII link. This option is useful if the PDFs need to be opened in a text editor, sent across networks, or sent via email using a program that does not support binary files. This option also generates smaller files.
  • Compress text and line art: Select to compress the text and line work in the file using the Flate compression filter. Flate is a compression method that works well on elements with large areas of single colors or repeating patterns, as well as on black-and-white elements that contain repeating patterns.
  • Auto-rotate pages: Select to automatically rotate pages based on the orientation of the text or DSC comments.
  • Optimize for fast web view: Select to minimize file size and facilitate page downloading.
  • Title: Enter a title for the document. If you leave this box empty, the document’s name will be used as the document’s title. Since this is a variable property box, you may use variables and data selections and let PlanetPress Workflow interpret this information at runtime.
  • 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 PlanetPress Workflow interpret this information at runtime.
  • 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 PlanetPress Workflow interpret this information at runtime. Note that if you use a data selection in this box, you must be sure that the data that will be selected at runtime 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.
  • Keywords: You may enter keywords for the document. Since this is a variable property box, you may use variables and data selections and let PlanetPress Workflow interpret this information at runtime.
• Monochrome images group
  • Monochrome compression: Select the compression to use for the monochrome images. Flate compression is lossless, so no data is lost during compression. Flate Mono works well on images with large areas of solid shades or repeating patterns, such as screen shots and simple images created with paint or drawing programs. CCITT typically yields the best compression of monochrome images. It is the compression method developed for fax transmissions. Note that configurations that were created with an earlier version of PlanetPress Workflow and that included tasks set not to use any compression will by default be set to use the Flate compression method.
  • Monochrome resolution: Select the resolution to use for monochrome images.
• Grayscale images group
  • Grayscale compression: Select the compression to use for the grayscale images. Flate is a lossless compression method, so no data is lost in the process. It works well on images with large areas of single shades or repeating patterns, such as screen shots and simple images created with paint or drawing programs. JPEG removes image data and may reduce image quality, but may be suitable for continuous-tone photographs containing more detail than can be reproduced onscreen or in print. Since JPEG eliminates data, it can achieve much smaller file sizes than Flate compression. Select Auto to let the application choose the best compression method automatically. Note that configurations that were created with an earlier version of PlanetPress Workflow and that included tasks set not to use any compression will by default be set to use the Flate compression method.
  • Grayscale downsampling: Select the downsampling option. Downsampling reduces image size by breaking images down into small areas in which multiple pixels are replaced by single pixels. The Grayscale resolution you enter in the following box is used to control the downsampling process. Select None to prevent grayscale downsampling. Select Average to average pixel shades in each sample area and to replace the entire area with a pixel of the average shade. Select 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.
  • Grayscale resolution: Select the resolution to use for grayscale images. Note that this setting has an impact on the grayscale downsampling process.
• Color images group
  • Color compression: Select the compression to use for the color images. Flate is a lossless compression method, so no data is lost in the process. It works well on images with large areas of single shades or repeating patterns, such as screen shots and simple images created with paint or drawing programs. JPEG removes image data and may reduce image quality, but may be suitable for continuous-tone photographs containing more detail than can be reproduced onscreen or in print. Since JPEG eliminates data, it can achieve much smaller file sizes than Flate compression. Select Auto to let the application choose the best compression method automatically. Note that configurations that were created with an earlier version of PlanetPress Workflow and that included tasks set not to use any compression will by default be set to use the Flate compression method.
  • Color downsampling: Select the downsampling option. Downsampling reduces image size by breaking images down into small areas in which multiple pixels are replaced by single pixels. The Color resolution you enter in the following box is used to control the downsampling process. Select None to prevent grayscale downsampling. Select Average to average pixel color in each sample area and to replace the entire area with a pixel of the average color. Select 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.
  • Color resolution: Select the resolution to use for color images. Note that this setting has an impact on the color downsampling process.
• Security group
  • Permissions password: Enter a password in this box only if you want to prevent users who does not have this password from changing the security options of 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.
  • Allow printing: Select to let users print the generated PDF files.
  • Allow changing the document: Select to let users edit the generated PDF files.
  • Allow content copying: Select to let users copy content from the generated PDF files.
  • Allowform filling: Select to let users enter information in the form fields included in the generated PDF files.
• Font group
  • Embed all: Select to embed the entire font of all fonts used in the variable content document within the generated PDFs. Using this option may result in large PDFs, especially if many fonts are used. Note that those fonts installed by default with the Adobe Acrobat and Adobe Reader are never embedded. If a font is not embedded in your PDF, opening it on another computer or printing it may cause it to be substituted by another default font.
  • Subset: Select to embed only a subset of the Type 1 and TrueType fonts used in the document. A font subset is in fact composed of only those characters that are actually used in the document. This option can only be used if the Embed all fonts option is selected. Note that if more than 35% of the characters included in a font are used in the document, the entire font is embedded. This option often produces smaller PDF files and ensures proper PDF display.
• Initial view group
  • 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. Select Bookmarks and page to display the contents of the Bookmarks tab (you use data selection objects to create bookmarks in PlanetPress) 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.

PlanetPress Search Database tab

If PlanetPress Workflow is configured to automatically update a PlanetPress Search database (see PlanetPress Image User Options), this tab can be used to override the global settings so that the task updates a different database than the one set in that global configuration. In order for the settings to work, the Add PDF to PlanetPress Search database must be checked. However, you can override which database will be updating using the option in this window, Override global PlanetPress Search Database settings. The database options then activate.

• Database type: Select the type of the database in which you want to create a table (Access, or SQL Server).
• Connection time-out: Enter the time, in seconds, that the connection to the database is maintained while no action is taking place before the connection is severed.
• Database directory: Enter the path of the directory in which the Access database is located, or use the Browse button to navigate to, and select, the directory. This option is available only when you select Access database in the Database type box.
• Data source name: Enter the name of the computer on which the database runs. This option is available only when you select SQL Server database or Oracle database in the Database type box.
• Use default database: Select to use the default database associated with your user profile on that SQL Server or Oracle database. Clear to enter the name of the database in the box that appears.
• 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 PlanetPress Search with an SQL Server Database” section of the PlanetPress Search User Guide).
• Password: Enter the password required to access the database.
• Test Connection: Click to verify that PlanetPress Image can connect to the specified database.
• Enforce global table creation: Select this option, as it ensures that all database users are granted access to the database. This option is available only when you select SQL database in the Database type box.