New Features

Please refer to the Redax Enterprise Server User Guide for additional information.

Redax Enterprise Server 3.3

You can now use the Rectangle tool in Adobe Reader XI (11) to mark up areas for redaction.  There are two new command line options for the Rectangle annotations added in Reader:

-cr :  convert rectangle markups
-crc : convert rectangle markups using exemption code

Redax Enterprise Server 3.0

New options for finding information in PDF files that contain text.  These options will not work with scanned PDF documents that have not been OCRed. Users should note that OCR errors will result in reduced accuracy in finding matches.

-fregex <filename> — Find using list of regular expressions
-fpattern <filename> — Find using list of pattern names

Document Optimization (-optimize)

For document optimization, use -optimize. This flag will do the following:

1. encode any non-encoded streams using Flate compression
2. remove ASCII85 filters from all streams
3. replace LZW encoded streams with Flate encoding,
4. merge identical XObjects and images,
5. optimize common sequences in page content
6. merge identical font descriptors and encodings.

This option will usually result in a smaller file size.

ISO 32000 compliance (-iso32000)

To create a document that is ISO 32000 compliant, use -iso32000. This flag will do the following: Set file for ISO 32000 compliance, resulting in a document that is PDF version 1.7.

CommandCollections (-cmds) 

To process multiple commands quickly and efficiently, use the -cmds <filename> option.  The file specified by -cmds, the commands file, should contain one or more single line commands.  Each command is just like an ordinary Redax Enterprise Server command-line without the executable name. The commands file does not support wildcards in filenames.

When you use the -cmds option, many Redax Enterprise Server options should be set in the -cmds file instead of on the command line.  The following options are supported on the command line when using the -cmds option:

-r, -l, -n, -p

If the same option is set on the command line and in the a record of the -cmds file, the option value from the -cmds file record will be used.

For more information on the -cmds option, see Command Collections.

Redax Enterprise Server 1.5

Streamlined definition of preferences

Define all of your preferences in an XML file using the RedaxESconfig (formerly called ApConfig for Redax) utility, and then specify the file following the -pref option when you run Redax Enterprise Server. The command-line options that were used in former versions to specify preferences are still functional but have been deprecated. If you specify a preferences file and one or more deprecated preference options on a command, the options in the preferences file overwrite the deprecated preferences. For information about using RedaxESconfig (formerly ApConfig for Redax), see the online help supplied with the utility. For information about specifying a preferences file in your command, see the Redax Enterprise Server User Guide.

Case-insensitive search option with list files

When searching for and applying Redax boxes to text based on the words and phrases in a list file, you can have Redax Enterprise Server perform a case-insensitive search by specifying the -ignorecase option. When the -ignorecase option is specified, Redax boxes are drawn around all words and phrases in the document that match the words and phrases in the list file, regardless of capitalization. For example, if the list file contains the word govern, but does not contain Govern or GOVERN, Redax boxes will be drawn around govern, Govern, and GOVERN. Without the -ignorecase option, Redax boxes would only be drawn around govern.

Redaction by category

Classify information that you mark up for redaction by category, and redact as many of the categories as needed.

You define each category in a separate preferences files using the RedaxESconfig (formerly called ApConfig for Redax) utility supplied with Redax Enterprise Server. For example, you might define the category Internal in one preferences file and the category External in another preferences file.

Then you run Redax Enterprise Server once for each markup category you want to include in the PDF document. For example, you might apply one list file and specify the preferences file containing the Internal category, and then apply another list file and specify the preferences file containing the External category:

redaxserver -o outfile.pdf -flist internal.txt -pref internal.xml input.pdf

and then . . .

redaxserver -o outfile.pdf -flist external.txt -pref external.xml input.pdf

When you redact the document, you specify whichever categories you want to include in the redaction, as in the following examples:

redaxserver -o outfile_redacted.pdf -redact -redaxcat Internal outfile.pdf

or . . .

redaxserver -o outfile_redacted.pdf -redact -redaxcat External outfile.pdf

or . . .

redaxserver -o outfile_redacted.pdf -redact -redaxcat Internal, External outfile.pdf

