To check the status of an asynchronous SOAP web services job, we need to use the checkAsyncStatus operation. When you use this operation, you reference a job Id. In response, the system returns the job’s status, among other details.
Specific status values that can be returned include the following:
- failed
- finishedWithErrors — indicates that at least one record was processed, but at least one failed.
- pending
- processing
- finished
If the status is failed, finishedWithErrors, or finished, you can in most cases use the getAsyncResult operation to obtain more details. These details may include the record results, or error and fault messages.
checkAsyncStatus also returns details about the percentage of the job that is complete, and the estimated time remaining. The estimated remaining time is measured in seconds.