Creare un flusso di lavoro di Logic Apps Document Intelligence

Questo contenuto si applica a:checkmarkv4.0 (GA) | Versioni precedenti:blue-checkmarkv3.1 (GA)red-checkmarkv3.0 (ritiro)

Questo contenuto si applica a:red-checkmarkv2.1 | Versione più recente:blue-checkmarkv4.0 (GA)

Importante

Questa esercitazione e il connettore Document Intelligence per Logic App sono destinati all'API REST di Document Intelligence v3.0 e versioni successive.

Importante

Questa esercitazione e il connettore di document intelligence per le Logic App sono destinati alla REST API di Document Intelligence v2.1 e devono essere usati con lo strumento di etichettatura di esempio FOTT.

App per la logica di Azure è una piattaforma basata sul cloud che può essere usata per automatizzare i flussi di lavoro senza scrivere una singola riga di codice. La piattaforma consente di integrare facilmente Microsoft e le applicazioni con app, dati, servizi e sistemi. Un'app per la logica è la risorsa Azure creata quando si vuole sviluppare un flusso di lavoro. Ecco alcuni esempi di operazioni che è possibile eseguire con un'app per la logica:

  • Creare processi aziendali e flussi di lavoro visivamente.
  • Integrare flussi di lavoro con applicazioni SaaS (Software as a Service) e aziendali.
  • Automatizzare le attività enterprise application integration (EAI), business-to-business (B2B) e electronic data interchange (EDI).

Per ulteriori informazioni, vedereLogic Apps Overview.

In questo tutorial, viene illustrato come creare un flusso del connettore di Logic App per automatizzare le attività seguenti:

  • Rilevare quando una fattura è stata aggiunta a una cartella OneDrive.
  • Elaborare la fattura usando il modello di fattura predefinita di Document Intelligence.
  • Inviare le informazioni estratte dalla fattura a un indirizzo di posta elettronica pre-specificato.

Scegli un flusso di lavoro utilizzando un file dal tuo account Microsoft OneDrive o dal sito Microsoft ShareDrive.

Prerequisiti

Per completare questa esercitazione, sono necessarie le risorse seguenti:

  • Scrizioni di Azure. È possibile creare una sottoscrizione Azure gratuita

  • Un account gratuito OneDrive o OneDrive for Business di archiviazione cloud.

    Nota

    • OneDrive è destinato all'archiviazione personale.
    • OneDrive for Business fa parte di Office 365 ed è progettato per le organizzazioni. Fornisce archiviazione cloud in cui è possibile archiviare, condividere e sincronizzare tutti i file di lavoro.

  • Un account di posta elettronica gratuito Outlook online o Office 365.

  • Una fattura di esempio per testare l'app per la logica. È possibile scaricare e usare il documento di esempio della fattura per questo tutorial.

  • Una risorsa di Document Intelligence. Dopo aver creato la sottoscrizione Azure, creare una risorsa di Document Intelligence nel portale di Azure per ottenere la chiave e l'endpoint. Se si dispone di una risorsa di Document Intelligence esistente, passare direttamente alla pagina della risorsa. È possibile usare il piano tariffario gratuito (F0) per provare il servizio e eseguire l'aggiornamento in un secondo momento a un livello a pagamento per la produzione.

    • Dopo la distribuzione della risorsa, selezionare Vai alla risorsa. Copiare i valori Keys e Endpoint dalla risorsa nel portale di Azure e incollarli in una posizione conveniente, ad esempio Microsoft Blocco note. Per connettere l'applicazione all'API Document Intelligence sono necessari i valori di chiave ed endpoint. Per altre informazioni, vedereCreare una risorsa di Document Intelligence.

      Screenshot che mostra come accedere alla chiave di risorsa e all'URL dell'endpoint.

Creare una cartella OneDrive

Prima di iniziare a creare l'app per la logica, è necessario configurare una cartella OneDrive.

  1. Accedere al OneDrive o OneDrive for Business home page.

  2. Selezionare il pulsante ➕ Aggiungi Nuovo nella barra laterale in alto a sinistra e selezionare Cartella.

    Screenshot del pulsante Aggiungi nuovo.

  3. Immettere un nome per la nuova cartella e selezionare Crea.

    Screenshot della finestra per creare e assegnare un nome alla cartella.

  4. Puoi vedere la nuova cartella nei tuoi file.

    Screenshot della nuova cartella.

  5. Per il momento abbiamo finito con OneDrive.

Creare una risorsa dell'app per la logica

