Document Understanding – Cloud -APIs-Fehlerantwortcodes

Depending on your use case, you can use two types of calls for Document Understanding^TM Cloud APIs: synchronous (sync) and asynchronous (async).

Common issues concerning Document Understanding^TM Cloud APIs are outlined in this page.

Bearbeiten von Fehlern für Synchronisierungsaufrufe

Wenn Fehler auftreten, gibt der synchrone Aufruf einen entsprechenden HTTP-Statuscode zurück, zusätzlich zu:

• Fehlercode: Spezifischer Code, der den Fehlertyp identifiziert.
• Fehlermeldung: Detaillierte Erklärung, die beschreibt, worum es bei dem Fehler geht.

Bearbeiten von Fehlern für asynchrone Aufrufe

Im Falle von Fehlern stellt die resultierende URL Folgendes bereit:

• Fehlercode: Spezifischer Code, der den Fehlertyp identifiziert.
• Fehlermeldung: Detaillierte Erklärung, die beschreibt, worum es bei dem Fehler geht.

Wenn die operationId (vom Startvorgang zurückgegeben) gefunden wird, gibt die Ergebnisse-Route persistent den Status 202 zurück (gilt auch für fehlgeschlagene Anforderungen) und die Details des Fehlers befinden sich im Textkörper der Antwort.

Weitere Details und Beispiele finden Sie in der Swagger-Dokumentation.

Digitalisierungsauftrag oder DokumentID nicht gefunden

Wenn der Digitalisierungsauftrag oder die DokumentID nicht gefunden wird, wird eine Fehlermeldung generiert:

• Wenn Sie die synchronen APIs für die Klassifizierung oder Extraktion verwenden, wird der Fehler 404, Code:[DocumentIdNotFound] angezeigt.
• Wenn Sie die asynchronen APIs für die Klassifizierung oder Extraktion verwenden, wird das Abfrageergebnis den Fehler 200, Code:[DocumentIdNotFound] zurückgeben.

In beiden Situationen wird die folgende Fehlermeldung generiert:

Cannot perform the operation for the given documentId: Ensure it is correct, the digitization is successful (retrieving the digitization result), and not more than 7 days since the digitization call passed (case in which, it expired).

Lösungsschritte

1. Überprüfen Sie das Ergebnis der Digitalisierung, indem Sie /digitization/result/{documentId} aufrufen.
2. Wiederholen Sie den Digitalisierungsprozess.
3. Sobald die neue Dokument-ID aus der Wiederholung generiert wurde, verwenden Sie sie zum Klassifizieren und Extrahieren von Daten.

Digitalisierung ist aufgrund eines Clientfehlers fehlgeschlagen

In einigen Fällen kann eine fehlgeschlagene Digitalisierung aufgrund eines Clientfehlers zu einer Fehlermeldung führen. Dies ist ein 400-Fehler, der wie folgt angezeigt wird: Code: [DigitizationErrorCode], Message: "DigitizationErrorMessage". Der Fehlercode und die entsprechende Meldung können einen der folgenden Werte haben:

[UnsupportedContentTypeError]", "Content type of the input document is not supported."
[UnexpectedPdfStructureError]", "Invalid or corrupt PDF structure."
[InvalidImageSizeError]", "Image size of the input document is not supported."
[UnableToProcessContentError]", "Unable to process document contents."
[ContentTypeMismatchError]", "Declared content-type of the input document does not match the binary content type."
[PasswordProtectedPdfError]", "Password protected PDFs are not supported."
[MaximumNumberOfPagesPerDocumentLimitExceededError]", "Maximum number of pages for digitization exceeded."
[InvalidRequestData]", "The form data in the request is invalid. Expected is a multi-part form data, with either one part consisting of the document to be digitized, or two named parts: File - the document, DigitizationResult - the digitization result, with content type application/json."
[UnexpectedDigitizationResultStructure]", "The digitization result object is invalid and non-serializable."
[InvalidDom]", "The provided DOM is invalid. Make sure the DOM is correctly built, including valid non-overlapping indices, well formed boxes and polygons and valid values for all properties."
[MismatchingDomAndContent]", "The provided DOM and content do not match. Make sure the DOM was generated on the provided document."
[MismatchingDomAndText]", "The provided DOM and text do not match. Make sure the text and DOM were generated on the same document."
[PreprocessingOptionIncompatibleWithDigitizationResult]", "Using the preprocessing option while also providing a digitization result input is not supported."
[InvalidOcrApiKeyError]", "OCR Api key is invalid."
[OcrTooManyRequestsError]", "OCR request quota exceeded."
[ExternalOcrTooManyRequestsError]", "OCR request quota exceeded."
[GoogleBillingNotEnabled]", "Google OCR billing is not enabled. Please enable billing in your Google Cloud Platform account."
[GoogleApiKeyExpired]", "Google OCR Api Key Expired."
[InvalidOcrUrlError]", "The provided OCR URL is invalid or malformed."
[InvalidResponseFromOcrEngineError]", "Invalid response received from the OCR engine. Please set another OCR engine for the project you are using."

Digitalisierung ist aufgrund eines Serverfehlers fehlgeschlagen

Wenn die Digitalisierung aufgrund eines Serverfehlers fehlgeschlagen ist, kann eine Fehlermeldung generiert werden. Dies ist ein 500-Fehler, der wie folgt angezeigt wird: Code: [DigitizationFailedServerError], Message: Internal Server Error.

Wenn dieser Fehler auftritt, empfehlen wir, sich an das UiPath®- Supportteam zu wenden.

Digitalisierung aufgrund der Anzahl der Seiten fehlgeschlagen

Wenn die Digitalisierung für synchrone Aufrufe fehlgeschlagen ist, weil das Dokument mehr als fünf Seiten hat, wird eine Fehlermeldung generiert. Dies ist ein 400-Fehler, der wie folgt angezeigt wird: Code: [SyncMaximumNumberOfPagesExceeded], Message: Maximum Number Of Pages Exceeded.

If you encounter this error, use asysnchronous APIs. Asynchronous APIs are always recommended for production use cases. Synchronous APIs are only recommended in the following situations:

• When you are certain that you will never have more than five pages.
• If you only have single-page images, no PDFs or TIFFs.
• When preparing proof of concepts or demos.