Comportamento:
Si sta impostando un Workflow Designer con lo scopo di richiamare l'Elaborazione Intelligente dei Documenti (IDP) da Natif.ai.
I documenti PDF non vengono elaborati entro l'intervallo di tempo predefinito di Workflow Designer (timeout del Web-Service = 60 secondi) e di Natif.ai (timeout dell'elaborazione = 120 secondi).
Con la seguente guida si potrà impostare un Workflow DocuWare che richiama il processo Natif.ai in modo asincrono.
ATTENZIONE: l'Elaborazione documenti intelligente attualmente supporta i documenti PDF!
Imessaggi di posta elettronica contenenti PDF devono essere convertiti in PDF prima di essere inviati agli endpoint di Natif.ai!
Tutti i tipi di file supportati sono disponibili alla seguente pagina: Limitazioni - Tipi di file supportati
Queste pagine contengono informazioni fondamentali sul seguente processo:
- DocuWare Connect to Intelligent Document Processing (Elaborazione intelligente dei documenti)
- Endpoint dell'API di elaborazione -
- Gestione avanzata delle risposte
- Recupero dei risultati dell'elaborazione e degli artefatti
- Utilizzo sincrono o asincrono -
Soluzione:
Per elaborare documenti PDF di grandi dimensioni, l'endpoint Natif.ai deve essere chiamato in modo asincrono. All'interno di questo KBA, sono presenti passaggi che mostrano un Workflow Designer asincrono predefinito.
Il Workflow Designer "best-practice" completato ha il seguente aspetto:
A seconda del processo, definire la condizione di avvio/innesco in Workflow Designer. Questo non è l'obiettivo di questa guida.
L'attività "Imposta stato" è una fase di assegnazione dei dati per modificare il campo indice "Stato" del documento, mostrando che il processo è iniziato
Nella successiva assegnazione dei dati "IDP API-Key WF-ID" si definiranno i valori fissi dell'API-Key di Natif.ai e del Workflow-ID di Natif.ai.
Nella schermata precedente si può notare che l'API-Key richiede il prefisso "ApiKey" all'interno del valore del campo, incollare la chiave completa nel campo dopo questo prefisso. L'ID del flusso di lavoro di Natif.ai può essere inserito così com'è nel campo.
Se non è stata ancora creata una chiave API in Natif.ai, si prega di creare una chiave dedicata per il proprio processo.
È possibile trovare una panoramica di tutte le chiavi API alla pagina https://{yourNatifAI_Portal}.natif.ai/api-keys
L'ID del flusso di lavoro di Natif.ai può essere trovato dopo aver selezionato il processo personalizzato o predefinito nel portale Natif.ai. Nella sezione "Documentazione" è possibile vedere quanto segue.
La parte evidenziata e oscurata è l'ID del flusso di lavoro Natif.ai / IDP, che è necessario all'interno del flusso di lavoro DocuWare.
Nella fase "Elaborazione IDP", si chiamerà il flusso di lavoro Natif.ai / IDP tramite Web-Service. Una guida dettagliata su come collegare un Web-Service IDP è disponibile qui: https://knowledgecenter.docuware.com/docs/connect-to-intelligent-document-processing-with-workflow
Le parti speciali secondo la guida asincrona di Natif.ai possono essere viste in dettaglio qui: Synchronous vs. Asynchronous Usage -
Per applicare i requisiti di Natif.ai nel Workflow Designer di DocuWare, è necessario aprire la scheda "Request" del Web-Service.
Successivamente, passare alla sezione "Queries" della scheda "Request" e impostare il parametro "wait_for" come valore fisso.
Per ottenere questo risultato, aggiungere la chiave "wait_for" e definire un valore fisso 0. (come mostrato di seguito)
Questo passaggio consentirà al flusso di lavoro Natif.ai di restituire sempre l'ID del processo. Questo ID è necessario per il passaggio successivo quando si richiama il processo ripetutamente.
Nella sezione HTTP Header, è necessario definire 3 valori fissi. "Accept", "Content-Type" e "Authorization", i cui valori sono visibili nella schermata seguente.
Il contenuto dell'ApiKey viene ripreso dalla precedente fase di assegnazione dei dati "IDP API-Key WF-ID".
Nella scheda Assegnazione dati del Web-Service, è necessario specificare la cattura del valore di ritorno dell'Intelligent Document Processing / Natif.ai Web-Service.
Nella scheda HTTP Response Status Codes, definire tutti i potenziali codici "200,201,202,401,402,403,413,415,422,429,500".
È possibile impostare un limite di tempo massimo di 60 secondi o inferiore. 
Nell'elemento Web-Service successivo ("Results ProcessingID"), si chiamerà l'endpoint di elaborazione con il "ProcessingID". Il ProcessingID viene restituito dal precedente Web-Service "IDP Processing".
I dettagli su questo endpoint sono disponibili qui: Fetch Processing Results and Artifacts -
Questa fase del flusso di lavoro verrà ripetuta fino a quando il documento non sarà stato completamente elaborato da Natif.ai!
Nella schermata seguente, è possibile vedere la chiamata all'endpoint dedicato con il rispettivo ID.
In questo elemento, definire la chiave "wait_for" nella sezione Queries in modo che sia inferiore al timeout di Workflow Designer di DocuWare (< 60 secondi).
La scheda HTTP Header richiederà le chiavi "Accept" e "Authorization".
Nella scheda "Data Assign", definire i valori che si desidera estrarre da Natif.ai e inserirli in DocuWare.
I seguenti valori, mostrati nell'immagine, sono solo esemplificativi e possono essere arricchiti in base al vostro processo!
L'ultima scheda "HTTP Response Status Code" dovrebbe avere i codici impostati solo su "200" e il limite di tempo impostato su un massimo di 60 secondi.
Con la parte di condizione del flusso ("HttpCode 200") valuteremo se il codice HTTP della precedente chiamata al Web-Service ("Results ProcessingID") era "200"; se ciò è vero, il Workflow uscirà dal ciclo.
Se ciò non è vero, il Workflow tornerà indietro fino a quando non avrà completato l'elaborazione del documento.
Per attivare un ciclo di attesa personalizzato, dovrete definire una variabile globale "Delay" di tipo "DateTime". Scegliete un periodo di attesa appropriato.
Nelle schermate seguenti, potete vedere come attivare l'operazione di attesa personalizzata. In questo esempio, abbiamo scelto di aggiungere 15 secondi all'ora corrente.
Evitate di impostare un valore inferiore a 10 secondi, in quanto il flusso si itera più frequentemente!
In "Set done status" è possibile fornire un aggiornamento al documento del flusso di DocuWare Designer. In questo modo gli utenti potranno vedere chiaramente se il processo è stato completato.
Dopo aver seguito questa guida alle "best practice", dovreste essere in grado di elaborare documenti PDF di grandi dimensioni con DocuWare Workflow e Natif.ai.
Si prega di notare: Questo articolo è una traduzione dalla lingua inglese. Le informazioni contenute in questo articolo si basano sulla/le versione/i originale/i del/i prodotto/i in inglese. Potrebbero esserci errori minori, come nella grammatica utilizzata nella versione tradotta dei nostri articoli. Sebbene non possiamo garantire la completa accuratezza della traduzione, nella maggior parte dei casi troverai che è sufficientemente informativa. In caso di dubbio, fai riferimento alla versione inglese di questo articolo.