A questo punto, è necessario disporre di una risorsa di Document Intelligence e di una cartella OneDrive impostata. Ora, è il momento di creare una risorsa di Logic App.

  1. Passare al portale Azure.

  2. Selezionare ➕ Crea una risorsa dalla home page Azure.

    Screenshot della creazione di una risorsa nel portale di Azure.

  3. Cercare e scegliere Logic App dalla barra di ricerca.

  4. Selezionare il pulsante Crea

    Screenshot della pagina Crea app logica.

  5. Verranno quindi compilati i campi Crea app per la logica con i valori seguenti:

    • Sottoscrizione. Selezionare la sottoscrizione corrente.
    • Gruppo di risorse. Gruppo di risorse Azure che contiene la risorsa. Scegliere lo stesso gruppo di risorse utilizzato per la risorsa Document Intelligence.
    • Tipo. Selezionare Consumo. Il tipo di risorsa Consumo viene eseguito in App per la logica di Azure globali multi-tenant e usa il modello di fatturazione modello di fatturazione Consumo.
    • Nome della Logic App. Immettere un nome per la risorsa. È consigliabile usare un nome descrittivo, ad esempio YourNameLogicApp.
    • Pubblica. Selezionare Flusso di lavoro.
    • Area geografica. Selezionare l'area locale.
    • Abilitare Log Analytics. Per questo progetto selezionare No.
    • Tipo di piano. Selezionare Consumo. Il tipo di risorsa Consumo viene eseguito in App per la logica di Azure globali multi-tenant e usa il modello di fatturazione modello di fatturazione Consumo.
    • Ridondanza della zona. Selezionare disabilitato.

  6. Al termine, l'immagine è simile a quella riportata di seguito (il gruppo di risorse, il nome dell'app per la logica e l'area potrebbero essere diversi). Dopo aver controllato questi valori, selezionare Rivedi e crea nell'angolo inferiore sinistro.

    Screenshot che mostra i valori dei campi per creare una risorsa di Logic App.

  7. Viene eseguito un breve controllo di convalida. Al termine, selezionare Crea nell'angolo in basso a sinistra.

  8. Si verrà quindi reindirizzati a una schermata che indica Distribuzione in corso. Assegnare Azure tempo per la distribuzione. L'operazione può richiedere alcuni minuti. Al termine della distribuzione, viene visualizzato un banner che indica che la distribuzione è stata completata. Quando si raggiunge questa schermata, selezionare Vai alla risorsa.

  9. Infine, vieni reindirizzato alla pagina Logic Apps Designer. È disponibile un breve video per un'introduzione rapida alle app per la logica disponibili nella schermata iniziale. Quando si è pronti per iniziare a progettare la Logic App, selezionare il pulsante Blank Logic App nella sezione Modelli.

    Screenshot che mostra come accedere a Logic App Designer.

  10. Viene visualizzata una schermata simile all'immagine seguente. A questo punto, è possibile iniziare a progettare e implementare la Logic App di Azure.

    Screenshot della pagina iniziale di Logic App Designer.

Creare un flusso di automazione