For information about defining a category in a preferences file, see the online help supplied with RedaxESconfig (formerly called ApConfig for Redax). For information about applying categories during markup and redacting based on category, see the Redax Enterprise Server User Guide.

Appearance of redacted areas

Define the appearance of redacted areas in your preferences file. Select any printable character or a blank space to replace redacted text. Choose a color and transparency level for the interior of the redacted area (Fill) and for the border around it (Frame).

For information about using RedaxESconfig (formerly called ApConfig for Redax) to define preferences for the appearance of redacted areas, see the online help supplied with the utility. For information about specifying a preferences file in your command, see the Redax Enterprise Server User Guide.

Redaction of encrypted files

You can now mark up and redact an encrypted PDF document with Redax Enterprise Server. On your command line, supply the Owner password following the -d option. For more information about the -d option, see the Redax Enterprise Server User Guide.

Option to condense fully redacted pages

If you mark up and redact complete pages with the -markpages option, you can have Redax Enterprise Server condense all of the redacted pages in a range into one page. You check the option to condense fully redacted pages in a preferences file that you create using RedaxESconfig (formerly called ApConfig for Redax), and then specify the preferences file on the command line following the -pref option.

For information about defining the option to condense fully redacted pages in a preferences file, see the online help supplied with RedxESconfig (formerly called ApConfig for Redax). For information about using the -pref option, see the Redax Enterprise Server User Guide.

Additional report detail

Redax reports now include more detail. Each report indicates the total number of Redax boxes and Full-page tags and contains the following information for each one:

• Page number
• Type of markup (Redax box or Full-page tag)
• Creation date and time
• Redaction category
• Box color
• Exemption code
• Author
• Note
• Top, left, bottom, and right coordinates, if the markup is a Redax box

Redax Enterprise Server 1.1.2

Full page redaction

Mark one or more full pages for redaction, using the command-line option -markpage <“pagelist”>, where pagelist is a comma separated list of pages and/or page ranges.

For example:

redaxserver -o outfile.pdf -markpage "2,23-48,300" input.pdf

marks pages 2, 23 through 48, and 300 for redaction. By default, no exemption code is applied. Use -exemption, below, to assign an exemption code, or use -noexempt when redacting to allow redaction without exemption codes.

The command-line option -markpages is a synonym for -markpage.

Assign exemption codes when finding text

Assign exemption codes when finding text using the command-line option -exemption <“code”>, where code is the exemption code to assign. -exemption works with the following options:

• -markpage
• -markpages
• -fbracket
• -fimage
• -ftext

For example:

redaxserver -o outfile.pdf -markpage "2,23-48,300" -exemption "b3" input.pdf

marks pages 2, 23 through 48, and 300 for redaction, and assigns the exemption code b3 to the Redax boxes.

Exemption code handling

Specify how exemption codes are handled with the command-line option -exemptioncode <“option”>, where option can be:

• present (default) – exemption code is stamped over the redacted area.
• clip – exemption code is stamped over the redaction area, but is clipped so that the code does not run outside the redacted area and obscure unredacted text.
• wrap – exemption code is wrapped if it exceeds the length of the redacted area.
• atbottom – all exemption codes for the page are stamped on the bottom of the page.
• remove – no exemption codes are placed in the document.

Detailed reporting

You can get more detailed reporting than -sumfile provides using the command-line option -detfile <filename.xml>. This option outputs an XML file containing a detailed report of the redaction. The following options are available with -detfile:

• -detpage <pagenumber> – restricts the output file to just one page specified by pagenumber.
• -detdtd – includes a DTD in the output XML file.

These options must be used with -detfile.

For example:

redaxserver -o outfile.pdf -detfile "log.xml" -detdtd input.pdf

redacts input.pdf, creates a detailed report, and includes the DTD in the XML file so that the information can be repurposed.

Preserving the Redax boxes

You can stamp a box around the redacted area using the command-line option -showrectangle. This option permanently stamps black boxes around the redacted area.

Known Issues

Version 1.5

Bookmarks are not preserved with full-page redaction

The Preserve Bookmarks preference is not supported when you use the -markpages command-line option. Bookmarks may be copied to the redacted file, but they will not be active.

Exemption codes might not be clearly visible in converted markup

