Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # AnalyzeDocument Analysiert ein Eingabedokument auf Beziehungen zwischen erkannten Elementen. Die Arten der zurückgegebenen Informationen lauten wie folgt: + Formulardaten (Schlüssel-Wert-Paare). Die zugehörigen Informationen werden in zwei[Block](API_Block.md)Objekte, jeweils vom Typ`KEY_VALUE_SET`: Ein SCHLÜSSEL`Block`Objekt und ein VALUE`Block`-Objekt. Beispiel,*Name: Ana Silva Carolina*enthält einen Schlüssel und einen Wert. *Name:*ist der Schlüssel. *Ana Silva Carolina*ist der Wert. + Tabellen- und Tabellenzellendaten. EIN TISCH`Block`-Objekt enthält Informationen über eine erkannte Tabelle. EINE ZELLE`Block`-Objekt wird für jede Zelle in einer Tabelle zurückgegeben. + Textzeilen und Wörter. EINE ZEILE`Block`Objekt enthält ein oder mehrere`Block`Objekte. Alle Zeilen und Wörter, die im Dokument erkannt werden, werden zurückgegeben (einschließlich Text, der keine Beziehung zum Wert von`FeatureTypes`) enthalten. Auswahlelemente wie Kontrollkästchen und Optionsfelder (Optionsfelder) können in Formulardaten und in Tabellen erkannt werden. EIN SELECTION\$1ELEMENT`Block`-Objekt enthält Informationen über ein Selektionselement, einschließlich des Auswahlstatus. Sie können auswählen, welche Art von Analyse durchgeführt werden soll, indem Sie die`FeatureTypes`-Liste. Die Ausgabe wird in einer Liste von`Block`Objekte. `AnalyzeDocument`ist ein synchroner Vorgang. Um Dokumente asynchron zu analysieren, verwenden Sie[StartDocumentAnalysis](API_StartDocumentAnalysis.md)aus. Weitere Informationen finden Sie unter[Textanalyse von Dokumenten](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-analyzing.html)aus. ## Anforderungssyntax ``` { "Document": { "Bytes": blob, "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } }, "FeatureTypes": [ "string" ], "HumanLoopConfig": { "DataAttributes": { "ContentClassifiers": [ "string" ] }, "FlowDefinitionArn": "string", "HumanLoopName": "string" } } ``` ## Anfrageparameter Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [Document](#API_AnalyzeDocument_RequestSyntax) ** Das Eingabedokument als Base64-codierte Bytes oder ein Amazon S3 S3-Objekt. Wenn Sie die AWS CLI verwenden, um Amazon Textract Textract-Vorgänge aufzurufen, können Sie keine Bildbytes übergeben. Das Dokument muss ein Bild im JPEG-, PNG-, PDF- oder TIFF-Format sein. Wenn Sie ein AWS SDK zum Aufrufen von Amazon Textract verwenden, müssen Sie möglicherweise keine Base64-Codierungsbytes codieren, die mit der`Bytes`field. Typ: [Document](API_Document.md) Objekt Erforderlich Ja ** [FeatureTypes](#API_AnalyzeDocument_RequestSyntax) ** Eine Liste der durchzuführenden Analysetypen. Fügen Sie TABLES zur Liste hinzu, um Informationen zu den Tabellen zurückzugeben, die im Eingabedokument erkannt werden. Fügen Sie FORMS hinzu, um erkannte Formulardaten zurückzugeben Um beide Analysetypen durchzuführen, fügen Sie TABLES und FORMS hinzu`FeatureTypes`aus. Alle im Dokument erkannten Zeilen und Wörter sind in der Antwort enthalten (einschließlich Text, der nicht mit dem Wert von`FeatureTypes`) enthalten. Type: Zeichenfolgen-Array Zulässige Werte:` TABLES | FORMS` Erforderlich Ja ** [HumanLoopConfig](#API_AnalyzeDocument_RequestSyntax) ** Legt die Konfiguration für den Menschen im Loop-Workflow zur Analyse von Dokumenten fest. Typ: [HumanLoopConfig](API_HumanLoopConfig.md) Objekt Erforderlich Nein ## Antwortsyntax ``` { "AnalyzeDocumentModelVersion": "string", "Blocks": [ { "BlockType": "string", "ColumnIndex": number, "ColumnSpan": number, "Confidence": number, "EntityTypes": [ "string" ], "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Id": "string", "Page": number, "Relationships": [ { "Ids": [ "string" ], "Type": "string" } ], "RowIndex": number, "RowSpan": number, "SelectionStatus": "string", "Text": "string", "TextType": "string" } ], "DocumentMetadata": { "Pages": number }, "HumanLoopActivationOutput": { "HumanLoopActivationConditionsEvaluationResults": "string", "HumanLoopActivationReasons": [ "string" ], "HumanLoopArn": "string" } } ``` ## Antwortelemente Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück. Die folgenden Daten werden vom Service im JSON-Format zurückgegeben. ** [AnalyzeDocumentModelVersion](#API_AnalyzeDocument_ResponseSyntax) ** Die Version des für die Analyse des Dokuments verwendeten Modells. Type: String (Zeichenfolge) ** [Blocks](#API_AnalyzeDocument_ResponseSyntax) ** Die Elemente, die erkannt und analysiert werden von`AnalyzeDocument`aus. Type: Array von[Block](API_Block.md)Objekte ** [DocumentMetadata](#API_AnalyzeDocument_ResponseSyntax) ** Metadaten über das analysierte Dokument. Ein Beispiel ist die Anzahl der Seiten. Typ: [DocumentMetadata](API_DocumentMetadata.md) Objekt ** [HumanLoopActivationOutput](#API_AnalyzeDocument_ResponseSyntax) ** Zeigt die Ergebnisse des Menschen in der Schleifenauswertung an. Typ: [HumanLoopActivationOutput](API_HumanLoopActivationOutput.md) Objekt ## Fehler ** AccessDeniedException ** Sie sind nicht berechtigt, die Aktion auszuführen. Verwenden Sie den Amazon-Ressourcennamen (ARN) der IAM-Rolle oder eines autorisierten Benutzers, um den Vorgang auszuführen. HTTP-Statuscode: 400 ** BadDocumentException ** Amazon Textract kann das Dokument nicht lesen. Weitere Informationen zu den Beleglimits in Amazon Textract finden Sie unter[Hard Limits in Amazon Textract](limits.md)aus. HTTP-Statuscode: 400 ** DocumentTooLargeException ** Das Dokument kann nicht verarbeitet werden, da es zu groß ist. Die maximale Dokumentgröße für synchrone Operationen 10 MB. Die maximale Dokumentgröße für asynchrone Vorgänge beträgt 500 MB für PDF-Dateien. HTTP-Statuscode: 400 ** HumanLoopQuotaExceededException ** Zeigt an, dass Sie die maximal zulässige Anzahl an aktiven Menschen in den verfügbaren Loop-Workflows überschritten haben HTTP-Statuscode: 400 ** InternalServerError ** Amazon Textract hat ein Service-Problem festgestellt. Wiederholen Sie den Aufruf. HTTP-Statuscode: 500 ** InvalidParameterException ** Ein Eingabeparameter verletzt eine Beschränkung. Zum Beispiel wird bei synchronen Operationen ein`InvalidParameterException`Ausnahme tritt auf, wenn keiner der`S3Object`oder`Bytes`Werte werden im`Document`Anforderungsparameter. Validieren Sie den Parameter, bevor Sie die API-Operation erneut aufrufen. HTTP-Statuscode: 400 ** InvalidS3ObjectException ** Amazon Textract kann auf das in der Anforderung angegebene S3-Objekt nicht zugreifen.[Konfigurieren des Zugriffs auf Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Informationen zur Problembehebung finden Sie unter[Fehlerbehebung für Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html) HTTP-Statuscode: 400 ** ProvisionedThroughputExceededException ** Die Anzahl der Anforderungen hat das Durchsatzlimit überschritten. Wenn Sie dieses Limit erhöhen müssen, wenden Sie sich an Amazon Textract. HTTP-Statuscode: 400 ** ThrottlingException ** Amazon Textract kann die Anforderung vorübergehend nicht verarbeiten. Wiederholen Sie den Aufruf. HTTP-Statuscode: 500 ** UnsupportedDocumentException ** Das Format des Eingabedokuments wird nicht unterstützt. Dokumente für Operationen können im PNG-, JPEG-, PDF- oder TIFF-Format vorliegen. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: + [AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/AnalyzeDocument) + [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeDocument) + [AWS-SDK für C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeDocument) + [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeDocument) + [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeDocument) + [AWS-SDK für JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeDocument) + [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeDocument) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeDocument) + [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeDocument)