AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.
List of all the APIs that are accounted as transactions
AEM Forms provides several APIs to submit forms, process documents, and render documents. Some APIs are accounted as transactions and others are free to use. This document provides a list of all the APIs that are accounted as transactions in a transaction report. Here are a few common scenarios where a billable API is used:
Billing APIs does not account for the number of pages, the length of a document or form, or final format of the rendered document. A transaction report divides the transactions into three categories: Documents Processed, Documents Rendered, and Forms Submitted.
Transaction Reports UI displays three categories: Forms Submitted, Documents Rendered, and Documents Processed. Both Documents Rendered and Documents Processed are accounted as Documents Rendered.
API |
Description | Transaction report category | Additional Information |
createPDF | Creates Adobe PDF from supported file types. | Documents Processed | |
createPDF2 | Creates Adobe PDF from supported file types. | Documents Processed | |
exportPDF | Converts Adobe PDF to supported file types. | Documents Processed |
|
exportPDF2 | Converts Adobe PDF to supported file types. | Documents Processed |
|
exportPDF3 | Converts Adobe PDF to supported file types. | Documents Processed |
|
htmlFileToPdf | Creates PDF from HTML pages. |
Documents Processed |
|
htmlToPdf | Creates PDF from URLs pointing to an HTML page. | Documents Processed |
|
htmlToPdf2 | Creates PDF from URLs pointing to an HTML page. | Documents Processed |
|
optimizePDF | Optimizes PDF to reduce file size by stripping unnecessary metadata without affecting the quality. | Documents Processed |
API |
Description | Transaction report category | Additional Information |
createPDF |
Creates Adobe PDF from supported file types. | Documents Processed | |
createPDF2 | Creates Adobe PDF from supported file types. | Documents Processed |
API |
Description | Transaction report category | Additional Information |
render | Invokes the specified render method to generate a document of record using provided parameters. | Documents Processed |
API |
Description | Transaction report category | Additional Information |
generatePDFOutput | Merges data and templates to create a PDF document. | Documents Processed | |
generatePDFOutputBatch | Merges data and templates to create a set of PDF documents. | Documents Processed | |
generatePrintedOutput | Converts XDP and PDF documents to PostScript (PS), Printer Command Language (PCL), and ZPL file formats. | Documents Processed | |
generatePrintedOutput | Converts XDP and PDF documents to PostScript (PS), Printer Command Language (PCL), and ZPL file formats. | Documents Processed | |
generatePrintedOutputBatch | Converts a set of XDP and PDF documents to a set of PostScript (PS), Printer Command Language (PCL), and ZPL file formats. | Documents Processed |
API |
Description | Transaction report category | Additional Information |
renderPDFForm | Renders PDF Form from XDP templates. The XP templates are created in Forms Designer. | Documents Processed | |
exportData | Extracts data from a PDF Form or XDP templates | Documents Processed |
API |
Description | Transaction report category | Additional Information |
toImage | Converts a PDF document to a list of image documents. Supported image formats are JPEG, JPEG2K, PNG, and TIFF. | Documents Processed | |
toPS | Converts a Flat PDF file to PostScript format using the options specified in the option spec. | Documents Processed |
API |
Description | Transaction report category | Additional Information |
decode | Decodes all the barcodes in a Document object and returns an org.w3c.dom.Document object that contains data that was retrieved from the barcode. | Documents Processed |
API |
Description | Transaction report category | Additional Information |
invoke | Executes the specified DDX document and returns an AssemblerResult object containing the resultant documents. | Documents Processed | The following operations are not accounted as transactions:
|
invoke | Executes the specified DDX document and returns an AssemblerResult object containing the resultant documents. | Documents Processed | All the input file formats that PDF Generator, Forms, and Output services support, Assembler service supports all those formats as output file formats. |
toPDFA | Convert a specified document to PDF/A using the options specified. | Documents Processed |
API |
Description | Transaction report category | Additional Information |
convertPDFtoXDP | Converts a PDF document into an XDP file. In order for a PDF document to be successfully converted to an XDP file, the PDF document must contain an XFA stream in the AcroForm dictionary. | Documents Processed |
API |
Description | Transaction report category | Additional Information |
secureDocument | The API enables you to secure your document. You can use the API to sign, certify, reader extend, or encrypt a PDF document. | Documents Processed | Only sign and certify operation of the secureDocument are billed. |
All the submission events of adaptive forms, HTML5 Forms, and form set are accounted as transactions. By default, submission of a PDF Form is not accounted as a transaction. Use the provided transaction reports API to recording a PDF Forms submission as a transaction.
Use Case |
Description | Transaction report category | Additional Information |
Submitting an adaptive form | Submits an adaptive form to configured submit action. | Forms Submitted |
|
Use Case |
Description | Transaction report category | Additional Information |
Submitting an HTML5 Form | Submits an HTML5 Form to submit URL configured in the form. | Forms Submitted |
API |
Description | Transaction report category | Additional Information |
Submitting a form set | Submits form set to the submit URL configured in the form set. | Forms Submitted |
|
Assign task and document services steps of Form-centric AEM Workflows on OSGi and all the renditions of interactive communication and are accounted as transactions. Previewing an interactive communication on the author instance and previewing on the publish instance using Agent UI are not accounted as transactions. If a workflow step accounts a transaction and the workflow fails to complete, the transaction count is not reversed.
API |
Description | Transaction report category | Additional Information |
Rendering a web channel | Opens the web version of an interactive communication. | Documents Rendered |
|
API |
Description | Transaction report category | Additional Information |
render (convert to PDF) | Generates the PDF version of an interactive communication. | Documents Rendered |
|
Use case |
Transaction report category | Additional Information |
Submitting an Assign Task step | Forms Submitted |
|
Submitting a workflow application startpoint | Forms Submitted | |
Submitting an interactive communication (Print Channel) from the Agent UI to a workflow | Documents Rendered |
Actions like submitting a PDF Form, using Agent UI to preview an interactive communication, using non-standard form submission, and custom implementations are not accounted as transactions. AEM Forms provides an API to record such actions as transactions. You can call the API from your custom implementations to record a transaction.