Dopo aver impostato e configurato la risorsa del connettore Logic App, puoi creare il flusso di automazione e testarlo!

  1. Cercare e selezionare OneDrive o OneDrive for Business nella barra di ricerca. Selezionare quindi il trigger Quando viene creato un file .

    Screenshot della pagina di selezione del connettore OneDrive e del trigger.

  2. Viene visualizzata quindi una finestra popup che richiede di accedere all'account OneDrive. Selezionare Accedi e seguire le istruzioni per connettere l'account.

    Suggerimento

    Se si tenta di accedere al connettore di OneDrive usando un account Office 365, è possibile che venga visualizzato l'errore seguente: Sorry, non è possibile accedere qui con l'account @MICROSOFT.COM.

    • Questo errore si verifica perché OneDrive è una risorsa di archiviazione basata sul cloud per uso personale a cui è possibile accedere con un account Outlook.com o Microsoft Live non con account Office 365.
    • È possibile usare il connettore OneDrive for Business se si vuole usare un account Office 365. Assicurarsi di avere creata una cartella OneDrive per questo progetto nell'account OneDrive for Business.

  3. Dopo aver connesso l'account, selezionare la cartella creata in precedenza nell'account OneDrive o OneDrive for Business. Lasciare invariati gli altri valori predefiniti.

    Screenshot della finestra Quando viene creato un file.

  1. Si aggiungerà quindi un nuovo passaggio al flusso di lavoro. Selezionare il pulsante ➕ Nuovo passaggio sotto il nodo OneDrive appena creato.

    Screenshot della configurazione del trigger di OneDrive.

  2. Alla visualizzazione Progettazione app per la logica viene aggiunto un nuovo nodo. Cerca Riconoscimento modulo (Intelligence per i documenti) nella barra di ricerca Scegliere un'operazione, e seleziona Analizza documento per modelli predefiniti o personalizzati (API v3.0) dall'elenco.

    Screenshot del pulsante di selezione Analizza documento per modelli predefiniti o personalizzati (API v3.0).

  3. Verrà visualizzata una finestra per creare la connessione. In particolare, connetterai la risorsa Document Intelligence al Logic Apps Designer Studio:

    • Immettere un nome di connessione. Dovrebbe essere qualcosa di facile da ricordare.

    • Immettere l'URL dell'endpoint della risorsa di Document Intelligence e la chiave dell'account copiati in precedenza. Se questo passaggio è stato ignorato in precedenza o ha perso le stringhe, è possibile tornare alla risorsa di Document Intelligence e copiarle di nuovo. Al termine, selezionare Crea.

      Screenshot della finestra di dialogo del connettore dell'app Logica

    Nota

    Se è già stato eseguito l'accesso con le credenziali, il passaggio precedente viene ignorato.

  4. Verrà quindi visualizzata la finestra dei parametri di selezione per il connettore Analizza documento per modelli predefiniti o personalizzati (API v3.0).

    Screenshot della finestra di selezione del modello predefinita.

  5. Completare i campi come indicato di seguito:

    • Identificatore del modello. Specificare il modello che si vuole chiamare, in questo caso viene chiamato il modello di fattura predefinito, quindi immettere la fattura predefinita.

    • Contenuto del file di documento/immagine. Selezionare questo campo. Viene visualizzato un popup di contenuto dinamico. In caso contrario, selezionare il pulsante Aggiungi contenuto dinamico sotto il campo e scegliere Contenuto file. Questo passaggio consiste essenzialmente nell'inviare i file da analizzare al modello di fattura predefinita di Document Intelligence. Dopo aver visualizzato il badge Contenuto file nel campo Documento /Contenuto file immagine , questo passaggio è stato completato correttamente.

    • URL documento/immagine. Ignora questo campo per questo progetto poiché stiamo già puntando direttamente al contenuto del file dalla cartella di OneDrive.

    • Aggiungere un nuovo parametro. Ignorare questo campo per questo progetto.

      Screenshot della finestra di aggiunta del contenuto del file.

  6. È necessario aggiungere altri passaggi. Ancora una volta, selezionare il ➕ pulsante Nuovo passaggio per aggiungere un'altra azione.

  7. Nella barra di ricerca Scegliere un'operazione immettere Controllo e selezionare il riquadro Controllo .

    Screenshot della piastrella di controllo dal menu Scegli un'operazione.

  8. Scorrere verso il basso e selezionare il riquadro Per ogni controllo dall'elenco Controlli .

    Screenshot del riquadro For Each Control dal menu di Controllo.

  9. Nella finestra For each step (Per ogni passaggio) è presente un campo con l'etichetta Select an output from previous steps (Selezionare un output dei passaggi precedenti). Selezionare questo campo. Viene visualizzato un popup di contenuto dinamico. In caso contrario, selezionare il pulsante Aggiungi contenuto dinamico sotto il campo e scegliere documenti.

    Screenshot dell'elenco di contenuti dinamici.

  10. A questo punto, selezionare Aggiungi un'azione dall'interno della finestra Per ogni passaggio.

  11. Nella barra di ricerca Scegliere un'operazione immettere Outlook e selezionare Outlook.com (personale) o Office 365 Outlook (lavoro).

  12. Nell'elenco delle azioni scorrere verso il basso fino a trovare Invia un messaggio di posta elettronica (V2) e selezionare questa azione.

    Screenshot del pulsante Invia un messaggio di posta elettronica (V2).

  13. Proprio come con OneDrive, viene chiesto di accedere al proprio account Outlook o Office 365 Outlook. Dopo l'accesso, viene visualizzata una finestra in cui verrà formattato il messaggio di posta elettronica con contenuto dinamico estratto da Document Intelligence dalla fattura.

  14. Verrà usata l'espressione seguente per completare alcuni campi:


       items('For_each')?['fields']?['FIELD-NAME']?['content']

  1. Per accedere a un campo specifico, selezionare il pulsante Aggiungi contenuto dinamico e selezionare la scheda Espressione .

    Screenshot del campo della funzione dell'espressione.

  2. Nella casella ƒx, copiare e incollare la formula precedente e sostituire FIELD-NAME con il nome del campo da estrarre. Per l'elenco completo dei campi disponibili, vedere la pagina del concetto per l'API specificata. In questo caso, vengono usati i valori predefiniti di estrazione dei campi del modello di fattura.

  3. Abbiamo quasi finito! Apportare le modifiche seguenti ai campi seguenti:

    • A. Immettere l'indirizzo di posta elettronica personale o aziendale o qualsiasi altro indirizzo di posta elettronica a cui si ha accesso.

    • Oggetto. Immettere Fattura ricevuta da: e quindi aggiungere l'espressione seguente:

    
         items('For_each')?['fields']?['VendorName']?['content']

    • Corpo. Verranno aggiunte informazioni specifiche sulla fattura:

      • Digitare ID fattura: e, usando lo stesso metodo di prima, aggiungere l'espressione seguente:
      
       items('For_each')?['fields']?['InvoiceId']?['content']
      • In una nuova riga digitare Scadenza fattura: e aggiungere l'espressione seguente:
      
         items('For_each')?['fields']?['DueDate']?['content']
      • Scrivi Amount due: e aggiungere l'espressione seguente:
      
         items('For_each')?['fields']?['AmountDue']?['content']
      • Infine, poiché l'importo dovuto è un numero importante, si vuole anche inviare il punteggio di attendibilità per questa estrazione nel messaggio di posta elettronica. A tale scopo, digitare Amount due (attendibilità): e aggiungere l'espressione seguente:
      
         items('For_each')?['fields']?['AmountDue']?['confidence']

    • Al termine, la finestra avrà un aspetto simile all'immagine seguente:

      Screenshot della finestra Invia un messaggio di posta elettronica (V2) con i campi completati.

  4. Selezionare Salva nell'angolo superiore sinistro.

    Screenshot del Designer di Logic Apps pulsante Salva.

