Vai al contenuto principale
ABBYY Vantage offre skill di content IQ che consentono di trasformare contenuti non strutturati in informazioni strutturate e utilizzabili tramite classificazione ed estrazione, nonché di elaborare specifici tipi di documenti come fatture, ordini, moduli W2 e altro ancora. ABBYY Vantage Connector for UiPath consente di integrare le skill di ABBYY Vantage nel tuo workflow UiPath.

​
Requisiti di sistema

Per configurare ed eseguire il processo, è necessario disporre di un account ABBYY Vantage. ABBYY Vantage Connector for UiPath può essere eseguito sui seguenti sistemi operativi:
  • Windows 10
  • Windows Server 2016
  • Windows Server 2019
Il connettore non può essere eseguito su computer con Windows Server 2012 R2, Windows 8.1 o sistemi operativi precedenti.
Il connettore per UiPath può essere utilizzato con:
  • ABBYY Vantage 2.3.2 o versioni successive
  • UiPath Enterprise Edition 2023.8.0
  • Community Edition 2023.4.4 o versioni successive
È necessario installare i seguenti componenti esterni:
  • Microsoft .NET Framework 4.8.1
  • Microsoft .NET 8
Si consiglia di convertire i progetti Windows-legacy alla compatibilità Windows, poiché la compatibilità legacy non è più supportata. Per informazioni su come convertire i progetti Windows-legacy in Windows, vedere Convertire i progetti Windows-legacy in Windows.

​
Installazione del connettore

ABBYY Vantage Connector for UiPath è un insieme di attività eseguite in UiPath all’interno del workflow definito dall’utente. Le attività vengono distribuite come pacchetto NuGet. Per installare il pacchetto:
  1. Esegui ABBYYVantageConnectorForUiPath.<version>.exe e segui le istruzioni della procedura guidata di installazione. Durante l’installazione, specifica la cartella di installazione del connettore. Per impostazione predefinita, è C:\Program Files\ABBYY Vantage Connector for UiPath.
  2. In UiPath Studio, apri un progetto esistente o creane uno nuovo.
  3. Sulla barra multifunzione, fai clic su Manage Packages nella scheda Design: Barra multifunzione di UiPath che mostra il pulsante Manage Packages nella scheda Design
  4. Assicurati che l’origine pacchetti nuget.org sia abilitata. Questa origine pacchetti è necessaria per installare alcune dipendenze del pacchetto del connettore.
    Se hai già configurato un’origine pacchetti e vuoi usarla, salta il passaggio 5.
  5. Vai alla scheda Settings della finestra Manage Packages e crea una nuova origine pacchetti: a. Inserisci un nome per la nuova origine pacchetti. b. Specifica il percorso della cartella in cui intendi collocare i pacchetti NuGet del connettore. c. Fai clic su Add per confermare le impostazioni. Barra multifunzione di UiPath che mostra il pulsante Manage Packages nella scheda Design La nuova origine pacchetti viene visualizzata nell’area User defined package sources e nel riquadro sinistro della finestra Manage Packages. Finestra Manage Packages che mostra Abbyy.UiPath.Vantage.Activities selezionato per l'installazione
  6. Copia tutti i pacchetti NuGet di ABBYY Vantage Connector for UiPath dalla cartella di installazione alla cartella della tua origine pacchetti. I pacchetti NuGet si trovano nella sottocartella UiPath Activities della cartella di installazione creata nel passaggio 1 (il percorso predefinito è C:\Program Files\ABBYY Vantage Connector for UiPath\UiPath Activities). Dopo aver aggiunto i pacchetti NuGet del connettore all’origine pacchetti disponibile, puoi installare il pacchetto del connettore tra le dipendenze del progetto.
  7. Nella finestra Manage Packages, vai alla sezione All Packages ed esegui le seguenti operazioni: a. Fai clic sulla categoria dell’origine pacchetti appena creata. b. Seleziona Abbyy.UiPath.Vantage.Activities dall’elenco dei pacchetti disponibili e fai clic su Install. La finestra License Acceptance mostrerà i termini di licenza per ciascun pacchetto di terze parti che installi. c. Fai clic su View License per leggere i termini di licenza. d. Fai clic su I Accept per accettare i termini di licenza e installare i pacchetti. Infine, fai clic su Save. Finestra Manage Packages che mostra Abbyy.UiPath.Vantage.Activities selezionato per l'installazione
  8. Una volta installate, le attività di Vantage appariranno nella sezione ABBYY Vantage dell’elenco delle attività disponibili per il tuo progetto: Pannello Activities che mostra la sezione ABBYY Vantage con le attività Vantage Scope, Use Skill, Get Results e Map Fields Per istruzioni dettagliate sull’installazione dei pacchetti, consulta la Guida di UiPath Studio.

