1. Identify the data that your postal software requires for each mail piece.
   The postal software requires name and address data in a specific format.

   If you are using the postal software to compute postage, the software might need information about mail piece weight and thickness. Some postal software assumes that all mail pieces in a job have uniform weight and thickness. Other postal software lets you specify different values for each mail piece.

2. Identify the data that your postal software requires for each job.
   For example, you might need to specify Mailer ID and Postage statement date.
3. Identify the Ricoh ProcessDirector job and document properties that correspond to the data required by your postal software.
   The Postal Enablement feature provides a large number of job and document properties for use with postal software. For job properties, examine the properties notebook for the SetPostalJobProps step template. For document properties, examine the properties notebook for the BuildExternalDocPropsFile step template. Select from the document properties on the Available list.
4. If you need custom document properties, edit the docCustomDefinitions.xml file and then run the docCustom utility to define the properties to the system. See Ricoh ProcessDirector: Installing Document Processing Features for instructions.

1. Follow the instructions in the Information Center to enhance PDF files for Postal Enablement.
   These instructions explain how to identify the start of each mail piece in a job, define document properties to extract address data from each mail piece, and make changes to the PDF file based on the data returned by the postal software.
2. Save your document property definitions in a control file for use with a step based on the IdentifyPDFDocuments step template.
3. Send the control file to the Ricoh ProcessDirector server in a directory that the Ricoh ProcessDirector system user has access to.
4. If you are making changes to the PDF file based on the data returned by the postal software (for example, adding a barcode or replacing the address), save your document property definitions and updated address data in a control file with a different name from the control file in the previous step. Send the control file to the Ricoh ProcessDirector server in a directory that the Ricoh ProcessDirector system user has access to.
   This new control file is used with a step based on the BuildPDFFromDocuments step template.

1. Follow the instructions in the Information Center to enhance AFP files for Postal Enablement.
   These instructions explain how to identify the start of each mail piece in a job, define document properties to extract address data from each mail piece, and make changes to the AFP file based on the data returned by the postal software.
2. Save the control file created by Ricoh Visual Workbench and send it to the Ricoh ProcessDirector server in a directory that the Ricoh ProcessDirector system user has access to.
   This control file is used with a step based on the IdentifyDocuments step template.
3. If you are making changes to the AFP file based on the data returned by the postal software (for example, adding a barcode or replacing the address), save your document property definitions and updated address data in an Enhance AFP control file. Send the control file to the Ricoh ProcessDirector server in a directory that the Ricoh ProcessDirector system user has access to.
   The Enhance AFP control file is used with a step based on the BuildAFPFromDocuments step template.

• If you do not need to change how documents are processed based on results from the postal software, select the PrintAndMailJob workflow. Click Copy workflow ().
  The PrintAndMailJob workflow collects document data to send to postal software and uses a step based on the RunHotFolderApplication step template to exchange files with the postal software. After receiving the output of the postal software, the workflow updates the document data and prints the job for mailing. If you have Ricoh ProcessDirector, the workflow processes both AFP and PDF print jobs. If you are using only one format, you can delete the steps in the branch for the other format.
• If you need to take results from the postal software and split a job into child jobs that are processed by different workflows, select the GroupDocsForPostalProcess workflow. Click Copy workflow ().
  GroupDocsForPostalProcess is part of a set of three workflows:

  • GroupDocsForPostalProcess

    This workflow collects document data to send to postal software and updates the document data from the output of the postal software. Using rules that you set up to interpret the data, the workflow produces child jobs for each type of mail that the postal software identified. The workflow is configured to pass the child jobs to one of the next two workflows.

  • ProcessQualifiedDocuments

    This workflow processes child jobs created by the GroupDocsForPostalProcess workflow if the documents in the job qualified for additional postal processing. The workflow sorts the documents, using the optimal method determined by the postal software, and passes the child jobs to the PrintForPostalProcess workflow.

  • PrintForPostalProcess

    This workflow prints the child jobs created by the GroupDocsForPostalProcess workflow. The child jobs contain qualified, nonqualified, and other types of mail. The workflow makes sure that the order of documents within each job is correct for each type of mail.

  After you copy the GroupDocsForPostalProcess workflow, determine how many additional workflows you need to perform postal processing at your company.

• If you do not need to change how documents are processed based on results from the postal software, right-click the PrintAndMailJob workflow, and select Copy.
  The PrintAndMailJob workflow collects document data to send to postal software and uses a step based on the RunHotFolderApplication step template to exchange files with the postal software. After receiving the output of the postal software, the workflow updates the document data and prints the job for mailing. If you have Ricoh ProcessDirector, the workflow processes both AFP and PDF print jobs. If you are using only one format, you can delete the steps in the branch for the other format.