Nota

  • Questa versione corrente restituisce solo una singola fattura per pdf.
  • Il "Ciclo For each" è necessario intorno all'azione di invio email per abilitare un formato di output che in futuro potrà restituire più di una fattura dai PDF.

  1. Si aggiungerà quindi un nuovo passaggio al flusso di lavoro. Selezionare il pulsante ➕ Nuovo passaggio sotto il nodo OneDrive appena creato.

  2. Alla visualizzazione Progettazione app per la logica viene aggiunto un nuovo nodo. Cercare "Riconoscimento modulo (Document Intelligence futura)" nella barra di ricerca Scegliere un'operazione e selezionare Analizza Fattura dall'elenco.

    Screenshot dell'azione Analizza fattura.

  3. Verrà ora visualizzata una finestra in cui è possibile creare la connessione. In particolare, connetterai la risorsa Riconoscimento modulo al Designer di Logic Apps.

    • Immettere un nome di connessione. Dovrebbe essere qualcosa di facile da ricordare.
    • Immettere l'URL dell'endpoint della risorsa Riconoscimento modulo e la chiave dell'account che hai copiato in precedenza. Se questo passaggio è stato ignorato in precedenza o ha perso le stringhe, è possibile tornare alla risorsa Riconoscimento modulo e copiarle di nuovo. Al termine, selezionare Crea.

    Screenshot della finestra di dialogo del connettore dell'app logica.

    Nota

    Se è già stato eseguito l'accesso con le credenziali, il passaggio precedente viene ignorato. Continuare completando i parametri Analizza fattura .

  4. Verrà quindi visualizzata la finestra dei parametri di selezione per il connettore Analizza fattura .

    Screenshot che mostra i campi della finestra di analisi della fattura.

  5. Completare i campi come indicato di seguito:

    • Contenuto del file di documento/immagine. Selezionare questo campo. Viene visualizzato un popup di contenuto dinamico. In caso contrario, selezionare il pulsante Aggiungi contenuto dinamico sotto il campo e scegliere Contenuto file. Questo passaggio consiste essenzialmente nell'inviare i file da analizzare al modello di fattura predefinita di Document Intelligence. Dopo aver visualizzato il badge Contenuto file nel campo Documento /Contenuto file immagine , questo passaggio è stato completato correttamente.
    • URL documento/immagine. Ignora questo campo per questo progetto poiché stiamo già puntando direttamente al contenuto del file dalla cartella di OneDrive.
    • Includere i dettagli del testo. Selezionare Sì.
    • Aggiungere un nuovo parametro. Ignorare questo campo per questo progetto.

  6. È necessario aggiungere l'ultimo passaggio. Ancora una volta, selezionare il ➕ pulsante Nuovo passaggio per aggiungere un'altra azione.

  7. Nella barra di ricerca Scegliere un'operazione immettere Outlook e selezionare Outlook.com (personale) o Office 365 Outlook (lavoro).

  8. Nell'elenco delle azioni scorrere verso il basso fino a trovare Invia un messaggio di posta elettronica (V2) e selezionare questa azione.

  9. Accedi al tuo account Outlook o Office 365 Outlook. Dopo questa operazione, viene visualizzata una finestra in cui verrà formattato il messaggio di posta elettronica da inviare con contenuto dinamico estratto dalla fattura.

    Screenshot del pulsante Invia un messaggio di posta elettronica (V2).

  10. Abbiamo quasi finito! Digitare i seguenti dati nei campi:

    • A. Immettere l'indirizzo di posta elettronica personale o aziendale o qualsiasi altro indirizzo di posta elettronica a cui si ha accesso.

    • Oggetto. Immettere Fattura ricevuta da: e quindi aggiungere il campo Nome fornitore del contenuto dinamico Nome fornitore.

    • Corpo. Verranno aggiunte informazioni specifiche sulla fattura:

      • Digitare ID fattura: e aggiungere il contenuto dinamico campo ID fattura ID fattura.

      • In una nuova riga digitare Data scadenza fattura: e aggiungere il contenuto dinamico campo data fattura data fattura (data).

      • Digitare Importo dovuto: e aggiungere il campo dinamico Importo dovuto (numero).

      • Infine, poiché l'importo dovuto è un numero importante, si vuole anche inviare il punteggio di attendibilità per questa estrazione nel messaggio di posta elettronica. A tale scopo, digitare Importo dovuto (attendibilità): e aggiungere il contenuto dinamico campo di attendibilità dell'importo dovuto. Al termine, la finestra avrà un aspetto simile all'immagine seguente.

      Screenshot dei campi Outlook completati.

      Suggerimento

      Se la visualizzazione dinamica del contenuto non viene visualizzata automaticamente, usare la barra cerca contenuto dinamico per trovare le voci dei campi.

  11. Selezionare Salva nell'angolo superiore sinistro.

    Screenshot del Designer di Logic Apps pulsante Salva.

    Nota

    • Questa versione corrente restituisce solo una singola fattura per pdf.
    • L'azione "For each loop" che circonda l'azione di invio email consente un formato di output che potrebbe restituire più fatture dai PDF in futuro.

Prerequisiti

Per completare questa esercitazione, sono necessarie le risorse seguenti:

  • Scrizioni di Azure. È possibile creare una sottoscrizione Azure gratuita

  • Accesso a un sito SharePoint.

  • Un account di posta elettronica gratuito Outlook online o Office 365.

  • Una fattura di esempio per testare l'app per la logica. È possibile scaricare e usare il documento di esempio della fattura per questo tutorial.

  • Una risorsa di Document Intelligence. Dopo aver creato la sottoscrizione Azure, creare una risorsa di Document Intelligence nel portale di Azure per ottenere la chiave e l'endpoint. Se si dispone di una risorsa di Document Intelligence esistente, passare direttamente alla pagina della risorsa. È possibile usare il piano tariffario gratuito (F0) per provare il servizio e eseguire l'aggiornamento in un secondo momento a un livello a pagamento per la produzione.

    • Dopo la distribuzione della risorsa, selezionare Vai alla risorsa. Copiare i valori Keys e Endpoint dalla risorsa nel portale di Azure e incollarli in una posizione conveniente, ad esempio Microsoft Blocco note. Per connettere l'applicazione all'API Document Intelligence sono necessari i valori di chiave ed endpoint. Per altre informazioni, vedereCreare una risorsa di Document Intelligence.

      Screenshot che mostra come accedere alla chiave di risorsa e all'URL dell'endpoint.