​
Conversione dei progetti Windows-legacy a Windows

Si consiglia di convertire i progetti Windows-legacy a Windows.
Per convertire il progetto alla compatibilità Windows, è necessario aggiornare la versione del connettore ABBYY Vantage for UiPath. A tale scopo, eseguire tutti i passaggi della sezione Installazione del connettore, ad eccezione del passaggio 5.
La compatibilità predefinita per i nuovi progetti è ora quella Windows. Per convertire i progetti Windows-legacy alla compatibilità Windows, eseguire la procedura seguente per ciascun progetto con compatibilità Windows-legacy:
  1. In UiPath Studio, aprire il progetto Windows-legacy.
  2. Fare clic sul collegamento Convert to Windows nel messaggio visualizzato sotto la barra multifunzione.
Barra multifunzione di UiPath con banner Convert to Windows e finestra di dialogo Convert to Windows Si aprirà la finestra di dialogo Convert to Windows. Barra multifunzione di UiPath con banner Convert to Windows e finestra di dialogo Convert to Windows
  1. Specificare come il progetto Windows-legacy verrà convertito a Windows:
    • Per creare una copia del progetto corrente usando la compatibilità Windows e mantenere il progetto Windows-legacy originale, selezionare Create a new project. Immettere il nome del progetto, il percorso desiderato e, facoltativamente, una descrizione per il nuovo progetto.
    • Per aggiornare il progetto esistente e convertirlo alla compatibilità Windows, deselezionare l’opzione Create a new project. Se si deseleziona questa opzione, non sarà possibile annullare le modifiche apportate al progetto.
  2. Fare clic su Convert. Per ulteriori informazioni sulla conversione dei progetti Windows-legacy alla compatibilità Windows, consultare la UiPath Studio Guide.

​
Utilizzo delle attività ABBYY Vantage nel workflow di UiPath

ABBYY Vantage Connector for UiPath consente al workflow di inviare immagini di documenti ad ABBYY Vantage e di elaborarle utilizzando una skill disponibile. Per visualizzare le skill disponibili, creare skill personalizzate o modificare quelle esistenti, usa ABBYY Vantage Skill Catalog o ABBYY Vantage Skill Designer. Per ulteriori informazioni sulla configurazione delle skill, consulta la Guida di ABBYY Vantage Skill Designer. ABBYY Vantage Connector for UiPath include le seguenti attività per l’utilizzo di ABBYY Vantage: Per aggiungere un’attività al processo UiPath, trascinala dal pannello Activities al pannello Designer di UiPath Studio. Dopo aver aggiunto l’attività al processo, dovrai compilare i campi nel pannello Properties. Puoi compilare alcune proprietà anche nel pannello Designer. Per maggiori dettagli sulle proprietà delle attività, consulta le sezioni seguenti. ABBYY Vantage Connector for UiPath viene fornito con un processo sample che mostra come utilizzare le attività ABBYY Vantage nel workflow. Per ulteriori informazioni, consulta il Processo sample per le attività ABBYY Vantage.

​
Vantage Scope Activity

L’attività Vantage Scope trasmette le impostazioni di connessione di ABBYY Vantage ad altre attività Vantage. Funge anche da contenitore per altre attività Vantage. Tutte le altre attività ABBYY Vantage devono essere collocate all’interno dell’attività Vantage Scope.
L’attività Vantage Scope consente di configurare l’autenticazione utilizzando i flussi Resource Owner Password Credentials Flow e Client Credentials Flow. Se in Vantage si configura un provider di identità esterno, l’unico flusso di autenticazione che funzionerà sarà il Client Credentials Flow.

