SOAP Asynch Communication Steps

The communication with the SOAP server occurs in an asynchronous way, meaning that Nammu won't obtain a lemmatised file right after it requests so, since it takes some time for the ORACC server to prepare the response. Instead, these are the steps followed when validating or lemmatising a file:

1. Nammu sends an HTTP POST requests to Nammu containing the project ID, the command that it wants to run (validate, lemmatise, etc.) and the encoded ATF file.

2. The ORACC server acknowledges it has received the request and returns a request_id identifying the process whilst it starts to unpack the ATF and perform the action requested by Nammu.

3. Nammu receives the request_id and asks the ORACC server via HTTP GET if the process associated to that request_id is done. Nammu will keep on doing this until the server is done, there's an error in the server or it times out.

4. When the server is done, it returns a done string to the client.

5. Once Nammu knows the server is done, it sends another HTTP POST request asking for the results of the process requested in step 1. The HTTP POST contains a SOAP Envelope containing the request_id so the server can return the appropriate results.

6. Finally, the server packs the results of the ATF processing/validation/lemmatisation in a zip file encoded in an HTTP POST, which Nammu receives, extracts and presents to the user.