Creare una cartella di SharePoint

Prima di iniziare a creare l'app per la logica, è necessario configurare una cartella di SharePoint.

  1. Accedere alla home page del sito SharePoint.

  2. Selezionare Documenti, quindi il ➕ pulsante Nuovo nell'angolo superiore sinistro della finestra del sito e scegliere Cartella.

    Screenshot del pulsante Aggiungi-nuovo.

  3. Immettere un nome per la nuova cartella e selezionare Crea.

    Screenshot della finestra per creare e assegnare un nome alla cartella.

  4. La tua nuova cartella si trova nella libreria del sito.

    Screenshot della cartella appena creata.

  5. Per il momento abbiamo finito con SharePoint.

Creare una risorsa Logic App

A questo punto, è necessario disporre di una risorsa di Document Intelligence e di una cartella SharePoint impostata. Ora, è il momento di creare una risorsa di Logic App.

  1. Passare al portale Azure.

  2. Selezionare ➕ Crea una risorsa dalla home page Azure.

    Screenshot della creazione di una risorsa nel portale di Azure.

  3. Cercare e scegliere Logic App dalla barra di ricerca.

  4. Selezionare il pulsante Crea

    Screenshot della pagina Crea app logica.

  5. Verranno quindi completati i campi Crea app per la logica con i valori seguenti:

    • Sottoscrizione. Selezionare la sottoscrizione corrente.
    • Gruppo di risorse. Gruppo di risorse Azure che contiene la risorsa. Scegliere lo stesso gruppo di risorse utilizzato per la risorsa Document Intelligence.
    • Tipo. Selezionare Consumo. Il tipo di risorsa Consumo viene eseguito in App per la logica di Azure globali multi-tenant e usa il modello di fatturazione modello di fatturazione Consumo.
    • Nome della Logic App. Immettere un nome per la risorsa. È consigliabile usare un nome descrittivo, ad esempio YourNameLogicApp.
    • Pubblica. Selezionare Flusso di lavoro.
    • Area geografica. Selezionare l'area locale.
    • Abilitare Log Analytics. Per questo progetto selezionare No.
    • Tipo di piano. Selezionare Consumo. Il tipo di risorsa Consumo viene eseguito in App per la logica di Azure globali multi-tenant e usa il modello di fatturazione modello di fatturazione Consumo.
    • Ridondanza della zona. Selezionare disabilitato.

  6. Al termine, l'immagine è simile a quella riportata di seguito (il gruppo di risorse, il nome dell'app per la logica e l'area potrebbero essere diversi). Dopo aver controllato questi valori, selezionare Rivedi e crea nell'angolo inferiore sinistro.

    Screenshot che mostra i valori dei campi per creare una risorsa di Logic App.

  7. Viene eseguito un breve controllo di convalida. Al termine, selezionare Crea nell'angolo in basso a sinistra.

  8. Si verrà quindi reindirizzati a una schermata che indica Distribuzione in corso. Assegnare Azure tempo per la distribuzione. L'operazione può richiedere alcuni minuti. Al termine della distribuzione, viene visualizzato un banner che indica che la distribuzione è stata completata. Quando si raggiunge questa schermata, selezionare Vai alla risorsa.

  9. Infine, vieni reindirizzato alla pagina Logic Apps Designer. È disponibile un breve video per un'introduzione rapida alle app per la logica disponibili nella schermata iniziale. Quando si è pronti per iniziare a progettare la Logic App, selezionare il pulsante Blank Logic App nella sezione Modelli.

    Screenshot che mostra come accedere a Logic App Designer.

  10. Viene visualizzata una schermata simile all'immagine seguente. A questo punto, è possibile iniziare a progettare e implementare la Logic App di Azure.

    Screenshot della pagina iniziale di Logic App Designer.

  11. Cercare e selezionare SharePoint dalla barra di ricerca. Selezionare quindi il trigger Quando viene creato un file (solo proprietà).

    Screenshot della pagina di selezione del connettore SharePoint e del trigger.

  12. Logic Apps accede automaticamente al tuo account o ai tuoi account di SharePoint.

  13. Dopo aver connesso l'account, completare i campi Indirizzo sito e Nome libreria . Selezionare il campo Aggiungi nuovo parametro e selezionare Cartella.

    Screenshot della finestra

  14. Selezionare il percorso della directory, inclusa la cartella creata in precedenza.

    Screenshot del campo del parametro aggiunto.

    Suggerimento

    Selezionare la freccia alla fine di ogni cartella elencata per passare alla cartella successiva nel percorso: Screenshot di come attraversare il percorso della cartella.

  1. Successivamente, verrà aggiunto un altro passaggio al flusso di lavoro. Selezionare il pulsante ➕ Nuovo passaggio sotto il nodo SharePoint appena creato.

  2. Cercare e selezionare SharePoint dalla barra di ricerca ancora una volta. Selezionare quindi l'azione Recupera contenuto file .

  3. Completare i campi come indicato di seguito:

    • Indirizzo sito. Selezionare il sito SharePoint.
    • Identificatore file. Selezionare questo campo. Viene visualizzato un popup di contenuto dinamico. In caso contrario, selezionare il pulsante Aggiungi contenuto dinamico sotto il campo e scegliere Identificatore.
    • Dedurre il tipo di contenuto. Selezionare Sì.

    Screenshot del nodo Ottieni il contenuto del file.

  4. Verrà aggiunto un altro nuovo passaggio al flusso di lavoro. Selezionare il pulsante ➕ Nuovo passaggio sotto il nodo SharePoint appena creato.

  5. Alla visualizzazione Progettazione app per la logica viene aggiunto un nuovo nodo. Cerca Riconoscimento modulo (Intelligence per i documenti) nella barra di ricerca Scegliere un'operazione, e seleziona Analizza documento per modelli predefiniti o personalizzati (API v3.0) dall'elenco.

    Screenshot del pulsante di selezione Analizza documento per modelli predefiniti o personalizzati (API v3.0).

  6. Verrà ora visualizzata una finestra in cui è possibile creare la connessione. In particolare, connetterai la risorsa Document Intelligence al Logic Apps Designer Studio:

    • Immettere un nome di connessione. Dovrebbe essere qualcosa di facile da ricordare.

    • Immettere l'URL dell'endpoint della risorsa di Document Intelligence e la chiave dell'account copiati in precedenza. Se questo passaggio è stato ignorato in precedenza o ha perso le stringhe, è possibile tornare alla risorsa di Document Intelligence e copiarle di nuovo. Al termine, selezionare Crea.

      Screenshot della finestra di dialogo del connettore dell'app Logica

    Nota

    Se è già stato eseguito l'accesso con le credenziali, il passaggio precedente viene ignorato.

  7. Verrà quindi visualizzata la finestra dei parametri di selezione per il connettore Analizza documento per modelli predefiniti o personalizzati (API v3.0).

    Screenshot della finestra di selezione del modello predefinita.

  8. Completare i campi come indicato di seguito:

    • Identificatore del modello. Specificare il modello che si vuole chiamare, in questo caso viene chiamato il modello di fattura predefinito, quindi immettere la fattura predefinita.
    • Contenuto del file di documento/immagine. Selezionare questo campo. Viene visualizzato un popup di contenuto dinamico. In caso contrario, selezionare il pulsante Aggiungi contenuto dinamico sotto il campo e scegliere Contenuto file. Questo passaggio consiste essenzialmente nell'inviare i file da analizzare al modello di fattura predefinita di Document Intelligence. Dopo aver visualizzato il badge Contenuto file nel campo Documento /Contenuto file immagine , questo passaggio è stato completato correttamente.
    • URL documento/immagine. Ignora questo campo per questo progetto poiché stiamo già puntando direttamente al contenuto del file dalla cartella di OneDrive.
    • Aggiungere un nuovo parametro. Ignorare questo campo per questo progetto.

  9. È necessario aggiungere altri passaggi. Ancora una volta, selezionare il ➕ pulsante Nuovo passaggio per aggiungere un'altra azione.

  10. Controllare e selezionare il riquadro Controllo .

    Screenshot del riquadro di controllo di Choo. Nella barra di ricerca **Scegli un'operazione** inserire

  11. Scorrere verso il basso e selezionare il riquadro Per ogni controllo dall'elenco Controlli .

    Screenshot del riquadro For Each Control dal menu di Controllo.

  12. Nella finestra For each step (Per ogni passaggio) è presente un campo con l'etichetta Select an output from previous steps (Selezionare un output dei passaggi precedenti). Selezionare questo campo. Viene visualizzato un popup di contenuto dinamico. In caso contrario, selezionare il pulsante Aggiungi contenuto dinamico sotto il campo e scegliere documenti.

    Screenshot dell'elenco di contenuti dinamici.

  13. A questo punto, selezionare Aggiungi un'azionedall'interno della finestra Per ogni passaggio.

  14. Nella barra di ricerca Scegliere un'operazione immettere Outlook e selezionare Outlook.com (personale) o Office 365 Outlook (lavoro).

  15. Nell'elenco delle azioni scorrere verso il basso fino a trovare Invia un messaggio di posta elettronica (V2) e selezionare questa azione.

    Screenshot del pulsante Invia un messaggio di posta elettronica (V2).

  16. Accedere al proprio account Outlook o Office 365 Outlook. Dopo questa operazione, viene visualizzata una finestra in cui verrà formattato il messaggio di posta elettronica con contenuto dinamico estratto da Document Intelligence dalla fattura.

  17. Verrà usata l'espressione seguente per completare alcuni campi:


          items('For_each')?['fields']?['FIELD-NAME']?['content']

  1. Per accedere a un campo specifico, selezionare il pulsante Aggiungi contenuto dinamico e selezionare la scheda Espressione .

    Screenshot del campo della funzione dell'espressione.

  2. Nella casella ƒx, copiare e incollare la formula precedente e sostituire FIELD-NAME con il nome del campo da estrarre. Per l'elenco completo dei campi disponibili, vedere la pagina del concetto per l'API specificata. In questo caso, vengono usati i valori predefiniti di estrazione dei campi del modello di fattura.

  3. Abbiamo quasi finito! Apportare le modifiche seguenti ai campi seguenti:

    • A. Immettere l'indirizzo di posta elettronica personale o aziendale o qualsiasi altro indirizzo di posta elettronica a cui si ha accesso.

    • Oggetto. Immettere Fattura ricevuta da: e lasciare il cursore posizionato dopo i due punti.

    • Immettere l'espressione seguente nel campo Espressione e selezionare OK:

    
   items('For_each')?['fields']?['VendorName']?['content']
    • Dopo aver immesso l'espressione nel campo, selezionare il pulsante OK e la notifica della formula verrà visualizzata nella posizione in cui si è lasciato il cursore:

    Screenshot del campo dell'espressione della formula.

    Screenshot del badge dell'espressione della formula.

  • Corpo. Verranno aggiunte informazioni specifiche sulla fattura:

    • Digitare ID fattura: e, usando lo stesso metodo di prima: posizionare il cursore, copiare l'espressione seguente nel campo dell'espressione e selezionare OK l'espressione seguente:
    
        items('For_each')?['fields']?['InvoiceId']?['content']
    • In una nuova riga digitare Scadenza fattura: e aggiungere l'espressione seguente:
    
        items('For_each')?['fields']?['DueDate']?['content']
    • Scrivi Amount due: e aggiungere l'espressione seguente:
    
        items('For_each')?['fields']?['AmountDue']?['content']
    • Infine, poiché l'importo dovuto è un numero importante, si vuole anche inviare il punteggio di attendibilità per questa estrazione nel messaggio di posta elettronica. A tale scopo, digitare Amount due (attendibilità): e aggiungere l'espressione seguente:
    
        items('For_each')?['fields']?['AmountDue']?['confidence']

  • Al termine, la finestra avrà un aspetto simile all'immagine seguente:

    Screenshot della finestra Invia un messaggio di posta elettronica (V2) con i campi completati.

  1. Selezionare Salva nell'angolo superiore sinistro.

    Screenshot del Designer di Logic Apps pulsante Salva.

