The app DEC allows to deploy the delayed documents update through a server. The delaying can be defined by a Doc\DocUpDoc config and some special functions of the script library DocExtLib. At the saving of a document and starting the updating of all related documents, if an user hasn't access to edit some of the documents, but the delayed update is enabled, the documents will be updated through the sending the requests onto the server. By default the requests for documents update are sent to the special mail-in database on the server where they will be instantly processed by the special agent.
App using
The app DEC contains the design elements to deploy the delayed documents update. For the deploying you can use the app DEC itself but is more convenient to use instead of it a stand-alone app with some its design elements. You can also use the same stand-alone app to deploy documents' update log.
Desing elements
In the list are specified the design elements of the app DEC that are required for deploying the delayed documents update. You should copy them to new stand-alone app if you have decided to use it for this purpose instead of DEC.
| • | The script library DocExtLib. It will process the changes delays; |
| • | The agent "Delayed Documents Update - Processing Incoming Request", trigger - "Before new mail arrived". It will instantly process a request for document update arrived as e-mail message. |
| • | The agent "(Delayed Documents Update - Process Requests)". It's running on selected in view documents. You should use the agent for manually processing a request for document update to get info about an error because of which it was not processed automatically. |
| • | The agent "(Delayed Documents Update - Set Requests as Unprocessed)". It's running on selected in view documents. The agent sets the status New in a request for document update that it could be processed again. |
| • | The view "Delayed Documents Update". For viewing the requests for documents update and troubleshooting. |
| • | The form "Delayed Documents Update - Request". The form displays the request for a document update. |
Mail-in database
To use the delayed documents update you must set mail-in database on server in order to receive the requests for the documents update. By default is expected the using of the address DEconfig. If you want to use an alternate address type it as value of the variable DE_DELAY_MAIL in the app DEC. Define what app you will use to deploy the delayed documents update and set it as mail-in database on server. Next make sure that the agent "Delayed Documents Update - Processing Incoming Request" is enabled in the app.
Request for document update
A request for document update is document that is being sent to the special app chosen to process the requests ( mail-in database ). A request contains full info about the document update including the service fields and the all fields which should be updated in the target document. A request can be viewed through the form "Delayed Documents Update - Request" ( DocUpDelay ) in the view "Delayed Documents Update" of the app processing the requests.
The service fields of a update request are begun on DEdelay:
| • | DEdelay - the sign of that the document is request; |
| • | DEdelayError - the existence of the field means the request was processed. Any text in the field means the request was processed with an error and describes it; |
| • | DEdelayTime - the time when the request was created; |
| • | DEdelayTrgDoc - the UNID of target document that should be updated; |
| • | DEdelayTrgFields - the names of fields of target document. All the fields listed here are present in the request with values that should be set in the target document; |
| • | DEdelayTrgFile - the file name of app with target document; |
| • | DEdelayTrgServer - the server name of the app with target document. |
Variables NOTES.INI on server
Make sure that the variables DE_CONFIG_SERVER, DE_CONFIG_FILE, DE_CONFIG_LANGUAGE are set in NOTES.INI file on server which the app for processing the requests for documents update is placed on. Read more about these variables in the help topics: Start of the App Using and Script Library Variables.
Topic links:
See also: