PDF to PDF/A Converter (Version 1.0.0): Functions and Operations

The PDF/A file format was developed for the long-term archiving of documents and is standardized by the ISO (International Organization of Standardization).

The PDF to PDF/A Converter converts a PDF document into a PDF/A document. Encrypted PDF documents can also be converted. After the conversion, the encryption is no longer present.

Properties

Operation

Determines which operation the adapter performs

Possible values:

Convert to PDF/A: Converts a PDF document (input) into a PDF/A document.

Parameters

`Adapter`	Main class of the adapter (do not change!) Possible values: `de.softproject.x4.pdf.PDFtoPDFAConverter`
`format`	Specifies the PDF/A format into which the entered PDF document is to be converted. Possible values: `PDF/A-1a` `PDF/A-2a` `PDF/A-3a` `PDF/A-1b` `PDF/A-2b` `PDF/A-3b` `PDF/A-2u` `PDF/A-3u`
`strategies`	Specifies one or more strategies that control the conversion process. Multiple strategies are separated by commas. Recommended value: `JustFixIt` Note: With the value `JustFixIt`, is intended to achieve the highest conversion rate. This means that all possible changes are applied to achieve the output format. However, this may result in the removal of content (e.g. unauthorized attachments) that is not permitted in the output format or cannot be adapted or converted. For further values, see Parameter Strategies: Possible Values.
`documentPassword`	Password for encrypting the PDF document. After conversion to PDF/A, the document is no longer encrypted, as PDF/A does not provide for encryption. Possible values: String in password format
`fonts`	Specifies which fonts are required for the conversion and should be embedded. Note: The following fonts are supplied and do not need to be specified separately: `Times` `Times-Italic` `Times-Bold` `Times-BoldItalic` `Helvetica` `Helvetica-Oblique` `Helvetica-Bold` `Helvetica-BoldOblique` `Courier` `Courier-Oblique` `Courier-Bold` `Courier-BoldOblique` `Symbol` `Zapfdingbats` Possible values: Fonts require the file extension `.ttf` or `.otf`. Possible values can be comma-separated paths to folders or files. If the path to a folder is specified, all files in the folder are used. Examples: `C:\Windows\Fonts` `C:\Windows\Fonts\Arial.ttf` Remedy for the error message – Unembedded Type Font set If the conversion fails with the message Unembedded Type Font set, then the font to which you want to convert may be missing. In this case, the font required for the conversion must be added.
`colors`	Sets the standard for the color space (ColorCode). Color spaces are required to transfer the colors during conversion. Note: It is recommended to set at least one color space for CMYK and one color space for RGB. The color space for RGB can be set via the parameter `addStandardRGBColorSpace`. Possible values: Color spaces require the file extension `.icc`. Possible values can be comma-separated paths to folders or files. If the path to a folder is specified, all files in the folder are used. Examples: `C:\ColorSpaces`* `C:\ColorSpaces\rgb.icc` Recommended color space: ISOcoated_v2_bas.ICC based on FOGRA39L For further information on color spaces, see: https://www.colormanagement.org/en/isoprofile2009.html#ISOcoated_v2_bas and https://www.color.org/index.xalter.
`addStandardRGBColorSpace`	Determines whether the standard sRGB color space of Java should be used. Note: We recommend setting the standard for RGB via `addStandardRGBColorSpace` if no RGB color space has been set via the `colors` parameter. Possible values: `true`: The standard sRGB color space of Java is used. `false`: The standard sRGB color space of Java is not used.
`validate`	Determines whether the output of the conversion should be validated. Possible values: `true`: The output is validated. `false`: The output is not validated.
`forceConversion`	Forces the conversion, even if it is not required. Possibel values: `true`: The conversion is forced. `false`: The conversion is not forced.

Status values

`1`	The operation was performed successfully.
`-1`	An error occurred during the operation.