Adding text to a PDF file

You can add fixed text or variable text to a PDF file. You also can combine fixed and variable text in one text box. Fixed text is text that you type. Variable text is data from document properties, job properties, or statistics.
To add text:
  1. Open a PDF file in Adobe Acrobat Professional and either load a control file that contains a page group or define a page group.
  2. Use the left mouse button to draw a box in the area where you want to add text.
    RICOH ProcessDirector Plug-in for Adobe Acrobat uses the upper left corner of the text box to position the text. All the text you specify is printed at the size you specify, even if the text does not fit inside the box.
  3. Click Add Text.
  4. Optional: Use the Location section of the definition window to change the placement of the text by entering new Horizontal and Vertical coordinates. These coordinates specify the distance between the top left corner of the page and the top left corner of the text box.
    Note: Width and Height change the size of the markup box but do not affect the location or size of the text.
  5. Type a Name for the text box. Do not use spaces or special characters (such as @, #, $, or %) in the name. You can use periods and underscores.
  6. Select a value from the Align with enclosed text drop-down list:
    • If you want to align the text that you are adding with the first occurrence of existing text enclosed by the box you drew, select First occurrence. RICOH ProcessDirector Plug-in for Adobe Acrobat maintains that position each time that it adds the text.
    • If you want to align the text that you are adding with each occurrence of existing text enclosed by the box you drew, select Each occurrence.
    • If you do not want the text aligned, use the default value Disabled.
    Aligning new text with enclosed text is the most precise way to replace existing text.
      Note:
    • The Align with enclosed text function works best when the new text and the existing text are in the same font. If the fonts are different, RICOH ProcessDirector Plug-in for Adobe Acrobat aligns the baselines of the fonts.

    • RICOH ProcessDirector Plug-in for Adobe Acrobat always aligns the first line of the new text with the first line of the existing text.

    • If the enclosed text is not left-justified, RICOH ProcessDirector Plug-in for Adobe Acrobat aligns the new text with the left-most line of the existing text.

  7. Select the clockwise Rotation (degrees). The reference point for rotating a text box is its top left corner.
  8. Use the Placement Conditions section to specify the pages to place the text on. Do either of these:
    • Select Pages based on a rule, and then select a rule from the drop-down list. The default rule is All Pages. You can also:
      • Click the Add content icon icon to define a new rule. See Defining a rule for more information.
      • Click the Rules Manager icon icon to go to the Rules Manager.
    • Select Specify pages and type the pages in each page group that you want. You can:
      • Use a hyphen to separate the first and last pages in a page range.
      • Use a comma to separate page selections.
      • Type n to specify the last page.

        Example: a PDF file has two page groups. The first has four pages, and the second has seven pages. Specifying pages 3–n places markup on pages 3–4 in the first page group, and pages 3–7 in the second.

  9. Use the Font section to select the font, size, and color.
    The font drop-down list includes all fonts available to Adobe Acrobat except for fonts that do not permit embedding in a PDF file.
      Note:
    • To make a font available to RICOH ProcessDirector Plug-in for Adobe Acrobat, install it in the Windows Fonts folder.
    • RICOH ProcessDirector Plug-in for Adobe Acrobat does not support alternate letter forms, including ligatures, swashes, and letter forms that vary according to where they appear in a word. Right-to-left languages, such as Hebrew and Arabic, are rendered incorrectly. However, the font drop-down list shows all fonts installed in the Windows Fonts folder, including fonts for right-to-left languages and fonts with unsupported alternate letter forms.
    • When a font is added to a control file, it is the user’s responsibility to make sure that the font is licensed on all machines that use the control file to process a PDF document.
  10. Define the content of the text you are adding:
    1. Select the first Content Type from the drop-down list. You can select as many of the following types as you need to define the text content:

      Text markup content types

      Content Type Description
      Text Type text that you want to print.
      Document Property Select a document property whose value you want to print.
      Job Property Select a job property whose value you want to print.
      Line Break Select this content type to force a line break. The break occurs after the last character of any prior text content.
      Statistic Select a statistic whose value you want to print.
      Script Only select this option on the advice of your software support representative.
    2. Select the Content Value. The drop-down list has the available values for the selected Content Type.
    3. Optional: You can apply text modifier rules to the value of a document property, job property, or job statistic Content Type. Click the Edit icon icon to define one or more text modifier rules to extract the exact value you need.
    4. Type text in the Text to Modify field. RICOH ProcessDirector generates or extracts statistics and properties as it processes each page group in the production PDF files. Because these values are not available to RICOH ProcessDirector Plug-in for Adobe Acrobat, you must enter a text value that is representative of the values that RICOH ProcessDirector processes. The modifier rule is a template that is applied to all values of the content type that you selected. For example, you might need to print only the last four digits of a credit card number, and you have stored the entire number in a document property. You select Document Property as the Content Type, and select the credit card document property as the Content Value. You define two Remove Character text modifier rules to strip dashes and spaces from the number to make them all uniform, and then you define a Substring by Position rule to retain only the last four digits. You do not need to know any single value of a document property to create modifier rules, you need to know only the possible formats that could occur in your PDF files.
    5. Choose one of the following modifiers:

      Content modifiers

      Modifier Action
      Remove Character Type one character or a blank character (use the space bar to type a blank character) that you want to remove from the value. The character is case-sensitive. Then select one of these buttons:
      • Remove all instances of the character

        The specified character is removed from all positions in the value.

        For example, an account number is: 324-1443255-11. You can type a - to remove all - characters from the value, producing 324144325511.

      • Remove leading characters

        The specified character is removed from the beginning of the value. For example, if you type a blank character, all blank characters are removed from the beginning of the value.

      • Remove trailing characters

        The specified character is removed from the end of the value. For example, if you type a blank character, all blank characters are removed from the end of the value.

      • Remove leading and trailing characters

        The specified character is removed from the beginning and end of the value. For example, if you type a blank character, all blank characters are removed from the beginning and end of the value.

      Substring by Position Select Beginning of Line or End of Line from the Starting From list. Select a number for First Position to indicate the location of the first character in the text value. Select a number for Number to Retain to indicate how many characters are retained.
      Substring by Delimiter Type a character or a blank character in the Delimiter field to indicate where the text value is split into separate string segments. The character and the text string are case-sensitive.

      Select Beginning of Line or End of Line from the Starting From drop-down menu.

      Select a number for First Position to define the position of the delimiter in the text string.

      Select a number for Number to Retain to define the number of text string segments to retain.

      These examples show how to select text string segments by specifying a delimiter:

      • For the account number 324-1443255-11, you can use - as the delimiter to split the value into these three text strings: 324, 1443255, and 11. Select Beginning of Line. To select the second and third text strings (1443255 and 11), select 2 for both First Position and Number to Retain.

      • For the mailing address Eldorado Springs CO 80025, you can use a blank character as the delimiter to split the value into these four text strings: Eldorado, Springs, CO, and 80025. Select End of Line.

        • To select the zip code, select 1 for both First Position and Number to Retain.

        • To select the state, select 2 for First Position and 1 for Number to Retain.

        • To select the city, select 3 for First Position and 10 for Number to Retain. By specifying 10 for Number to Retain, you can select city names with up to ten words.

      Pad with Character Select Beginning of Line or End of Line from the Padding Location list. Enter a character or a blank character as the padding character into the Character to Pad with field.

      Enter a number in the Minimum Padded Text Length field to define the minimum length of the text string. If the number of characters in the text string is less than this minimum length, padding characters are added until the text string equals the minimum length.

  11. Click Add document property icon to add a new content definition row. After you have added all content types and modifier rules to the text you are adding to the PDF file, you can place a check mark in the box next to a content type and use the up and down icons to reorder the content. Use the Trash can icon icon to delete selected content.
  12. If you defined multiple lines of text and you want RICOH ProcessDirector Plug-in for Adobe Acrobat to remove lines that only contain white space, click the Remove blank lines check box to select it.
  13. Click OK to create the text configuration.
  14. Click Ricoh Preview to verify the text has the content and page placement you intended.
  15. Optional: You can edit the text definition by double-clicking its box or by right-clicking the box and clicking Edit.
  16. When you are ready to save all your enhancements to the PDF file, including the new text definition, click Ricoh Save Control File.
  17. Move the control file to a directory location that RICOH ProcessDirector can access.
  18. In the RICOH ProcessDirector BuildPDFFromDocuments step, specify the name and location of the control file that contains the text definition.