Products Downloads


French version


 

 

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.

 

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

  • Aucune étiquette