• If you need to take results from the postal software and split a job into child jobs that are processed by different workflows, right-click the GroupDocsForPostalProcess workflow, and select Copy.
  GroupDocs ForPostalProcess is part of a set of three workflows:

  • GroupDocsForPostalProcess

    This workflow collects document data to send to postal software and updates the document data from the output of the postal software. Using rules that you set up to interpret the data, the workflow produces child jobs for each type of mail that the postal software identified. The workflow is configured to pass the child jobs to one of the next two workflows.

  • ProcessQualifiedDocuments

    This workflow processes child jobs created by the GroupDocsForPostalProcess workflow if the documents in the job qualified for additional postal processing. The workflow sorts the documents, using the optimal method determined by the postal software, and passes the child jobs to the PrintForPostalProcess workflow.

  • PrintForPostalProcess

    This workflow prints the child jobs created by the GroupDocsForPostalProcess workflow. The child jobs contain qualified, nonqualified, and other types of mail. The workflow makes sure that the order of documents within each job is correct for each type of mail.

  After you copy the GroupDocsForPostalProcess workflow, determine how many additional workflows you need to perform postal processing at your company.

1. Select the IdentifyDocuments step, click Properties (), and then click Job Defaults. For the Visual Workbench control file property, type the path and file name of the control file that you created with Document Property Designer. Click OK.
2. Right-click the IdentifyDocuments step. Select Properties, and then click AFP. For the Visual Workbench control file property, type the path and file name of the control file that you created with Document Property Designer. Click OK.
3. If your AFP print file is not already indexed, add a step based on the IndexAFP step template before the IdentifyDocuments step.
   This step shares the control file you specified for the IdentifyDocuments step. You do not need to specify the control file here.

1. For the External document properties file property, specify the name and location that you want to use for the external document properties file.
   The default value writes a file named jobID.ToPostal.csv to the job's spool directory.
   When Ricoh ProcessDirector creates this file, it converts the document properties file into the format required by the postal software.
2. For the File type property, select CSV or Tab-delimited.
3. From the Available document properties list, select the document properties that you saved in the control file for the IdentifyPDFDocuments step (PDF) or the IdentifyDocuments step (AFP).

   

   Make sure that you include the Document number or Sequence in child job property.
4. In the Column headings field, type the names of the column headings required by postal software for the document properties. Use commas to separate the names, even if you selected Tab-delimited for the file type.
   The order of the headings must match the order of the selected document properties.
5. Click OK.

1. For the External document properties file property, specify the name and location that you want to use for the external document properties file.
   The default value writes a file named jobID.ToPostal.csv to the job's spool directory.
   When Ricoh ProcessDirector creates this file, it converts the document properties file into the format required by the postal software.
2. For the File type property, select CSV or Tab-delimited.
3. From the Document properties list, select the document properties that you saved in the control file for the IdentifyPDFDocuments step (PDF) or the IdentifyDocuments step (AFP).

   

   Make sure that you include the Document number or Sequence in job property.
4. In the Column headings field, type the names of the column headings required by postal software for the document properties. Use commas to separate the names, even if you selected Tab-delimited for the file type.
   The order of the headings must match the order of the selected document properties.
5. Click OK.

• RunHotFolderApplication step
  If your software can receive data using a hot folder, use this step to send and receive files containing document information that the postal software requires. You must:

  • Configure the postal software to watch a directory for a file with a specific name or filetype.
  • Configure the postal software to write its output to a directory with known filename characteristics.
  • Set up the network (for example, NFS or SAN), file permissions, and so on to share the directories defined for input and output on the RunHotFolderApplication step.

  The sample workflows provided with the Postal Enablement feature use this step with example directory names.

• RunExternalProgram step
  If your software accepts command line input, use this step to run the postal software directly in the workflow.

  • The postal software must have a command line invocation that can be run on the primary Ricoh ProcessDirector server. If you have Ricoh ProcessDirector, the command line invocation also can be run on a secondary server or a Windows application server.
  • You must use standard Ricoh ProcessDirector methods, such as ${getFileName(postal,bcc,read)}, to reference the files exchanged with the postal software.
• SendEmail and ManualStepWithAutoStart steps
  Use these steps for a manual interface with the postal software. The SendEmail step sends the output file to a person who submits the file to the postal software while the job waits in the ManualStepWithAutoStart step. The person puts the results file returned by the postal software into the workflow where the MapExternalResultsFiletoDocProps step expects to find the file. The person then does a Manual Complete action to let the job continue through the workflow to the MapExternalResultsFiletoDocProps step.

1. Select the RunHotFolderApplication step, click Properties (), and then click Job Defaults.
2. Right-click the RunHotFolderApplication step. Select Properties, and then click Job Defaults.
3. Specify values for the Sending folder, File to send, Retrieval folder, Retrieval pattern, and Retrieved file properties.
4. Specify values for other properties as needed.
5. Click OK.