When you convert Acrobat markup to Redax markup (-cm, -ch, -cu, and -cs options), exemption codes might not be clearly visible in boxes.

Workaround

Change one or both of the following in your preferences file:

• Decrease the Font Size.
• Select an option other than Clip Exemption Code to Rectangle.

Exemption codes are not always placed correctly on rotated pages

If your preferences file specifies an Exemption Code Position of Top Left, Center, or Bottom Left, the exemption might not be placed correctly on rotated pages.

Workaround

In your preferences, specify the Bottom of Page Exemption Code Position on the Redactions tab. Positioning and word wrapping of exemption codes do not always work together correctly

• If your preferences file specifies an Exemption Code Position of Center or Bottom Left and the Word Wrap Exemption Code option, the exemption code will be placed in the top left position.
• If your preferences file specifies an Exemption Code Position of Bottom of Page and the Word Wrap Exemption Code option, the exemption code will be placed at the bottom of the page but it will not wrap.

Acrobat 7 might not print files containing Redax markup as expected

• The file might take a long time to process.
• At times, the boxes print but the page content does not.

Workaround

Try printing from Reader 7.

Redacted bitmap images are sometimes replaced with black space instead of white space

When bitmap images are redacted, the redacted portion of the image is replaced with white space. Occasionally in some files, black space is used instead.

Redax boxes drawn using Redax plug-in version 3.7 or earlier do not appear

When you open a PDF file that contain Redax boxes drawn in version 3.7 or earlier of the Redax plug-in product, the boxes do not appear, even though they are in the file.

Workaround

Click in the boxed area to make the box appear.

“Find Using List File preferences.xml cannot be opened for reading” error message appears

This is the error message that’s reported when the wrong path to the preferences file is given on the command line.

Version 1.1.2

-fillrectangle option not yet supported

The -fillrectangle option that appears in the usage is not currently supported but is there for a future release.

Version 1.1.1

Type 3 fonts not supported

The current version of Redax Enterprise Server does not support Type 3 fonts. You can use Appligent’s APGetInfo utility to find out whether a PDF file contains Type 3 fonts.

Some special characters cause problems importing XML templates (-impfile)
If a field in a Redax box contains the less than symbol (<), ampersand (&), double quotation mark (“), single quotation mark (‘), or an ASCII character higher than 127, an XML template can be exported (created), but it cannot be imported (applied to another document).

Error message

For a double quote, the error message is as follows:

XML Parse error at line n
Error = 4

not well-formed (invalid token)

Workarounds

• Avoid using the problem characters in Redax boxes.
• Edit the XML template.

Operating system may cause problems with special redaction characters (-char)

• If you want to use a space or any of the following as the redaction character, you must enclose it in double quotes under Windows (for example, “*”) or single quotes under Unix or Macintosh (for example, ‘*’):
  @ ^ & * ‘ | < > / . ” ?
• If you want to use a percent sign as the redaction character under Windows, enclose two percent signs in double quotes:
  “%%”
• Do not use any of the following as the redaction character. Errors may result.
  – ( )
• Do not use the following character combination. The command will not be executed.
  -/
• If a percent sign (%) or double quotation marks are specified (“”) when the Redax box is created, the selected text is replaced by the default redaction character, a dash (-). This applies to Redax boxes created with the -char option, as well as Redax boxes created using other methods (for example, drawn using Redax plug-in).

Images redacted with black may result in invisible exemption codes (-blank)

If an image is redacted with black, exemption codes will not be visible.

Workaround

Avoid using the -blank command-line option.

Markup may not be completely removed (-cm, -rmarkup, -crem)

When -cm, -rmarkup, and -crem are used together, some markup might remain, although the areas underneath are redacted.

Workaround

Use -remall to remove all markup, including Redax boxes.

Invalid command-line option may be interpreted as file name

If a word on the command line begins with a hyphen, but is not a valid option, Redax Enterprise Server assumes that the word is file name.

To Get Help

Documentation for Redax Enterprise Server can be found at /redax-enterprise-server/.

Contact technical support by:

emailing support@appligent.com, or calling 610-284-4006

Please provide the following:

Product name and version number
Operating system
Your name, company name, email address, and phone number
Description of your question or problem

Responses are typically emailed within one business day.