DocConverter

Validates and transforms a PDF to the PDF/A format.

For information about using the DocConverter service, see Services Reference for AEM forms .

Validate PDF/A operation

Validates whether a PDF is compliant with the PDF/A format.

For information about the General and Route Evaluation property groups, see Common operation properties . In addition, this operation provides the following property groups and exceptions:

Input properties

Output properties

Exceptions

Input properties

Properties for specifying the PDF document and the options to use for PDF/A validation.

Input PDF Document

A document value that represents the PDF document to be validated as PDF/A.

If you provide a literal value, clicking the ellipsis button displays the Select Asset dialog box. (See About Select Asset .)

PDF/A Options

(Optional) A PDFAValidationOptionSpec value that represents the options to be used for validation.

If you provide a literal value, specify the following values.

Compliance:
The compliance level of the PDF document. The only value is PDFA_1B, which is the minimal level for documents scanned from paper or microfiche sources.

Result level:
The default is PASS_FAIL . The following values are valid.

  • PASS_FAIL: A report contains the following information about the operation result:

    • Whether the operation was successful

    • Whether the PDF document is PDF/A compliant

    • Whether certified digital signatures are permitted

  • SUMMARY: A report contains the following information about the operation result:

    • Whether the operation was successful

    • Whether the PDF document is PDF/A compliant

    • Whether certified digital signatures are permitted

    • A summarized count of any validation errors that occurred

  • DETAILED: A report contains the following information about the operation result:

    • Whether the operation was successful

    • Whether the PDF document is PDF/A compliant

    • Whether certified digital signatures are permitted

    • A list of each error that occurred with specific information about each error

Allow Certification Signatures:
The default is True , which means that certification signatures are permitted.

Ignore Unused Resources:
Sets whether to perform validation on resources that are not used in the PDF document. The default is True , which means not to perform validation on unused resources.

Job Log Level:
Sets the log level for this operation. The default is INFO . The following values can be used.
OFF:
Turn off logging of messages on the server.

SEVERE:
Log messages only when they indicate a serious failure.

WARNING:
Log messages that indicate potential problems and serious failures.

INFO:
Log messages that are for informational purposes, indicate potential problems, and indicate serious failures.

CONFIG:
Log only static configuration messages.

FINE:
Log tracing information.

FINER:
Log fairly detailed tracing information.

FINEST:
Log highly detailed tracing information.
Hinweis: The use of FINE, FINER, and FINEST will negatively impact performance on the server. Use them for debugging purposes only.

Output properties

Property for specifying the result of the operation.

PDF /Validation Result

The location to store the results of the operation, which includes the Job log file, the converted PDF document, and the validation report. The data type is com.adobe.livecycle.docconverter.client.PDFAValidationResult .

Exceptions

This operation can throw a ValidationException exception.

Convert to PDF/A operation

Converts a PDF document to PDF/A format using the options provided.

For information about the General and Route Evaluation property groups, see Common operation properties .

Input properties

Properties for specifying the input DDX file and optional documents and environmental values.

Input PDF Document

A document value that represents the PDF document to be validated as PDF/A.

If you provide a literal value, clicking the ellipsis button displays the Select Asset dialog box. (See About Select Asset .)

PDF/A Conversion Options

A PDFAConversionOptionSpec value that represents the options to be used for validation.

If you provide a literal value, specify the following values.

Compliance:
The compliance level for converting to PDF/A. The default is PDFA_1B , which is the minimal level for documents scanned from paper or microfiche sources.

Result level:
The level of reporting when the operation runs. The default is PASS_FAIL . The following values are valid.
PASS_FAIL: A report contains the following information about the operation result:
Whether the operation was successful

  • Whether the PDF document is PDF/A compliant

  • Whether certified digital signatures are permitted

SUMMARY: A report contains the following information about the operation result:
Whether the operation was successful

  • Whether the PDF document is PDF/A compliant

  • Whether certified digital signatures are permitted

  • A summarized count of any validation errors that occurred

DETAILED: A report contains the following information about the operation result:
Whether the operation was successful

  • Whether the PDF document is PDF/A compliant

  • Whether certified digital signatures are permitted

  • A list of each error that occurred with specific information about each error

Signatures:
Sets whether to archive a digital signature. The default is ARCHIVE_AS_NEEDED . The following values are valid.
ARCHIVE_AS_NEEDED:
Signatures are archived only when the signature can no longer be maintained in the PDF document.

ARCHIVE_ALWAYS:
Signatures are archived regardless of their validity in the resulting PDF/A.

Color Space:
The color space management scheme to use. The default is S_RGB . The following values are valid.
S_RGB:
Standard RGB IEC61966-2.1

COATED_FOGRA27:
Europe ISO Coated FOGRA27

JAPAN_COLOR_COATED:
Japan Color 2001 Coated

SWOP:
U.S. Web Coated (SWOP) v2

Job Log Level:
Sets the log level for this operation. The default is INFO . The following values can be used.
OFF:
Turn off logging of messages on the server.

SEVERE:
Log messages only when they indicate a serious failure.

WARNING:
Log messages that indicate potential problems and serious failures.

INFO:
Log messages that are for informational purposes, indicate potential problems, and indicate serious failures.

CONFIG:
Log only static configuration messages.

FINE:
Log tracing information.

FINER:
Log fairly detailed tracing information.

FINEST:
Log highly detailed tracing information.
Hinweis: The use of FINE, FINER, and FINEST will negatively impact performance on the server. Use them for debugging purposes only.

Output properties

Property for specifying the result of the operation.

PDF/A Conversion Result

The location to store the results of the operation, which include the Job log file, the converted PDF document, and the conversion report. The data type is PDFAConversionResult .

Exceptions

This operation can throw a ConversionException exception.

DocConverter exceptions

The DocConverter service provides the following exceptions for throwing exception events.

ConversionException

Thrown if an error occurs during conversion of a PDF document to PDF/A format.

ValidationException

Thrown if an error occurs during validation of a PDF document.

Hinweis: To receive an OperationException exception, ensure that the variable defined to contain the exception data is at least 150 characters long.