RegisterRequest function

The RegisterRequest function registers a request file from the watch folder by creating a request record for it in the run-time database and moving the request file to the storage folder, thus removing it from the watch folder. It does not parse the request file itself.

Parameters

The RegisterRequest function does not have any parameters. It searches the configured watch folder for XML files:

  • If an XML file is found, it is assumed to be a request file, and it is processed.
  • If multiple XML files are found, they are picked up one be one, but the order is not determined.

Result

If an XML file is processed successfully, RegisterRequest returns true. If no XML file is found in the watch folder, RegisterRequest returns false.

When an error is encountered, the erroneous request file is moved to the error folder, and an error information file is written next to it.

You cannot call RegisterRequest from different processes simultaneously, if the same watch folder is used.