Estrazione dei campi di query di Informazioni sui documenti

**Informazioni sui documenti supporta ora il campo di query per estendere lo schema di qualsiasi modello predefinito per estrarre i campi specifici necessari. È anche possibile aggiungere campi di query al layout per estrarre campi oltre alla struttura da moduli o documenti.

Eseguire query su campi o coppie chiave-valore

I campi di query e le coppie chiave-valore eseguono funzioni simili, ma esistono alcune distinzioni da tenere presenti quando si decide quale funzionalità scegliere.

• Le coppie chiave-valore sono disponibili solo con modelli di layout e fatture. Se si vuole estendere lo schema per un modello predefinito, usare i campi di query.

• Se non si conoscono i campi specifici da estrarre o il numero di campi è elevato (maggiore di 20), le coppie chiave-valore potrebbero essere una soluzione migliore.

• Le coppie chiave-valore estraggono le chiavi e i valori presenti nel modulo o nel documento ed è necessario pianificare qualsiasi variazione di chiave. Ad esempio, chiavi First Name o Given Name. Con i campi di query, si definisce la chiave e il modello estrae solo il valore corrispondente.

• Usare i campi di query quando il valore necessario non può essere descritto come coppia chiave-valore nel documento. Ad esempio, la data dell'accordo di un contratto.

Specificare i campi da estrarre e Document Intelligence analizzerà il documento di conseguenza. Ecco un esempio:

• Se si elabora un contratto in Document Intelligence Studio, usare le versioni API 2024-02-29-preview, 2023-10-31-preview o successive:

  

• È possibile passare un elenco di etichette di campo come Party1, Party2, TermsOfUse, PaymentTerms, PaymentDate e TermEndDate come parte della richiesta di AnalyzeDocument.

  

• Oltre ai campi della query, la risposta include l'output del modello. Per un elenco delle funzionalità o dello schema estratto da ogni modello, vedere le funzionalità di analisi del modello.

Richiesta API REST campi query**

Usare la funzionalità campi di query con il modello di documento generale e aggiungere campi al processo di estrazione senza dover eseguire il training di un modello personalizzato:

POST https://{endpoint}/documentintelligence/documentModels/prebuilt-layout:analyze?api-version=2024-02-29-preview&features=queryFields&queryFields=Terms,PaymentDate HTTP/1.1
Host: *.cognitiveservices.azure.com
Content-Type: application/json
Ocp-Apim-Subscription-Key:

{
  "urlSource": "https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/form-recognizer/sample-layout.pdf"
}

Passaggi successivi