Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # AnalyzeDocument Analizza un documento di input per individuare relazioni tra gli elementi rilevati. I tipi di informazioni restituite sono i seguenti: + Dati del modulo (coppie chiave-valore). Le informazioni correlate vengono restituite in due[Block](API_Block.md)oggetti, ciascuno di tipo`KEY_VALUE_SET`: KEY`Block`oggetto e un VALORE`Block`oggetto. Ad esempio:*Nome: Ana Silva Carolina*contiene una chiave e un valore. *Nome:*è la chiave. *Ana Silva Carolina*è il valore. + Dati delle celle di tabella e tabella. UNA TABELLA`Block`object contiene informazioni su una tabella rilevata. CELLA`Block`l'oggetto viene restituito per ogni cella di una tabella. + Linee e parole di testo. RIGA`Block`object contiene una o più WORD`Block`objects. Tutte le righe e le parole rilevate nel documento vengono restituite (incluso il testo che non ha una relazione con il valore di`FeatureTypes`). Elementi di selezione come caselle di controllo e pulsanti di opzione (pulsanti di opzione) possono essere rilevati nei dati del modulo e nelle tabelle. UN ELEMENTO SELECTION\$1ELEMENT`Block`object contiene informazioni su un elemento di selezione, incluso lo stato della selezione. È possibile scegliere il tipo di analisi da eseguire specificando il`FeatureTypes`elenco. L'output viene restituito in un elenco di`Block`objects. `AnalyzeDocument`è un'operazione sincrona. Per analizzare i documenti in modo asincrono, utilizzare[StartDocumentAnalysis](API_StartDocumentAnalysis.md). Per ulteriori informazioni, consulta[Analisi del testo dei documenti](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-analyzing.html). ## Sintassi della richiesta ``` { "Document": { "Bytes": blob, "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } }, "FeatureTypes": [ "string" ], "HumanLoopConfig": { "DataAttributes": { "ContentClassifiers": [ "string" ] }, "FlowDefinitionArn": "string", "HumanLoopName": "string" } } ``` ## Parametri della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [Document](#API_AnalyzeDocument_RequestSyntax) ** Il documento di input come byte con codifica base64 o un oggetto Amazon S3. Se usi la CLI di AWS per chiamare le operazioni di Amazon Textract, non puoi passare byte immagine. Il documento deve essere un'immagine in formato JPEG, PNG, PDF o TIFF. Se utilizzi un SDK AWS per chiamare Amazon Textract, potrebbe non essere necessario codificare in base a 64 byte immagine che vengono passati utilizzando il`Bytes`. Tipo: [Document](API_Document.md) oggetto : Sì ** [FeatureTypes](#API_AnalyzeDocument_RequestSyntax) ** Un elenco dei tipi di analisi da eseguire. Aggiungere TABLES all'elenco per restituire informazioni sulle tabelle rilevate nel documento di input. Aggiungi FORMS per restituire i dati del modulo rilevati. Per eseguire entrambi i tipi di analisi, aggiungere TABLES e FORMS a`FeatureTypes`. Tutte le righe e le parole rilevate nel documento sono incluse nella risposta (incluso il testo che non è correlato al valore di`FeatureTypes`). Type: Gamma di stringhe Valori validi: ` TABLES | FORMS` : Sì ** [HumanLoopConfig](#API_AnalyzeDocument_RequestSyntax) ** Imposta la configurazione per il flusso di lavoro umano in loop per l'analisi dei documenti. Tipo: [HumanLoopConfig](API_HumanLoopConfig.md) oggetto : No ## Sintassi della risposta ``` { "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" } } ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [AnalyzeDocumentModelVersion](#API_AnalyzeDocument_ResponseSyntax) ** La versione del modello utilizzata per analizzare il documento. Type: Stringa ** [Blocks](#API_AnalyzeDocument_ResponseSyntax) ** Gli elementi rilevati e analizzati da`AnalyzeDocument`. Type: Matrice di[Block](API_Block.md)oggetti ** [DocumentMetadata](#API_AnalyzeDocument_ResponseSyntax) ** Metadati sul documento analizzato. Un esempio è il numero di pagine. Tipo: [DocumentMetadata](API_DocumentMetadata.md) oggetto ** [HumanLoopActivationOutput](#API_AnalyzeDocument_ResponseSyntax) ** Mostra i risultati della valutazione umana nel ciclo. Tipo: [HumanLoopActivationOutput](API_HumanLoopActivationOutput.md) oggetto ## Errori ** AccessDeniedException ** Non sei autorizzato a eseguire l'operazione. Utilizzare l'ARN (Amazon Resource Name) di un utente autorizzato o un ruolo IAM per eseguire l'operazione. Codice di stato HTTP: 400 ** BadDocumentException ** Amazon Textract non è in grado di leggere il documento. Per ulteriori informazioni sui limiti dei documenti in Amazon Textract, consulta[Limiti rigidi per Amazon Textract](limits.md). Codice di stato HTTP: 400 ** DocumentTooLargeException ** Il documento non può essere elaborato perché è troppo grande. La dimensione massima dei documenti per operazioni sincrone 10 MB. La dimensione massima del documento per le operazioni asincrone è di 500 MB per i file PDF. Codice di stato HTTP: 400 ** HumanLoopQuotaExceededException ** Indica che hai superato il numero massimo di flussi di lavoro di loop attivi disponibili Codice di stato HTTP: 400 ** InternalServerError ** Amazon Textract ha riscontrato un problema del servizio. Riprova la chiamata. Codice di stato HTTP: 500 ** InvalidParameterException ** Un parametro di input ha violato un vincolo. Ad esempio, nelle operazioni sincrone, un`InvalidParameterException`eccezione si verifica quando nessuno dei due`S3Object`o`Bytes`i valori sono forniti nel`Document`parametro della richiesta. Convalida il parametro prima di chiamare nuovamente l'operazione API. Codice di stato HTTP: 400 ** InvalidS3ObjectException ** Amazon Textract non è in grado di accedere all'oggetto S3 specificato nella richiesta. Per ulteriori informazioni,[Configura l'accesso ad Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Per informazioni sulla risoluzione dei problemi, consulta[Risoluzione dei problemi Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html) Codice di stato HTTP: 400 ** ProvisionedThroughputExceededException ** Il numero di richieste ha superato il limite di throughput. Per aumentare questo limite, contatta Amazon Textract. Codice di stato HTTP: 400 ** ThrottlingException ** Amazon Textract non è temporaneamente in grado di elaborare la richiesta. Riprova la chiamata. Codice di stato HTTP: 500 ** UnsupportedDocumentException ** Il formato del documento di input non è supportato. I documenti per le operazioni possono essere in formato PNG, JPEG, PDF o TIFF. Codice di stato HTTP: 400 ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: + [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/AnalyzeDocument) + [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeDocument) + [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeDocument) + [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeDocument) + [AWSSDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeDocument) + [SDK AWS per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeDocument) + [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeDocument) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeDocument) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeDocument)