VaToolBxAPETransformDoc

This function is provided when using Adelia Print Engine.

It is used to execute the Apache FOP print formatter.

This engine takes the following as input:

A document in XSL-FO (eXtensible Stylesheet Language - Formatting Objects) format,
An output format (PDF, PS, PCL, PNG, etc.),

to produce an editable document as an output which can be printed by the peripherals supporting the output format.

NB: this function is the Adelia counterpart to the APE "transformxslfo" Web service.

Remember: The VaToolBx dll must already be loaded (LOAD_DLL instruction) when this function is called and must remain loaded when the VaToolBxAPEClearDataModel, VaToolBxAPEMergeDoc, VaToolBxAPEAddInDataModel or VaToolBxAPEMergeAndTransformDoc functions are called.

Application area

Java client,
Java server,
Adelia Web client,
Adelia Cloud client,
Event Adelia client.

Parameters

IMAGE	XslfoDoc	Document in XSL-FO format.
ALPHA(n)	MimeType	Result document output format. The string must be in the format defined by RFC 6838 (click here for more details ).
ALPHA(n) or IMAGE	Options	Definition of options to apply during document processing.
IMAGE	TransformDoc	Result document from executing the Apache FOP engine on the XslfoDoc document.
NUM_BIN_2	ReturnCode	Operation return code: 0: Operation completed successfully. -1: The "Options" parameter must be ALPHA or IMAGE type. -2: Error during syntax analysis in JSON format of "Options" processing options. -3: Error during value analysis of "Options" processing options. -4: Input/output error during analysis of "Options" processing options. -5: Error when closing the TransformDoc result document. The errors described below relate to the processing of the XslfoDoc document by the Apache FOP engine: 31: Apache FOP engine creation error. 32: Document transformer creation error. 33: Error when transforming the XslfoDoc document. 34: Input/output error when processing the result document. 35: Internal error when processing the XslfoDoc document produced by the engine.

Apache FOP engine output formats

This engine supports several output formats.

XSL-FO document processing options

The "Options" parameter is used to define additional characteristics when producing the result document.
The format of options must be JSON: all the options are described in an object with each member describing an option, namely:

- docDescription: option to define metadata stored in the result document (JSON Object-type value).
  This option can only be used with certain output formats which allow metadata storage.
  The Apache FOP engine currently only implements metadata support for the "application/pdf" format.
- pdfDocPolicy: option to define the document permissions policy in "application/pdf" format (JSON array of Object-type value). This groups the protection functions by password, print authorizations, etc.

For example

`ALPHA(20)`	`MimeType`
`ALPHA(256)`	`Options`
`IMAGE`	`XslfoDoc`
`IMAGE`	`TransformDoc`
`NUM_BIN_2`	`returnCode`

MimeType = 'application/pdf'
Options = '{"pdfDocPolicy": {"userPassword": "user"}}}'
...
CALL_DLL 'VaToolbx.dll' ' VaToolBxAPETransformDoc' XslfoDoc MimeType Options TransformDoc returnCode

↑ Top of page