Editing output folder properties
To edit the properties of an output folder, you can either right-click a output folder row and select Properties or double-click the hot folder row. The Output: window is displayed:
You can change the following properties:
- State
- You can click , the Enabled button, or , the Disabled button, to switch between the two states.
- Name
- You can edit the output folder’s name.
General tab
- Description
- You can edit the output folder’s short description.
- Estimated Output Speed
- You can edit the printer output speed. Select Feet/hour or Sheets/hour to change the measurement unit.
Note: Depending on the selection you made at the installation time, the measurement system can be different.
- Minimum Job Run Time
- Specify a number of minutes as the default minimum runtime for each job placed in the output folder. This Minimum Job Run Time is added to the existing runtime for each job from a filter or a batch, that has this output folder as the specified output device.
- When you want to determine the total runtime for a batch, a filter, or a group of jobs, the Minimum Job Run Time is added to the runtime of each job.
- Adjust Job Paper Before Sending
- Specifies whether the job paper properties should match or not a Paper Catalog entry, before sending the job to the Output Device.
- Select one of these options:
- Off
- Select this option in order to send the job to the Output Device, without changing the paper properties. This is the default option.
- On, Based on Paper Catalog
- Select this option if you want to adjust the job paper properties, so that they match a paper catalog entry, before sending the job to the Output Device.
Configuration tab
- Output Type
- Select the output type from the list. The following values are available:
- PDF/Postscript
- Select this option if you want TotalFlow BatchBuilder to place a PDF/PostScript file in the output hot folder for each job in the batch.
- PDF/Postscript and XML
- Select this option if you want TotalFlow BatchBuilder to place a PDF/PostScript file and an XML file in the output folder for each job
in the batch.
Note: You can specify different output hot folder locations for the PDF/PostScript files and for the XML files.
- PDF/PostScript and CSV
- Select this option if you want TotalFlow BatchBuilder to place the PDF/PostScript file and the generated CSV file in the output hot folder for the each job in the batch.
- The Sample XML file is a TotalFlow BatchBuilder internal XML file that is converted to a CSV file using a specified mapping file.
- From CSV Output :
-
Select the First Row Contains Field Names checkbox if you want the CSV file to contain field names.
-
Select the One CSV per Batch checkbox if you want to generate one CSV file for all the jobs in the batch.
-
- TotalFlow MIME
- Select this option if you want TotalFlow BatchBuilder to place a Multipurpose Internet Mail Extensions (MIME) package in the output hot
folder for each job in the batch. The MIME package contains a JMF file, a JDF file,
and the job file. The JDF file is generated by the TotalFlow BatchBuilder system using an internal XSL mapping file.
The MIME package file name is the same as the job file name.
- PDF/Postscript and RPD List File
- Select this option if you want TotalFlow BatchBuilder to create a RICOH ProcessDirector list file in addition to the PDF files for the jobs in the batch. The RICOH ProcessDirector list file is a text file containing the ordered list of file names from the batch. The RICOH ProcessDirector list file is placed in the output hot folder on the last position.
- JMF over HTTP
- Select this option if you want TotalFlow BatchBuilder to send a MIME package to a virtual printer. A JMF file is sent through an HTTP protocol for each job in the output folder. You must specify the URL and the name of the virtual printer. The MIME package contains a JMF message, a JDF file, and a PDF job file. TotalFlow BatchBuilder converts the job settings into the JDF file through the specified mapping file.
- TotalFlow JMF over HTTP
- Select this option if you want TotalFlow BatchBuilder to send a MIME package to a virtual printer. A JMF file is sent through an HTTP protocol for each job in the output folder. You must specify the URL and the name of the virtual printer. The MIME package contains a JMF message, a JDF file, and a PDF job file. TotalFlow BatchBuilder converts job settings into the JDF file through Ricoh JTAPI library.
- Mapping File
- You can use XSL mapping files to configure output devices in TotalFlow BatchBuilder to generate various XML files based on the TotalFlow BatchBuilder schema. Using the XSL mapping file, the output hot folder is configured to generate an XML file based on your custom target schema. This option is available only when the output type is either PDF/Postscript and XML, TotalFlow MIME, or JMF over HTTP.
- The XSLT conversion process uses the TotalFlow BatchBuilder internal schema as an input to generate the XML output for a job.
When the selected output type is TotalFlow MIME or JMF over HTTP, the default XSL mapping file is
TotalFlow JTAPI.xsl
. - Output XML File Extension
- Specify the extension type for the generated output XML file. When the selected output
type is PDF/Postscript and XML, you can set the extension for the output XML file.
Important: Make sure the specified XML file extension is different than the corresponding job file extension.
- MIME File Extension
- Specify the extension type for the generated output MIME package file. When the selected
output type is TotalFlow MIME, you can set the extension for the output MIME package file. The default file extension
is
.mjm
. - Output Location (Directory Path)
- Type in the path or click Browse… to select the folder location.If the specified folder does not exist, a new folder
is created.
To select an existing folder or create a new folder manually, click Browse…. The Batching System Directory dialog appears.
Navigate through the existing local or external drives,select the folder you want to use, and then click Select.
To create a new folder, click New Folder… in the menu bar.
To modify the name of an existing folder, right-click the folder and select Edit Folder Name.
To delete an existing folder, right-click the folder and select Delete….
Note: You can drag and drop folders to reorder or to move them from one parent folder into another. You can only drag and drop empty folders and within the same network drive.To add a new network location, click Map Network Drive… in the menu bar. The New Mapped Network Drive dialog box appears.
Select the Drive Letter from the list and enter the folder path in the Folder field. You have the option to enter a user name and a password. Click OK. A confirmation message is displayed and the new drive is added to the list.
If you want to edit an existing mapped network location, right-click the network drive you want to modify and select Edit Mapped Network Drive…. The drive dialog box is displayed.
You can change the drive letter and edit the folder path. To save the changes, you must enter the password again and click OK. The system displays a confirmation message that the changes have been saved.
If you want to disconnect a mapped network location:
- Right-click the network drive and select Edit Mapped Network Drive…. The Drive: "{0}" dialog box is displayed.
- Click Disconnect. You can also right-click the network drive and select Disconnect.
A confirmation window is displayed.
- Click Yes to disconnect the drive or No to cancel the action.
-
Note: If the selected output type is PDF/Postscript and XML you can specify different locations for the PDF files and for the XML files.
- Output Location (XML files)
- Type in the path or click Browse… to select the output hot folder location for the XML files.
- Output Location (PDF files)
- Select the Use same location as XML option if you want to use the same output hot folder location for both XML files and PDF files.
- Output Location
- Type in the path or click Browse… to select the output hot folder location for the PDF files.
- PDF file location to specify in the XML file
- When the PDF files and the XML files are placed in different output hot folder locations, you must specify the path for the PDF files.
- The specified path is used as a file reference to the PDF job file in the corresponding XML file.
Important: If you map a network drive with a read only root directory, make sure the specified folder location on the selected network drive has write access. - Target Device
- If the selected output type is JMF over HTTP or TotalFlow JMF over HTTP, you must specify the name of the device where you want to send the JMF file or select from a list of available devices. The device means every virtual printer, printer, or input device that supports the JMF over HTTP and TotalFlow JMF over HTTP protocol.
- Target URL
- If the selected output type is JMF over HTTP or TotalFlow JMF over HTTP, you must specify the address of the server where you want to send the JMF file over HTTP.
- The URL might be different depending on the server. To retrieve the exact path for the server, read the specific documentation about the JMF over HTTP or TotalFlow JMF over HTTP protocol for each server.
-
Examples
- For RICOH TotalFlow Path, the URL can be
http://<ServerHostAddress>:28464/<sufix>
where <ServerHostAddress> is the host name or the IP address of the computer where the virtual printer is located andsufix
is the path configured in the JMF input extension.. - For RICOH ProcessDirector, you can use this URL:
http://<ServerHostAddress>:15080/aiwservices/v1/jmf
where <ServerHostAddress> is the host name or the IP address of the computer where the virtual printer is located.Note: Make sure that the device where you want to send the jobs supports JDF input. - For RICOH TotalFlow Production Manager, you can use this URL:
http://<ServerHostAddress>:15080/aiwservices/v2/jmf
where <ServerHostAddress> is the host name or the IP address of the computer where the virtual printer is located. - For several RICOH TotalFlow Print Server printers, you can use this URL:
http://<ServerHostAddress>/webJmf/Device1
where the target device is a virtual printer and <ServerHostAddress> is the host name or the IP address of the computer where the virtual printer is located. - For several printers with EFI Fiery Controllers, you can use this URL:
Http://<ServerHostAddress>:8010/
where the target device is a virtual printer and <ServerHostAddress> is the host name or the IP address of the computer where the virtual printer is located.
- For RICOH TotalFlow Path, the URL can be
- Job Status
- Select one of these options:
- Automatic Replies Only: The TotalFlow BatchBuilder system receives the state of the job sent for printing automatically from the printer.
- Automatic Replies and Poll for Job Status: If a printer does not automatically return the state of the job sent for printing, you can use this option to request Job Status information directly from the printer. Depending on the Job Status information received, the TotalFlow BatchBuilder updates the state of the job to Printed or Output Error.
- Test Connection
- If the selected output type is JMF over HTTP or TotalFlow JMF over HTTP, you can click Test Now to verify if the server where you want to send the JMF file is available or if the
specified virtual printer is valid.
Note: Sending jobs to the device might fail even when the connection test succeeds. This usually depends on the device protocol implementation. Check the device configuration and resubmit the job.
Paper Catalog tab
In the Paper Catalog dialog you can manually import a paper catalog from one output to another. To import a paper catalog, click the Import Paper button. The Import Paper dialog is displayed.
- Output:
- Browse the list and select the paper catalog of an output in the system. The papers displayed in the output are selected by default. Clear the papers that you do not want to import.
- Click OK. A confirmation message is displayed with the number of imported papers.
You can manually enter a media catalog into TotalFlow BatchBuilder, that is selectable for jobs, batch tickets, and banner sheets. To edit properties, duplicate or delete a paper, select one paper from the list and right-click. To add a new paper, click the Add Paper button. The Add Paper dialog is displayed with the following options:
- Paper Name
- You can edit the name of the paper used. You can enter a string of maximum 256 characters. This field is mandatory.
- Product ID
- You can edit the product ID. You can enter a string of maximum 256 characters.
- Paper Type
- You can edit or select the type of paper used from a list:
- Bond
- Offset Text
- Cover
- Tag
- Index
- Paper Weight
- The paper weight varies based on the paper type and the paper size. You can edit the paper weight.
- Paper Color
- You can type in or select the paper color form a list.
- Paper Finish
- You can type in or select the paper finish from a list:
- Uncoated
- Coated
- Glossing Finish
- Ink Jet Finish
- High Gloss Finish
- Matte Finish
- Polymer Finish
- Satin Finish
- Semigloss Finish
- Silver Finish
- Paper Width
- The width of the paper.
- Paper Height
- The height of the paper.
- Note:
-
The Input Type column displays either the Local Paper or the Paper Catalog from JMF over HTTP and TotalFlow JMF over HTTP. You can edit, duplicate or delete a Local Paper. You can duplicate a paper received via JMF over HTTP and TotalFlow JMF over HTTP Paper Catalog. The duplicated paper is created as Local Paper. The system displays the Update Paper button in the Paper Catalog tab only for JMF over HTTP and TotalFlow JMF over HTTP printers.
-
The system refreshes the Paper Catalog once a day. If the printer is offline while TotalFlow BatchBuilder is auto refreshing the paper catalog, the existing catalog remains unchanged. When a new or an edited JMF is defined, the system automatically updates the paper catalog, right after the output save. The paper catalog is automatically refreshed only if and after you click first the Import Paper button.
Commands tab
You can create one or more custom commands using batch, order, or job attributes.
The TotalFlow BatchBuilder system creates a .bat
file containing the specified commands. When a batch is sent to the output, the print
files, the banner sheets, the batch tickets, and the xml
files are copied to the output folder and then the commands are executed.
- Command Timeout
- Specify the number of minutes TotalFlow BatchBuilder must wait before the command is timed out and the process it terminated. When a command is timed out, the job state is set to Output Error and an alert is sent.
- Command Field
- Enter one or more commands separated by line breaks. In each command syntax you can
specify batch, order, or job properties using these variables:
${batch.[propName]}
,${order.[propName]}
,${job.[propName]}
. - Insert Attributes
- You can add job attributes, batch attributes, or order attributes to the custom command syntax. Select the values you want to insert from the available attributes lists.
- Note:
- When you cancel a batch in Sent state and there are commands running, the TotalFlow BatchBuilder system terminates the processes.
- Make sure the specified custom commands are in a correct format. The TotalFlow BatchBuilder system sends and alert when an error occurs.
Banner Sheets tab
- Banner Sheets
- Select the First sheet or/and Last sheet checkboxes if you want to include banner sheets for job files in the output folder.
- File Handling
- Select the checkbox if you want to insert the banner sheets into the PDF job file.
- Sheet Location of Banner Content
- Specify the location of the content on the banner sheet. You can select one of these options: Front, Back , or Front and back
- Banner Content Page
- Specify the location of the banner content page. You can select one of these options: First sheet or Last sheet.
- Paper
- If you select the Banner Sheets checkbox, the Paper presets are available. Properties set here become banner sheets defaults;
- Match Job — disables the controls that configure media and uses default settings.
- Custom — enables the controls that configure media, any setting specified are included in banner sheets XML/JDF/CSV.
- If you select Custom value, you can type in or select a media from the output Paper Catalog list. To add a paper type, click the Add Paper button.
- Border/Sheet Color
- Select the checkbox if you want to print color on the document sheet edges.
Select the Color Location;
- Entire sheet — applies the color to the whole sheet.
- From sheet edge — specify the distance from the sheet edge where you want to apply the color.
- Custom Colors
- You can set custom border/sheet depending on job properties. To choose the desired color, click any color rectangle. The color picker opens. To close the color picker, click any side of the screen.
To configure the criteria for the banner sheet:
- Select the attribute type from the first list.
- From the second list, select one of these operators:
- Is
- Is not
- Between
- Greater than
- Less than
- Greater than or equal
- Less than or equal
- To complete the criteria, enter or select a value for the specified attribute type.
Specify a percentage value from 0 to 100 for each color from the CMYK color model:
- C — cyan
- M — magenta
- Y — yellow
- K — key (black)
Color Preview displays the color created with the specified CMYK values.
Batch Tickets tab
Specify if you want to print the batch details and the location where to send the batch ticket. The system generates a batch ticket file containing the batch details.
Batch Ticket Printer | ||
---|---|---|
Send Batch Tickets to a Printer | Select this option to send the batch ticket to a printer. Choose a printer from an existing list of printers mapped to the TotalFlow BatchBuilder server. You can also specify the number of copies of batch tickets you want to print. | |
Send Batch Tickets to Output Device | Select this option to send the batch ticket to the specified output device. The batch ticket file is placed as the first job in the batch and the job sequence number for the batch ticket is 0. The batch ticket file is not displayed in the batch detail dialog and does not appear as a job in the user interface. | Paper Specify which job properties you want to use for the batch ticket media:
|
To save the changed properties, click OK. If you want to close the Output: window and discard the changes, click Cancel.
To delete the hot folder, click Delete. For more information, see Delete one or more output folders.