Visualizzazioni:
Domanda:
Perché ricevo il seguente errore durante la ricerca tramite l'API della piattaforma?
 
Eccezione non gestita: DocuWare.Services.Http.Client.HttpClientRequestException: 422 Unprocessable Entity (Il numero di risultati della ricerca richiesta supera il limite di sistema di 10000 per richiesta. Ridurre il valore del conteggio e utilizzare la paginazione dei risultati).

Risposta:
È possibile richiedere un massimo di 10.000 risultati in un'unica chiamata di ricerca tramite l'API della piattaforma. Le query di ricerca troppo grandi possono gravare eccessivamente sul sistema cloud, con un impatto negativo sui processi di lavoro e il conseguenterifiuto dellequery di ricerca. Per evitare che ciò accada, fare riferimento ai seguenti esempi e raccomandazioni;
 

API REST:
Il valore massimo del parametro count nelle seguenti chiamate è 10.000

  • /DocuWare/Platform/FileCabinet/{fileCabinetId}/Query/DialogExpression?dialogId={dialogId}&fields={fields}&sortOrder={sortOrder}&start={start}&count={count}
  • /DocuWare/Platform/FileCabinet/{fileCabinetId}/Query/FunctionExpression?fields={fields}&sortOrder={sortOrder}&start={start}&count={count}
  • /DocuWare/Platform/FileCabinets/{fileCabinetId}/Documents?q={q}&fields={fields}&sortOrder={sortOrder}&start={start}&msStart={msStart}&count={count}&format={format}&includeSuggestions={includeSuggestions}&csvDelimiter={csvDelimiter}&csvIsUtc={csvIsUtc}&calculateTotalCount={calculateTotalCount}
  • /DocuWare/Platform/FileCabinet/{fileCabinetId}/Query/Documents?q={q}&fields={fields}&sortOrder={sortOrder}&start={start}&count={count}&format={format}&additionalCabinets={additionalCabinets}&encodingName={encodingName}&csvDelimiter={csvDelimiter}&csvIsUtc={csvIsUtc}&includeSuggestions={includeSuggestions}&calculateTotalCount={calculateTotalCount}

Se il parametro count supera il valore consentito, si riceve la seguente risposta:

  • Codice di stato: Codice di stato HTTP 422 (Entità non elaborabile)
  • Eccezione: SearchResultLimitExceededException

In questo caso, regolare il parametro del conteggio a un valore valido.

Per continuare a ricevere tutti i documenti, utilizzare più ricerche continue (paginazione). È possibile utilizzare il parametro start per controllare da quale documento del set di risultati totale deve iniziare la consegna.

Per esempi, consultare la nostra raccolta Postman aggiornata.

KBA è applicabile SOLO alle organizzazioni cloud.

Si prega di notare: Questo articolo è una traduzione dall'inglese. Le informazioni contenute in questo articolo si basano sulla versione originale in inglese del/i prodotto/i. Potrebbero esserci piccoli errori, ad esempio nella grammatica utilizzata nella versione tradotta dei nostri articoli. Sebbene non possiamo garantire la completa accuratezza della traduzione, nella maggior parte dei casi la troverete sufficientemente informativa. In caso di dubbi, si prega di fare riferimento alla versione inglese di questo articolo.

Questo articolo vale per le versioni di DocuWare: 7.7 7.8 7.9 7.10 | Count API; Parameter; Paging; 10,000 Results