Nota

  • Questa versione corrente restituisce solo una singola fattura per pdf.
  • Il "Ciclo For each" è necessario intorno all'azione di invio email per abilitare un formato di output che in futuro potrà restituire più di una fattura dai PDF.

Dopo aver salvato il tuo Logic App, se è necessario eseguire un aggiornamento o modificare il nodo For each, sarà simile all'immagine seguente.

Screenshot dopo il salvataggio dell'app per ciascun nodo.

  1. Cercare e selezionare SharePoint dalla barra di ricerca ancora una volta. Selezionare quindi l'azione Recupera contenuto file .

  2. Completare i campi come indicato di seguito:

    • Indirizzo sito. Selezionare il sito SharePoint.
    • Identificatore file. Selezionare questo campo. Viene visualizzato un popup di contenuto dinamico. In caso contrario, selezionare il pulsante Aggiungi contenuto dinamico sotto il campo e scegliere Identificatore.
    • Dedurre il tipo di contenuto. Selezionare Sì.

    Screenshot del nodo Ottieni il contenuto del file.

  3. Successivamente, verrà aggiunto un altro nuovo passaggio al flusso di lavoro. Selezionare il pulsante ➕ Nuovo passaggio sotto il nodo SharePoint appena creato.

  4. Alla visualizzazione Progettazione app per la logica viene aggiunto un nuovo nodo. Cercare "Riconoscimento modulo (Document Intelligence in arrivo)" nella barra di ricerca Scegliere un'operazione e selezionare analizzare fattura dall'elenco.

    Screenshot dell'azione Analizza fattura.

  5. Verrà ora visualizzata una finestra in cui creare la connessione. In particolare, connetterai la risorsa Riconoscimento modulo al Designer di Logic Apps.

    • Immettere un nome di connessione. Dovrebbe essere qualcosa di facile da ricordare.
    • Immettere l'URL dell'endpoint della risorsa Riconoscimento modulo e la chiave dell'account che hai copiato in precedenza. Se questo passaggio è stato ignorato in precedenza o ha perso le stringhe, è possibile tornare alla risorsa Riconoscimento modulo e copiarle di nuovo. Al termine, selezionare Crea.

    Screenshot della finestra di dialogo del connettore dell'app logica.

    Nota

    Se è già stato eseguito l'accesso con le credenziali, il passaggio precedente viene ignorato. Continuare completando i parametri Analizza fattura .

  6. Verrà quindi visualizzata la finestra dei parametri di selezione per il connettore Analizza fattura .

    Screenshot che mostra la finestra di analisi della fattura.

  7. Completare i campi come indicato di seguito:

    • Contenuto del file di documento/immagine. Selezionare questo campo. Viene visualizzato un popup di contenuto dinamico. In caso contrario, selezionare il pulsante Aggiungi contenuto dinamico sotto il campo e scegliere Contenuto file. Questo passaggio consiste essenzialmente nell'inviare i file da analizzare al modello di fattura predefinita di Document Intelligence. Dopo aver visualizzato il badge Contenuto file nel campo Documento /Contenuto file immagine , questo passaggio è stato completato correttamente.
    • URL documento/immagine. Ignora questo campo per questo progetto poiché stiamo già puntando direttamente al contenuto del file dalla cartella di OneDrive.
    • Includere i dettagli del testo. Selezionare Sì.
    • Aggiungere un nuovo parametro. Ignorare questo campo per questo progetto.

    Screenshot che mostra i campi della finestra di analisi della fattura.

  8. È necessario aggiungere l'ultimo passaggio. Ancora una volta, selezionare il ➕ pulsante Nuovo passaggio per aggiungere un'altra azione.

  9. Nella barra di ricerca Scegliere un'operazione immettere Outlook e selezionare Outlook.com (personale) o Office 365 Outlook (lavoro).

  10. Nell'elenco delle azioni scorrere verso il basso fino a trovare Invia un messaggio di posta elettronica (V2) e selezionare questa azione.

  11. Accedi al tuo account Outlook o Office 365 Outlook. Dopo questa operazione, viene visualizzata una finestra in cui verrà formattato il messaggio di posta elettronica da inviare con contenuto dinamico estratto dalla fattura.

    Screenshot del pulsante Invia un messaggio di posta elettronica (V2).

  12. Abbiamo quasi finito! Digitare i seguenti dati nei campi:

    • A. Immettere l'indirizzo di posta elettronica personale o aziendale o qualsiasi altro indirizzo di posta elettronica a cui si ha accesso.

    • Oggetto. Immettere Fattura ricevuta da: e quindi aggiungere il campo Nome fornitore del contenuto dinamico Nome fornitore.

    • Corpo. Verranno aggiunte informazioni specifiche sulla fattura:

      • Digitare ID fattura: e aggiungere il contenuto dinamico campo ID fattura ID fattura.

      • In una nuova riga digitare Data scadenza fattura: e aggiungere il contenuto dinamico campo data fattura data fattura (data).

      • Digitare Importo dovuto: e aggiungere il campo dinamico Importo dovuto (numero).

      • Infine, poiché l'importo dovuto è un numero importante, si vuole anche inviare il punteggio di attendibilità per questa estrazione nel messaggio di posta elettronica. A tale scopo, digitare Importo dovuto (attendibilità): e aggiungere il contenuto dinamico campo di attendibilità dell'importo dovuto. Al termine, la finestra avrà un aspetto simile all'immagine seguente.

      Screenshot dei campi Outlook completati.

      Suggerimento

      Se la visualizzazione dinamica del contenuto non viene visualizzata automaticamente, usare la barra cerca contenuto dinamico per trovare le voci dei campi.

  13. Selezionare Salva nell'angolo superiore sinistro.

    Screenshot del Designer di Logic Apps pulsante Salva.

    Nota

    • Questa versione corrente restituisce solo una singola fattura per pdf.
    • L'azione "For each loop" che circonda l'azione di invio email consente un formato di output che potrebbe restituire più fatture dai PDF in futuro.

