Asynchronous document creation

This manual page contains information on the asynchronous document creation.

1. Asynchronous document creation

When you enable a document type for DocumentBuilder, the system activates a new logic in the background, through which the corresponding documents are generated asynchronously. This asynchronous logic enables processes to be executed simultaneously and independently of each other, instead of one after the other.
The advantage: You can continue to use the system without having to wait until the documents have been generated.

1.1. Necessary adjustments to the PlentyONE event procedures

Asynchronous document creation requires that every procedure involving a document (document procedure) be created in one single event. Any existing event procedures that contain several document procedures must be adjusted accordingly.

Example: You have set up an event procedure that triggers both the creation of a document and the sending of this document by email. You will need to split this event procedure into two consecutive event procedures. This way, you ensure that the e-mail can only be sent out once the document is available.

1.2. Recommended adjustments to the PlentyONE processes

The Save and Print sub-procedures each contain the step document generation. To allow the document generation step to be performed independently and asynchronously, the sub-procedure Generated was introduced.

Since then, the system has had three sub-procedures by which to generate documents:

  • Generated: The document is generated within the order.

  • Save: The document is generated within the order and also saved.

  • Print: The document is generated within the order and also printed.

Recommendation: Use the sub-procedure Generated at the beginning of a process

Use the sub-procedure Generated at the beginning of a process. This means that, if documents are to be printed or saved later in the process flow, the process of generating those documents will already have taken place. This can improve process speed.

Note: To set up processes that access printers and local storage locations, you will need to have installed plentyBase.