Doc extraction runs can only be queried by a user with access to the original document, started by the Start Doc Extraction Smart Service.

The Appian Document Extraction page walks you through how to use document extraction functionality together in a process model. See the following list for the other smart services and functions you need to use with the Doc Extraction Status Function:

• Start Doc Extraction Smart Service
• a!docExtractionResult()
• Reconcile Doc Extraction Smart Service
• Admin Console > Document Extraction

Function

a!docExtractionStatus( docExtractionId )

Retrieves the status of a doc extraction run started by the Start Doc Extraction Smart Service.

Parameters

Keyword	Type	Description
docExtractionId	Integer	ID of the doc extraction run. In order to check the status, a run must first be started by the Start Doc Extraction smart service.

Returns

Text

The following statuses can be returned:

• COMPLETE: Analysis is done and Appian has downloaded the results, you can now proceed to extract results using a!docExtractionResult() or Reconcile Doc Extraction Smart Service.
• IN PROGRESS: Analysis is still in progress. Appian recommends checking again in 60 seconds.
• INVALID ID:
  • The provided ID is invalid because:
    • The ID provided does not match an active doc extraction run.
    • The user lacks sufficient privileges to see the original document.
    • The ID provided is a run that has been deleted. Appian will delete document extraction runs after 30 days, or when the total amount of data surpasses 10 GB.
  • Next steps: Check that the provided ID is valid or start a new doc extraction run on the same document.
• ERROR: Internal evaluation error happened during processing.
  • Next steps: This is the final state for a run, and you cannot access or make updates to the run. See the process model error and logs for details. You can start a new doc extraction run on the same document.

Example

a!docExtractionStatus(docExtractionId: 25)

Where 25 is a valid docExtractionId.

See the Appian Document Extraction page for a full end to end example.

Usage considerations

The doc extraction status can only be accessed by a user who has permissions to the original document.

Appian will delete document extraction runs after 30 days, or when the total amount of data surpasses 10 GB. If you attempt to access a run that has been deleted, you will see INVALID ID.

Feature compatibility

The table below lists this function's compatibility with various features in Appian.

Feature	Compatibility	Note
Portals	Partially compatible	Can be used with Appian Portals if it is connected using an integration and web API.
Offline Mobile	Partially compatible	Can be used with offline mobile if it is loaded at the top of the form.
Sync-Time Custom Record Fields	Incompatible
Real-Time Custom Record Fields	Incompatible
Process Reports	Incompatible	You cannot use this function to configure a process report.
Process Events	Incompatible	You cannot use this function to configure a process event node, such as a start event or timer event.