1. Delete the RunHotFolderApplication step and replace it with the RunExternalProgram step.
2. Select the RunExternalProgram step, click Properties (), and then click Job Defaults.
3. Specify the command line invocation for the postal software in the External command field.
4. Specify other values as needed.
5. Click OK.

1. Delete the RunHotFolderApplication step and replace it with the RunExternalProgram step.
2. Select the RunExternalProgram step, click Properties (), and then click Job Defaults.
3. Specify the command line invocation for the postal software in the External command field.
4. Specify other values as needed.
5. Click OK.

1. Delete the RunHotFolderApplication step and replace it with the RunExternalProgram step.
2. Right-click the RunExternalProgram step, select Properties, and then click External.
3. Specify the command line invocation for the postal software in the External command field.
4. Specify other values as needed.
5. Click OK.

1. Delete the RunHotFolderApplication step and replace it with the SendEmail step.
2. Add the ManualStepWithAutoStart step to the workflow after the SendEmail step.
3. Select the SendEmail step, click Properties (), and then click Job Defaults.
4. Right-click the SendEmail step. Select Properties, and then click Email.
5. For the Recipient address property, specify the email address.
6. Specify the other values as needed.

   

   If you have not already specified SMTP server settings, you should specify them to enable the email function. After you save the workflow, you can access the settings by clicking the Administration tab on the Main page. In the left pane, click System → Settings.
7. Click OK.
8. Select the ManualStepWithAutoStart step, and then click Properties ().
9. Right-click the ManualStepWithAutoStart step, and select Properties.
10. Specify values as needed.
11. Click OK.

1. For the Modified results file property, specify the name and location that you want to use for the modified results file.
2. For the External results file property, specify the name and location that you want to use for the external document properties file that is returned from the postal software.
3. For the File type property, select the type of the external results file: CSV or Tab-delimited.
4. For the External results contain column headings property, select Yes or No.
   If the external results file does not contain column headings, you must edit the results file to contain only the columns of data that map to the list of selected properties. The number and order of columns in the external results file must match the number and order of the document properties in the Selected list.
5. If the external results file contains column headings, type the names of the column headings that you want to keep in the Columns to keep field. Use commas to separate the names.
6. From the Available document properties list, select the document properties that correspond to the column headings that you are keeping.
   The order of the document properties must match the order of the column headings. The step uses this Information to create a modified results file.
7. Click OK.

1. For the Modified results file property, specify the name and location that you want to use for the modified results file.
2. For the External results file property, specify the name and location that you want to use for the external document properties file that is returned from the postal software.
3. For the File type property, select the type of the external results file: CSV or Tab-delimited.
4. For the External results contain column headings property, select Yes or No.
   If the external results file does not contain column headings, you must edit the results file to contain only the columns of data that map to the list of selected properties. The number and order of columns in the external results file must match the number and order of the document properties in the Selected list.
5. If the external results file contains column headings, type the names of the column headings that you want to keep in the Columns to keep field. Use commas to separate the names.
6. From the Document properties list, select the document properties that correspond to the column headings that you are keeping.
   The order of the document properties must match the order of the column headings. The step uses this Information to create a modified results file.
7. Click OK.

The document data from your postal software is now in Ricoh ProcessDirector. The data can be used by a variety of Ricoh ProcessDirector steps.

The document data from your postal software is now in Ricoh ProcessDirector. The data can be used by a variety of Ricoh ProcessDirector steps.

1. With a text editor, create a properties conditions file.
2. Define the logic required to group documents for additional processing.
   Four sample properties conditions files are in the /aiw/aiw1/control_files/postal directory (on AIX or Linux) or the C:\aiw\aiw1\control_files\postal directory (on Windows):

   • postal_doc.csv
   • postal_doc_qualified.csv
   • postal_doc_print.csv
   • postal_doc_print_afp.csv
   For more information, see the topic on the SetDocPropsFromConditions step template in the information center.
   The GroupDocsForPostalProcess workflow uses a properties conditions file to place documents in child jobs for additional processing by the ProcessQualifiedDocuments workflow, the PrintForPostalProcess workflow, or both.
3. If you are editing a copy of the PrintAndMailJob workflow, add a step based on the SetDocPropsFromConditions step template to the workflow.
4. Select the SetDocPropsFromConditions step. Click Properties (), and then click Job Defaults. For the Property conditions file property, type the path to and name of the file. Click OK.
5. Right-click the SetDocsPropsFromConditions step. Select Properties, and then click Documents. For the Property conditions file property, type the path to and name of the file. Click OK.

1. Create one or more input devices to point to the workflow.
2. Enable the input devices.
3. Submit your PDF or AFP print job to the input device.