ECM PDF Generator Matrix

File name, temporary target directory and the procedure of creating PDF files are defined via the PDF Generator Matrix.

images/download/attachments/68158124/PDF_Gen_Matrix_1_en.png

A separate procedure can be defined and a line entered in the PDF Generator Matrix for each document definition, i.e. for each document type and report ID.

The following table provides an overview of the individual fields and their meaning:

Field

Meaning

Document definition code

The respective document definition is assigned to the matrix line in this field. This matrix line therefore applies to all document definitions and reports (documents) and thus to all document types.No definition code has been stored in the figure above.

Report ID

A specific report (print report) is assigned to the matrix line in these fields.

Report Name

PDF File Name Type

Prefix

Minimum File Name Digits

Separator

Extension

The name parts are defined in this field. The following options are available:

  • Transaction no.

  • Transaction no. + user ID

  • User ID + transaction no.

  • Record ID
    With this option, the file name is generated from the primary key of the record belonging to the document. However, because this is not unique, theLoad in BLOB field is automatically enabled.

When selecting one of the options containing the Transaction no., you can specify more options. The following four fields are used to define how the unique PDF file name is composed in these cases:

  • PDF File Name Prefix:A character combination with which every PDF file name starts can be stored here.

  • Minimum File Name Digits :The minimum length of the transaction number string of the file name is defined here.

  • PDF File Name Separator :A character that is inserted between the individual name parts can be stored here.

  • PDF File Extension: By default, .PDF should be entered here.

Example
When you specify the name prefix M1 and a transaction number with at least eight digits, as well as the underscore as a separator when using the TransactionNo.+UserID option, the file name might look as follows, for example: !m100001234_meier.pdf.

Initial File Handling Interval

This field controls the timing of the PDF file handling. File handling here refers to checking for the existence of the file. The length of time (in milliseconds) after whose expiration Microsoft Dynamics 365 Business Central will check that the file was actually generated and exists is entered in this field. This serves to ensure that the generation of the PDF file is complete before Microsoft Dynamics 365 Business Central continues with further processing. The default value is 2000 milliseconds.

File Handling Interval

This field controls the timing of the PDF file handling. File handling refers to checking for the existence of the file. The maximum cycle time for the Microsoft Dynamics 365 Business Central file handling routine is defined in this field. How much time the processing of the PDF file actually requires depends on the server hardware, the response time of the external ECM systems, and network speed. The default value is defined as 15000 milliseconds, i.e. 15 seconds. If the maximum throughput is exceeded, an error message will occur.