​
Proprietà dell’attività

GroupPropertyTypeDescription
Connection SettingsAuthorization grant typeIEnumerable<AuthorizationGrantType>Il tipo di grant utilizzato per l’autorizzazione: ResourceOwnerPassword o ClientCredentials
Connection SettingsPasswordStringLa password utilizzata per connettersi ad ABBYY Vantage.
Connection SettingsSecure PasswordSecureStringLa password protetta utilizzata per connettersi ad ABBYY Vantage.
Connection SettingsServer URLStringL’indirizzo del server ABBYY Vantage.
Connection SettingsTenantStringIl nome o l’identificatore del tenant di ABBYY Vantage. Importante! Questa proprietà è richiesta solo se l’utente le cui credenziali vengono utilizzate per connettersi al server ABBYY Vantage è registrato in più tenant sul server. Il nome del tenant è visibile nella pagina di accesso di Vantage nel browser durante l’immissione della password.
Connection SettingsUsernameStringL’indirizzo e-mail dell’utente utilizzato per connettersi ad ABBYY Vantage.
Proxy Settings (optional)Enable ProxyBooleanConsente di utilizzare un proxy server per instradare le richieste HTTP.
Proxy Settings (optional)Server URLStringL’indirizzo del proxy server (ad esempio http://127.0.0.1:8080).
Proxy Settings (optional)UsernameStringIl nome utente utilizzato per connettersi al proxy server.
Proxy Settings (optional)PasswordStringLa password utilizzata per connettersi al proxy server.
Proxy Settings (optional)Secure PasswordSecureStringLa password protetta utilizzata per connettersi al proxy server.
Vantage Public API Client settings (optional)Client IdStringIdentificatore dell’applicazione Vantage.
Vantage Public API Client settings (optional)Client SecretStringChiave applicativa sicura di Vantage.
Vantage Public API Client settings (optional)Secure Client SecretSecureStringChiave applicativa sicura di Vantage come stringa protetta.
La password dell’utente Vantage, la password del proxy e il Client Secret nelle impostazioni del client possono essere impostati nell’attività Scope, either in un parametro stringa oppure nel parametro corrispondente di tipo SecureString. Una password di tipo String viene memorizzata come testo normale nel file di progetto XAML e non è sicura. L’uso di una password String è consigliato solo durante la configurazione delle attività Use Skill e Map Fields per ottenere un elenco di skill o per eseguire il debug del processo UiPath. Una volta completata la configurazione del processo:
  • Se utilizzi Resource Owner Password Credentials Flow, rimuovi la proprietà Password dall’attività Vantage Scope e configura la proprietà Secure Password.
  • Se utilizzi Client Credentials Flow, rimuovi la proprietà Client Secret dall’attività Vantage Scope e configura la proprietà Secure Client Secret.
Ti consigliamo di utilizzare gli asset di UiPath Orchestrator per archiviare le credenziali in modo sicuro. In questo caso, la password può essere recuperata da Orchestrator tramite l’attività Get Credential e passata all’attività Vantage Scope tramite una variabile. Per maggiori dettagli sull’attività Get Credential, consulta le guide ufficiali di UiPath.
Per Connection Settings, Proxy Settings e Client Settings deve essere utilizzato lo stesso tipo di password.
Quando crei un client in ABBYY Vantage, configura quanto segue nella sezione OAuth 2.0 Flows Settings delle impostazioni del client, in base al tipo di grant utilizzato:
  • Resource Owner Password Credentials Flow:
    • Abilita l’opzione Allow Resource Owner Password Credentials Flow.
  • Client Credentials Flow:
    • Abilita l’opzione Allow issuing refresh tokens to refresh access tokens.
    • Abilita l’opzione Allow client credentials flow.
    • Seleziona i ruoli richiesti con cui l’applicazione accederà a Vantage facendo clic sull’impostazione Manage Roles.
    Se devi selezionare dall’elenco uno o più ruoli associati alle skill, seleziona anche le skill consentite per tali ruoli.
Field da compilare per Resource Owner Password Credentials Flow: Field dell'attività Vantage Scope per Resource Owner Password Credentials Flow
Se tutte le proprietà nelle impostazioni del client dell’API pubblica di Vantage sono vuote, viene utilizzato il client predefinito di ABBYY Vantage.
Campi da compilare per il flusso Client Credentials: Campi dell'attività Vantage Scope per il flusso Client Credentials

​
Impostazioni proxy

È possibile configurare le richieste del connettore in fase di esecuzione affinché passino attraverso un server proxy. Sono supportati i seguenti tipi di autenticazione proxy: Basic, NTLM, autenticazione tramite IP e proxy trasparente. Per utilizzare un proxy, seleziona l’attività Vantage Scope. Nel gruppo di proprietà Impostazioni proxy (facoltativo), imposta il valore della proprietà Abilita proxy su "true" e quindi specifica l’indirizzo del server proxy nella proprietà URL server. Se utilizzi l’autenticazione Basic, nelle proprietà Nome utente e Password / Password protetta, specifica le credenziali di connessione del proxy. Se utilizzi l’autenticazione NTLM, i campi Nome utente e Password sono facoltativi. Se i campi Nome utente e Password sono vuoti, verranno utilizzate le credenziali dell’utente con cui è in esecuzione il processo UiPath.

​
Attività Use Skill

L’attività Use Skill crea una transaction per elaborare un documento tramite una skill di ABBYY Vantage. Viene quindi restituito un identificatore univoco della transaction come proprietà di output Transaction Id.

​
Proprietà dell’attività

GroupPropertyTypeDescription
Impostazioni di connessioneNome skillStringIl nome della skill di Vantage.
InputFile di inputIReadOnlyDictionary<String,InputFile>Una raccolta Dictionary in cui String rappresenta il nome del file e InputFile la classe che descrive il file di input. Nota: Prima di aggiungere file al dizionario, è necessario assicurarsi che al parametro String vengano passati valori univoci. Non è possibile aggiungere più di un file al dizionario Input Files se nel parametro String viene passato lo stesso nome.
InputParametri di registrazione della transactionIReadOnlyDictionary<String,String>Una raccolta Dictionary dei parametri di registrazione della transaction, in cui passare la chiave e il valore di ciascun parametro.
OutputID transactionGuidL’identificatore della transaction creata. Questo ID viene quindi usato come proprietà di input Transaction Id dell’attività Get Results per ottenere lo stato della transaction e i risultati dell’elaborazione.
Proprietà della classe InputFile:
NameTypeDescription
fileStreamStreamIl contenuto del file che verrà passato ad ABBYY Vantage. È possibile passare come valore di questa proprietà lo stream del file presente su un disco locale (ad esempio System.IO.File.OpenRead("D:\images\Invoice1.pdf")).
index (facoltativo)IntegerIl numero di indice del file nella transaction.
fileRegistrationParameters (facoltativo)IReadOnlyDictionary<String,String>Una raccolta Dictionary dei parametri di registrazione del file, in cui passare la chiave e il valore di ciascun parametro.
L’attività Use Skill può essere utilizzata solo all’interno di un’attività Vantage Scope configurata.
Quando configuri l’attività Use Skill, esegui le operazioni seguenti in base al flusso di autenticazione utilizzato:
  • Resource Owner Password Credentials Flow — Specifica la proprietà Password dell’attività Vantage Scope per ottenere un elenco delle skill disponibili. Dopo aver configurato il workflow UiPath, valuta la possibilità di sostituire la proprietà Password con Secure Password.
  • Client Credentials Flow — Specifica la proprietà Client Secret dell’attività Vantage Scope per ottenere un elenco delle skill disponibili. Dopo aver configurato il workflow UiPath, valuta la possibilità di sostituire la proprietà Client Secret con Secure Client Secret.
Per maggiori dettagli, consulta la sezione Vantage Scope Activity. Interfaccia utente dell'attività Vantage Scope Fai clic sul pulsante a destra dell’elenco a discesa sotto Skill Name per ottenere un elenco di skill. Quindi espandi l’elenco a discesa Skill Name e seleziona la skill che intendi utilizzare per l’elaborazione dei documenti.
Ti consigliamo di ridurre le dimensioni dei file più grandi a 30 MB o meno per velocizzare l’elaborazione dei documenti.
Nel parametro Skill Name dell’attività Use Skill, puoi utilizzare una variabile UiPath di tipo String per memorizzare il nome della skill. Quando selezioni una skill tramite l’elenco a discesa dell’attività nel pannello di progettazione, la skill appena selezionata viene scritta nella variabile specificata. Puoi memorizzare direttamente nella variabile il nome della skill. Le espressioni o i riferimenti ad altre variabili nel valore della variabile non sono attualmente supportati.

​
Attività Get Results

L’attività Get Results consente di recuperare i risultati dell’elaborazione da ABBYY Vantage.

​
Proprietà dell’attività

GroupProprietàTipoDescrizione
InputTransaction IdGuidL’identificatore della transaction. Passa a questa proprietà il valore ottenuto come proprietà di output Transaction Id dell’attività Use Skill.
InputDelete TransactionBooleanSpecifica se la transaction completata deve essere eliminata, indipendentemente dal fatto che l’elaborazione sia andata a buon fine oppure no. Il valore predefinito è FALSE, che significa che la transaction non viene eliminata.
OutputDocument ResultsIEnumerable<DocumentResult>Una raccolta dei documenti risultanti dall’elaborazione.
OutputReview LinkStringUn collegamento ad ABBYY Vantage Manual Review Client, in cui è possibile esaminare i risultati della transaction (questo collegamento può essere ottenuto solo se il Process skill utilizzato contiene un’attività Review).
OutputTransaction StatusTransactionStatusLo stato della transaction. Sono possibili i seguenti stati: "New", "Processing", "Review", "Processed". In base allo stato ricevuto, puoi configurare il processo UiPath in modo che esegua una logica diversa. Ad esempio, se la transaction ha stato "Processing", attendi alcuni secondi e richiama nuovamente l’attività.
Quando si utilizza uno Skill di classificazione, un Document skill e uno skill OCR, tutti i file di input della transaction vengono assemblati in un unico documento. Quando si utilizza un Process skill, è possibile ottenere più documenti di risultato. Per impostazione predefinita, nel Process skill viene creato in ABBYY Vantage un documento separato per ogni file di input aggiunto alla transaction. I documenti possono appartenere a classi diverse, ma vengono tutti elaborati all’interno della stessa transaction. Puoi anche definire impostazioni personalizzate di assemblaggio dei documenti usando l’attività Assemble nel Process skill. Di conseguenza, ogni documento della transaction avrà i propri risultati di elaborazione. Il parametro di output Document Results dell’attività Get Results riceve i risultati dell’elaborazione di tutti i documenti della transaction come una raccolta di istanze della classe DocumentResult. Proprietà della classe DocumentResult:
NameTipoDescrizione
DocumentIdStringL’identificatore del documento.
ClassificationConfidencesIEnumerable<ClassificationConfidence>Una raccolta di valori di affidabilità della classificazione. Un elenco di tutte le classi disponibili nello Skill di classificazione applicato al documento, insieme ai relativi valori di affidabilità della classificazione.
ClassNameStringLa classe del documento in base ai risultati della classificazione.
ExtractedDataStringUna stringa JSON contenente i dati estratti. Nota: per un Process skill, la proprietà può essere ottenuta se l’opzione Values, metadata, and field structure for each document è abilitata nell’attività Output.
IsClassificationConfidentBooleanLa classe risultante è considerata determinata con affidabilità se questo valore è TRUE.
ResultFilesIReadOnlyDictionary<String,Stream>Una raccolta di file risultanti dall’elaborazione.
DocumentFullTextStringIl livello di testo completo di un documento acquisito da ABBYY Vantage. Nota: se la configurazione dello skill non contiene un’impostazione di esportazione del testo completo, questa proprietà conterrà il seguente valore predefinito: L’esportazione TXT non è stata configurata nelle impostazioni dello skill di ABBYY Vantage. Abilita l’esportazione TXT nello skill selezionato. L’esportazione TXT è disponibile solo per skill OCR o Processing.
Tutti i parametri elencati vengono raccolti in un DocumentResult separato nella raccolta Document Results. Anche se è presente un solo documento di output, i relativi parametri di output saranno disponibili nel primo DocumentResult della raccolta Document Results.
Proprietà della classe ClassificationConfidence:
NameTipoDescrizione
ClassNameStringClasse del documento in Vantage.
ConfidenceIntIl grado di affidabilità che il documento appartenga a questa classe. I valori possibili vanno da 0 a 100.
L’attività Get Results può essere utilizzata solo all’interno di un’attività Vantage Scope configurata.
Se l’elaborazione della transaction viene completata correttamente (ovvero Transaction Status = "Processed"), i risultati verranno salvati nelle proprietà di output. Se la transaction è ancora in elaborazione (ovvero Transaction Status = "New" / "Processing"), attendi alcuni secondi e richiama nuovamente l’attività Get Results. Di seguito è descritto un caso speciale, in cui Transaction Status = "Review". I risultati che l’attività Get Results può ottenere variano a seconda dello skill applicato al documento:
  • Skill di classificazione (ad es. Vantage Classifier):
    • Stato della transaction
    • Risultati del documento (per ogni DocumentResult): DocumentId, ClassificationConfidences, ClassName, IsClassificationConfident, ResultFiles (file JSON contenente i dati dei risultati della classificazione)
  • Document skill (ad es. Invoice US):
    • Stato della transaction
    • Risultati del documento (per ogni DocumentResult): DocumentId, ExtractedData, ResultFiles (i risultati saranno contenuti in due file JSON: il primo contiene tutti i dati del documento, il secondo i valori dei campi estratti e gli errori delle regole, e termina con _fields.json)
  • skill OCR:
    • Stato della transaction
    • Risultati del documento (per ogni DocumentResult): DocumentId, ResultFiles (questi file verranno ricevuti nell’esportazione configurata nella skill OCR), DocumentFullText (se l’esportazione in TXT è abilitata nella skill)
  • Process skill: Se un Process skill comprende un’attività Classify e un’attività Extract, si otterranno i risultati sopra indicati sia per una Skill di classificazione che per un Document skill. Se un Process skill comprende più attività Classify o Extract, i risultati verranno ottenuti per le ultime attività di un determinato tipo. Se un Process skill comprende più attività Classify o Extract, i risultati verranno ottenuti per le ultime attività di un determinato tipo. Se l’opzione PDF è abilitata nella finestra di dialogo Exported Data Settings di un’attività Output di un Process skill, i risultati conterranno il file JSON con i risultati dell’estrazione e l’immagine del documento esportata in un file PDF insieme a un livello di testo. Per ogni documento della transaction, verrà ricevuto il parametro DocumentFullText se l’esportazione in TXT è abilitata nella skill. Un Process skill può contenere anche un’attività Review. Quando si utilizza una skill di questo tipo per l’elaborazione dei documenti, l’elaborazione può essere sospesa se il documento richiede una revisione manuale. In questo caso, l’attività Get Results restituirà i seguenti risultati:
    • Stato della transaction = "Review"
    • Link per la revisione
    Una volta completate la revisione manuale e l’elaborazione della transaction, è possibile ottenere i risultati sopra indicati chiamando nuovamente l’attività Get Results.
L’elaborazione della transaction può non riuscire per diversi motivi (ad esempio, un file di input potrebbe essere danneggiato oppure il relativo formato potrebbe non essere supportato da ABBYY Vantage). In questo caso, l’attività Get Results genererà un’eccezione.

​
Attività Map Fields

L’attività Map Fields viene utilizzata per salvare i valori dei field estratti nelle variabili di UiPath. È possibile mappare i field di ABBYY Vantage alle variabili di UiPath nel pannello Designer.

​
Proprietà dell’attività

GruppoProprietàTipoDescrizione
Impostazioni di connessioneNome skillStringIl nome del Document skill di Vantage.
InputDati estrattiStringAccetta una stringa JSON contenente i dati estratti. Assegna a questa proprietà il valore della proprietà ExtractedData dello specifico DocumentResult ricevuto nell’attività Get Results. Per passare valori tra le proprietà, usa variabili UiPath.
L’attività Map Fields può essere usata solo all’interno di un’attività Vantage Scope configurata.
Quando configuri l’attività Map Fields, esegui le operazioni seguenti in base al flusso di autenticazione utilizzato:
  • Resource Owner Password Credentials Flow — Specifica la proprietà Password dell’attività Vantage Scope per ottenere un elenco delle skill disponibili. Dopo aver configurato il workflow UiPath, valuta la possibilità di cambiare la proprietà Password in Secure Password.
  • Client Credentials Flow — Specifica la proprietà Client Secret dell’attività Vantage Scope per ottenere un elenco delle skill disponibili. Dopo aver configurato il workflow UiPath, valuta la possibilità di cambiare la proprietà Client Secret in Secure Client Secret.
Per ulteriori dettagli, consulta la sezione Vantage Scope Activity.
In fase di esecuzione, la proprietà Extracted Data dell’attività Map Fields deve ricevere il valore della proprietà ExtractedData dello specifico DocumentResult ricevuto nell’attività Get Results contenente i dati estratti dal Document skill per cui è stata configurata l’attività Map Fields. Dopo aver ricevuto i dati estratti, verifica se il nome del Document skill applicato al documento corrisponde al nome del Document skill per cui è stata configurata l’attività Map Fields e, in caso affermativo, passa i dati estratti a Map Fields. Per ottenere il tipo di documento, puoi usare la proprietà di output ClassName dello specifico DocumentResult ricevuto nell’attività Get Results. Per passare il tipo di documento a questo parametro, nell’attività Extract del Process skill, configura la mappatura della classe con il Document skill da usare per l’elaborazione del documento. Durante la mappatura, è necessario rispettare la condizione che il nome della classe sia uguale al nome del Document skill selezionato.
Per mappare i field di ABBYY Vantage alle variabili UiPath, completa i passaggi seguenti:
  1. Apri l’attività Map Fields nel riquadro Designer e fai clic sul pulsante a destra dell’elenco a discesa sotto Skill Name per ottenere un elenco delle skill disponibili.
  2. Espandi l’elenco a discesa Skill Name e seleziona il Document skill i cui valori dei field estratti devono essere salvati nelle variabili UiPath.
    Puoi selezionare solo un Document skill.
  3. Fai clic sul pulsante Refresh. Nella colonna Vantage Extracted Field verrà visualizzato un albero dei field.
  4. Espandi l’albero e fai clic sul pulsante Plus accanto a un field che desideri mappare. Nella colonna UiPath Variable verranno visualizzati il nome e il tipo di una variabile UiPath. Per impostazione predefinita, il nome della variabile sarà uguale al nome del field di Vantage, ma puoi modificarlo se necessario.
    Assicurati che i nomi delle variabili UiPath specificati nell’attività Map Fields corrispondano alla convenzione di denominazione delle variabili configurata nel tuo processo UiPath. Se i nomi delle variabili non seguono le regole di denominazione, verranno visualizzati con un simbolo di avviso nell’elenco delle variabili UiPath. Per ulteriori informazioni sulla convenzione di denominazione delle variabili, consulta la documentazione UiPath.
    Attività Map Fields che mostra l'albero Vantage Extracted Field e la colonna UiPath Variable
  5. Ripeti il passaggio precedente per tutti gli altri field che devi mappare. Durante la configurazione della mappatura, puoi specificare variabili UiPath già esistenti. In questo caso, assicurati che il tipo delle tue variabili corrisponda a quello consigliato nella tabella seguente.
  6. Dopo aver mappato i field del documento alle variabili UiPath, fai clic su Apply per salvare le modifiche. A questo punto, quando l’attività Map Fields viene chiamata in fase di esecuzione, i valori delle variabili verranno popolati con i dati estratti.
Le variabili UiPath specificate verranno create nella Sequence più vicina all’attività Map Fields (ad esempio, in un Flowchart).
Nel parametro Skill Name dell’attività Map Fields, puoi utilizzare una variabile UiPath di tipo String per memorizzare il nome della skill. Quando selezioni una skill tramite l’elenco a discesa dell’attività nel pannello di progettazione, la skill appena selezionata viene scritta nella variabile specificata. Puoi memorizzare direttamente il nome della skill nella variabile. Le espressioni o i riferimenti ad altre variabili nel valore della variabile non sono attualmente supportati. La tabella seguente mostra a quale tipo di variabile UiPath corrisponde ciascun tipo di field di ABBYY Vantage:
ABBYY Vantage Field TypeUiPath Variable Type
TextString
DateString
NumberString
MoneyString
BarcodeString
CheckmarkBoolean
Checkmark group (può essere ottenuto come segni di spunta separati)FieldList
GroupFieldList
Group (per gruppi ripetibili)FieldList[]
TableFieldList[]
Le colonne della tabella, così come i field ripetuti, verranno mappate a variabili UiPath di tipo String[]. Tutti i field ripetuti e i field che fanno parte di un gruppo ripetibile (o di qualsiasi altro field ripetuto e gruppo ripetibile all’interno di gruppi ripetibili) verranno mappati a variabili UiPath di tipo FieldList[]. È inoltre possibile mappare gli oggetti figlio di questo gruppo in variabili di altri tipi semplici.
Attività Map Fields che mostra l'albero dei field estratti di Vantage e la colonna UiPath Variable Proprietà della classe GroupItem: GroupItem è una struttura che contiene un’istanza di un oggetto ripetuto (field o gruppo di field).
Method/PropertyParameterTypeDescription
KeysIEnumerable<string>Valori chiave. Ogni valore è il nome di uno specifico livello di nidificazione.
ValuesIEnumerable<IReadOnlyList<FieldList>>Insieme dei valori dei field nei livelli di nidificazione.
CountIntegerNumero di field nidificati.
ContainsKeyKey: StringBooleanSpecifica se esiste un field nidificato.
TryGetValueKey: String, Value: IReadOnlyList<FieldList>BooleanSpecifica se esiste un valore. Se il valore esiste, restituisce True e il valore; in caso contrario, restituisce False.
this[]Name: StringIReadOnlyList<FieldList>Restituisce il valore del field nidificato specificato.
FindName: StringIEnumerable<FieldList>Trova tutti i field nidificati, a qualsiasi livello di nidificazione, con il nome specificato.
FilterPredicate: (Name: String, Node: FieldList) => BooleanIEnumerable<FieldList>Trova tutti i field nidificati, a qualsiasi livello di nidificazione, che soddisfano il predicato.
DescendentsNameItems: Params String[]IEnumerable<FieldList>Trova tutti i field nidificati, a qualsiasi livello di nidificazione, il cui nome corrisponde al parametro nameItems.
Proprietà della classe FieldList: FieldList è una struttura che corrisponde a un field o a un gruppo di field (field ripetuti o gruppi ripetuti con lo stesso nome) e contiene i valori (sono possibili più istanze) dei field o dei gruppi.
Method/PropertyParameterTypeDescription
ValuesIEnumerable<Object>Insieme di valori scalari dei field.
CountIntegerNumero di GroupItem nidificati.
FindName: StringIEnumerable<FieldList>Trova tutti i field nidificati, a qualsiasi livello di nidificazione, con il nome specificato.
FilterPredicate: (Name: String, Node: FieldList) => BooleanIEnumerable<FieldList>Trova tutti i field nidificati, a qualsiasi livello di nidificazione, che soddisfano il predicato.
this[]Num: IntegerGroupItemRestituisce il GroupItem con field nidificati (se presenti) all’indice del parametro num.
Il processo sample fornisce un esempio di utilizzo di una variabile di tipo FieldList[] (la colonna Description della tabella LineItems viene visualizzata nei messaggi di log).

​
Passaggi successivi

Dai un’occhiata al processo sample incluso nel connettore UiPath oppure consulta le note di rilascio.