Testare il flusso di automazione

Rivediamo rapidamente ciò che abbiamo completato prima di testare il nostro flusso:

  • Abbiamo creato un trigger in questo scenario. Il trigger viene attivato quando un file viene creato in una cartella pre-specificata nell'account OneDrive.
  • Abbiamo aggiunto un'azione di Intelligenza Documentale al nostro flusso. In questo scenario si è deciso di usare l'API della fattura per analizzare automaticamente una fattura dalla cartella OneDrive.
  • Abbiamo aggiunto un'azione Outlook.com al nostro flusso. Alcuni dei dati della fattura analizzati sono stati inviati a un indirizzo di posta elettronica predeterminato.

Ora che è stato creato il flusso, l'ultima operazione da eseguire consiste nel testarla e assicurarsi di ottenere il comportamento previsto.

  1. Per testare l'app per la logica, aprire prima una nuova scheda e passare alla cartella OneDrive configurata all'inizio di questa esercitazione. Aggiungere questo file alla cartella OneDrive Sample invoice.

  2. Tornare alla scheda di progettazione di Logic App e selezionare il pulsante Esegui trigger e selezionare Esegui dal menu a discesa.

    Screenshot dei pulsanti Esegui trigger ed Esegui.

  3. Nell'angolo superiore destro viene visualizzato un messaggio che indica che il trigger ha avuto esito positivo:

    Screenshot del messaggio di attivazione riuscito.

  4. Vai alla pagina di panoramica della Logic App selezionando il collegamento del nome dell'app in alto a sinistra.

    Screenshot del collegamento per navigare alla pagina di panoramica.

  5. Controllare lo stato per verificare se l'esecuzione ha avuto esito positivo o negativo. È possibile selezionare l'indicatore di stato per verificare quali passaggi hanno avuto esito positivo.

    Schermata dello stato riuscito o non riuscito.

  6. Se l'esecuzione non è riuscita, controllare il passaggio non riuscito per assicurarsi di aver immesso le informazioni corrette.

    Screenshot del passaggio non riuscito.

  7. Al termine dell'esecuzione di uno workflow, controlla la tua email. È disponibile un nuovo messaggio di posta elettronica con le informazioni specificate.

    Screenshot del messaggio di posta elettronica ricevuto.

  8. Al termine, disabilita o elimina l'app logica per interrompere l'utilizzo.

    Screenshot dei pulsanti di disabilitazione ed eliminazione.

Congratulazioni! Questa esercitazione è stata completata.

Passaggi successivi

Altre informazioni sui modelli di Document Intelligence

  • Last updated on