Criar um fluxo de trabalho para Aplicações de Lógica de Inteligência Documental

Este conteúdo aplica-se a:🟩v4.0 (GA) | Versões anteriores:🟦v3.1 (GA)🟥v3.0 (descontinuada)

Este conteúdo aplica-se a:🟥v2.1 | Versão mais recente:🟪v4.0 (GA)

Importante

Este tutorial e o conector de inteligência de documentos da Logic App têm como alvo a API REST de inteligência de documentos v3.0 e adiante.

Importante

Este tutorial e o conector Logic App Document intelligence têm como alvo a API REST de inteligência documental v2.1 e devem ser usados com a ferramenta FOTT Sample Labeling.

Azure Logic Apps é uma plataforma baseada na cloud que pode ser usada para automatizar fluxos de trabalho sem escrever uma única linha de código. A plataforma permite-lhe integrar facilmente a Microsoft e as suas aplicações com as suas aplicações, dados, serviços e sistemas. Uma Logic App é o recurso do Azure que cria quando quer desenvolver um fluxo de trabalho. Aqui estão alguns exemplos do que pode fazer com uma Logic App:

  • Crie processos e fluxos de trabalho de negócio de forma visual.
  • Integrar fluxos de trabalho com software como serviço (SaaS) e aplicações empresariais.
  • Automatizar tarefas de integração de aplicações empresariais (EAI), business-to-business (B2B) e intercâmbio eletrónico de dados (EDI).

Para mais informações, consulteVisão Geral das Aplicações Lógicas.

Neste tutorial, mostramos-lhe como construir um fluxo de conector para Logic App para automatizar as seguintes tarefas:

  • Detetar quando uma fatura foi adicionada a uma pasta do OneDrive.
  • Processe a fatura usando o modelo de fatura pré-construído do Document Intelligence.
  • Envie a informação extraída da fatura para um endereço de email pré-especificado.

Escolha um fluxo de trabalho usando um ficheiro da sua conta Microsoft OneDrive ou do site Microsoft ShareDrive:

Pré-requisitos

Para completar este tutorial, precisa dos seguintes recursos:

  • Uma subscrição Azure. Pode criar uma subscrição Azure gratuita

  • Uma conta gratuita de armazenamento na cloud OneDrive ou OneDrive para Empresas de armazenamento na nuvem.

    Nota

    • O OneDrive destina-se a armazenamento pessoal.
    • O OneDrive para Empresas faz parte do Office 365 e foi concebido para organizações. Fornece armazenamento na cloud onde pode armazenar, partilhar e sincronizar todos os ficheiros de trabalho.

  • Uma conta de email gratuita Outlook online ou Office 365 conta de email**.

  • Uma fatura modelo para testar a sua aplicação Logic. Pode descarregar e usar o nosso documento de fatura exemplo para este tutorial.

  • Um recurso de Inteligência Documental. Depois de teres a tua subscrição Azure, cria um recurso de Inteligência de Documentos no portal Azure para obter a tua chave e endpoint. Se tiver um recurso de Inteligência Documental existente, navegue diretamente para a sua página de recursos. Podes usar o nível de preço gratuito (F0) para experimentar o serviço, e depois fazer um upgrade para um nível pago para produção.

    • Depois de o recurso ser implementado, selecione Ir para o recurso. Copie os valores Keys e Endpoint do seu recurso no portal Azure e cole-os num local conveniente, como Microsoft Notepad. Precisa dos valores da chave e do endpoint para ligar a sua aplicação à API de Inteligência Documental. Para mais informações, consultecriar um recurso de Inteligência Documental.

      Captura de ecrã que mostra como aceder à chave de recurso e URL do endpoint.

Crie uma pasta OneDrive

Antes de começarmos a criar a Logic App, temos de configurar uma pasta OneDrive.

  1. Inicie sessão na sua página inicial OneDrive ou OneDrive para Empresas.

  2. Selecione o botão ➕ Adicionar Novo na barra lateral no canto superior esquerdo e selecione Pasta.

    Captura de ecrã do botão adicionar novo.

  3. Introduza um nome para a sua nova pasta e selecione Criar.

    Captura de ecrã da janela de criar e nomear a pasta.

  4. Vês a nova pasta nos teus ficheiros.

    Captura de ecrã da nova pasta.

  5. Por agora terminámos com o OneDrive.

Criar um recurso de Logic App

Neste ponto, deves ter um recurso de Inteligência de Documentos e uma pasta OneDrive prontos. Agora, é altura de criar um recurso para a Logic App.

  1. Navegue até ao portal Azure.

  2. Selecione ➕ Criar um recurso na página inicial Azure.

    Captura de ecrã de criar um recurso no portal Azure.

  3. Procura e escolhe Logic App na barra de pesquisa.

  4. Selecione o botão de criar

    Captura de ecrã da página Create Logic App.

  5. De seguida, vai preencher os campos Criar Aplicação Lógica com os seguintes valores:

    • Assinatura. Selecione a sua subscrição atual.
    • Grupo de recursos. O grupo de recursos Azure que contém o teu recurso. Escolha o mesmo grupo de recursos que tem para o seu recurso de Inteligência Documental.
    • Tipo. Selecione Consumo. O tipo de recurso Consumption executa em Azure Logic Apps em escala global, multi-inquilino e utiliza o modelo de faturação Consumption.
    • Nome da aplicação Logic. Introduza um nome para o seu recurso. Recomendamos o uso de um nome descritivo, por exemplo YourNameLogicApp.
    • Publicar. Selecione Fluxo de Trabalho.
    • Região. Selecione a sua região local.
    • Ativar a análise de registos. Para este projeto, selecione o nº
    • Tipo de Plano. Selecione Consumo. O tipo de recurso Consumption executa em Azure Logic Apps em escala global, multi-inquilino e utiliza o modelo de faturação Consumption.
    • Redundância de Zonas. Selecionar desativado.

  6. Quando terminares, tens algo semelhante à imagem seguinte (Grupo de recursos, nome da Aplicação Lógica e Região podem ser diferentes). Depois de verificar estes valores, selecione Rever + criar no canto inferior esquerdo.

    Captura de ecrã que mostra os valores dos campos para criar um recurso da Logic App.

  7. É realizada uma breve verificação de validação. Depois de concluir com sucesso, selecione Criar no canto inferior esquerdo.

  8. De seguida, és redirecionado para um ecrã que diz Implantação em progresso. Dá tempo ao Azure para implementar; pode demorar alguns minutos. Depois de concluída a implantação, vês um banner a dizer: A tua implantação está concluída. Quando chegar a este ecrã, selecione Ir para o recurso.

  9. Finalmente, és redirecionado para a página do Designer de Aplicações Lógicas . Há um vídeo curto para uma introdução rápida às Aplicações de Lógica disponível no ecrã inicial. Quando estiver pronto para começar a projetar a sua Logic App, selecione o botão Logic App em branco na secção Modelos.

    Captura de ecrã a mostrar como aceder ao Logic App Designer.

  10. Vês um ecrã que se assemelha à imagem seguinte. Agora, está pronto para começar a desenhar e implementar a sua Logic App.

    Captura de ecrã da página inicial do Logic App Designer.

Criar um fluxo de automação

Agora que tem o recurso do conector Logic App configurado, vamos criar o fluxo de automação e testá-lo!

  1. Procure e selecione OneDrive ou OneDrive para Empresas na barra de pesquisa. Depois, selecione o disparador Quando um ficheiro é criado.

    Captura de ecrã do conector OneDrive e da página de seleção do gatilho.

  2. De seguida, aparece uma janela pop-up, a convidá-lo a iniciar sessão na sua conta OneDrive. Selecione Iniciar sessão e siga as instruções para ligar a sua conta.

    Dica

    Se tentar iniciar sessão no conector de OneDrive usando um conta do Office 365, pode receber o seguinte erro: Desculpe, não conseguimos iniciar sessão aqui com a sua conta @MICROSOFT.COM.

    • Este erro acontece porque o OneDrive é um armazenamento baseado na cloud para uso pessoal que pode ser acedido com uma conta Outlook.com ou Microsoft Live que não esteja com a conta do conta do Office 365.
    • Podes usar o conector OneDrive para Empresas se quiseres usar uma conta conta do Office 365. Certifique-se de que criou uma OneDrive Pasta para este projeto na sua conta OneDrive para Empresas.

  3. Depois de a tua conta estar ligada, seleciona a pasta que criaste anteriormente na tua conta OneDrive ou OneDrive para Empresas. Deixa os outros valores padrão no lugar.

    Captura de ecrã da janela Quando um ficheiro é criado.

  1. De seguida, vamos adicionar um novo passo ao fluxo de trabalho. Selecione o botão ➕ Novo passo por baixo do nó OneDrive recém-criado.

    Captura de ecrã da configuração do gatilho OneDrive.

  2. Um novo nó é adicionado à visualização do designer da Logic App. Procure por Reconhecedor de Formulários (Document Intelligence em breve) na barra de pesquisa Escolha uma operação e selecione Analyze Document for Prebuilt or Custom models (v3.0 API) da lista.

    Captura de ecrã do botão de seleção Analisar Documento para Modelos Pré-construídos ou Personalizados (API v3.0).

  3. Agora, vês uma janela para criar a tua ligação. Especificamente, vais ligar o teu recurso de Inteligência de Documentos ao Logic Apps Designer Studio:

    • Introduza um nome de Ligação. Deveria ser algo fácil de lembrar.

    • Introduza a URL do Endpoint e a Chave de Conta do recurso de Inteligência Documental que copiou anteriormente. Se saltou este passo anteriormente ou perdeu as sequências de caracteres, pode navegar de volta ao seu recurso de Inteligência de Documentos e copiá-las novamente. Quando terminares, seleciona Criar.

      Captura de ecrã da janela de diálogo do conector da Logic App

    Nota

    Se já iniciaste sessão com as tuas credenciais, o passo anterior é ignorado.

  4. De seguida, vê-se a janela de parâmetros de seleção para o conector Analyze Document for Prebuilt or Custom Models (v3.0 API).

    Captura de ecrã da janela de seleção de modelos pré-construída.

  5. Preencha os campos da seguinte forma:

    • Identificador de modelo. Especifique qual modelo quer chamar, neste caso estamos a chamar o modelo de fatura predefinido, portanto, introduza prebuilt-invoice.

    • Conteúdo do Ficheiro de Documento/Imagem. Selecione este campo. Aparece um pop-up dinâmico de conteúdo. Se não fizer, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Conteúdo do Ficheiro. Este passo consiste essencialmente em enviar o(s) ficheiro(s) a analisar para o modelo de faturação pré-construído do Document Intelligence. Depois de veres o emblema de conteúdo do ficheiro aparecer no campo de conteúdo do ficheiro Documento/Imagem , completaste este passo corretamente.

    • URL do documento/imagem. Ignora este campo deste projeto porque já estamos a apontar para o conteúdo do ficheiro diretamente da pasta OneDrive.

    • Adicionar novo parâmetro. Ignore este campo para este projeto.

      Captura de ecrã da janela de adicionar conteúdo de ficheiro.

  6. Precisamos de acrescentar mais alguns passos. Mais uma vez, selecione o ➕ botão Novo passo para adicionar outra ação.

  7. Na barra de pesquisa Escolher uma operação, introduza Control e selecione o tile Control.

    Captura de ecrã do bloco de controlo no menu Escolher uma Operação.

  8. Desça e selecione o mosaico Para cada Control na lista de Controlo.

    Captura de ecrã do bloco For Each Control no menu Control.

  9. Na janela do passo Para cada, há um campo chamado Selecionar uma saída dos passos anteriores. Selecione este campo. Aparece um pop-up dinâmico de conteúdo. Se não estiver, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha documentos.

    Captura de ecrã da lista dinâmica de conteúdos.

  10. Agora, selecione Adicionar uma Ação dentro da janela Para cada passo.

  11. Na barra de pesquisa Escolha uma operação, introduza Outlook e selecione Outlook.com (pessoal) ou Office 365 Outlook (trabalho).

  12. Na lista de ações, desça até encontrar Enviar um email (V2) e selecione esta ação.

    Captura de ecrã do botão de ação Enviar um email (V2).

  13. Tal como com o OneDrive, solicitam que inicie sessão na sua conta Outlook ou na conta Outlook do Office 365. Depois de iniciar sessão, vê uma janela onde vamos formatar o email com conteúdo dinâmico que a Document Intelligence extrai da fatura.

  14. Vamos usar a seguinte expressão para completar alguns dos campos:


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

  1. Para aceder a um campo específico, selecionamos o botão adicionar conteúdo dinâmico e selecionamos o separador Expressão .

    Captura de ecrã do campo da função de expressão.

  2. Na caixa ƒx , copie e cole a fórmula acima e substitua FIELD-NAME pelo nome do campo que queremos extrair. Para a lista completa de campos disponíveis, consulte a página de conceitos da API em questão. Neste caso, usamos os valores de extração do campo do modelo de fatura pré-construído.

  3. Estamos quase a acabar! Faça as seguintes alterações nos seguintes campos:

    • Para. Insira o seu endereço de email pessoal ou profissional, ou qualquer outro endereço de email a que tenha acesso.

    • Assunto. Introduza Fatura recebida de: e depois adicione a seguinte expressão:

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

    • Corpo. Vamos acrescentar informações específicas sobre a fatura:

      • Digite ID de fatura: e, usando o mesmo método de antes, anexe a seguinte expressão:
      
       items('For_each')?['fields']?['InvoiceId']?['content']
      • Numa nova linha, escreva Data de vencimento da fatura: e anexe a seguinte expressão:
      
         items('For_each')?['fields']?['DueDate']?['content']
      • Digite Valor devido: e anexe a seguinte expressão:
      
         items('For_each')?['fields']?['AmountDue']?['content']
      • Por fim, como o valor devido é importante, também queremos enviar a pontuação de confiança para esta extração no email. Para fazer isto, tipo Quantia devida (confiança): e acrescentar a seguinte expressão:
      
         items('For_each')?['fields']?['AmountDue']?['confidence']

    • Quando terminar, a janela ficará semelhante à imagem seguinte:

      Captura de ecrã da janela Enviar um email (V2) com campos concluídos.

  4. Selecionar Guardar no canto superior esquerdo.

    Captura de ecrã do botão de gravar do Logic Apps Designer.

Nota

  • Esta versão atual só devolve uma única fatura por PDF.
  • O "Para cada ciclo" é necessário em torno da ação de enviar email para permitir um formato de saída que possa devolver mais do que uma fatura de PDFs no futuro.

  1. De seguida, vamos adicionar um novo passo ao fluxo de trabalho. Selecione o botão ➕ Novo passo por baixo do nó OneDrive recém-criado.

  2. Um novo nó é adicionado à visualização do designer da Logic App. Procure por "Reconhecedor de Formulários (Document Intelligence em breve)" na barra de pesquisa Escolha uma operação e selecione Analisar Fatura da lista.

    Captura de ecrã da ação Analisar Fatura.

  3. Agora, vês uma janela onde podes criar a tua ligação. Especificamente, vais ligar o teu recurso Reconhecedor de Formulários ao Logic Apps Designer Studio:

    • Introduza um nome de Ligação. Deveria ser algo fácil de lembrar.
    • Introduza o recurso Reconhecedor de Formulários URL do endpoint e Chave de Conta que copiou anteriormente. Se saltaste este passo antes ou perdeste as cadeias, podes voltar ao teu recurso Reconhecedor de Formulários e copiá-las novamente. Quando terminares, seleciona Criar.

    Captura de ecrã da janela de diálogo do conector da Logic App.

    Nota

    Se já iniciaste sessão com as tuas credenciais, o passo anterior é ignorado. Continue completando os parâmetros Analisar a Fatura .

  4. A seguir, vê a janela de parâmetros de seleção para o conector Analisar Fatura.

    Captura de ecrã que mostra os campos da janela de analisar fatura.

  5. Preencha os campos da seguinte forma:

    • Conteúdo do Ficheiro de Documento/Imagem. Selecione este campo. Aparece um pop-up dinâmico de conteúdo. Se não fizer, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Conteúdo do Ficheiro. Este passo consiste essencialmente em enviar o(s) ficheiro(s) a analisar para o modelo de faturação pré-construído do Document Intelligence. Depois de veres o emblema de conteúdo do ficheiro aparecer no campo de conteúdo do ficheiro Documento/Imagem , completaste este passo corretamente.
    • URL do documento/imagem. Ignora este campo deste projeto porque já estamos a apontar para o conteúdo do ficheiro diretamente da pasta OneDrive.
    • Inclua detalhes do texto. Selecione Sim.
    • Adicionar novo parâmetro. Ignore este campo para este projeto.

  6. Temos de acrescentar o último passo. Mais uma vez, selecione o ➕ botão Novo passo para adicionar outra ação.

  7. Na barra de pesquisa Escolha uma operação, introduza Outlook e selecione Outlook.com (pessoal) ou Office 365 Outlook (trabalho).

  8. Na lista de ações, desça até encontrar Enviar um email (V2) e selecione esta ação.

  9. Inicie sessão na sua conta Outlook ou Office 365 Outlook. Depois disso, vê uma janela onde vamos formatar o email a ser enviado com conteúdo dinâmico extraído da fatura.

    Captura de ecrã do botão de ação Enviar um email (V2).

  10. Estamos quase a acabar! Digite as seguintes entradas nos campos:

    • Para. Insira o seu endereço de email pessoal ou profissional, ou qualquer outro endereço de email a que tenha acesso.

    • Assunto. Introduza Fatura recebida de: e depois adicione conteúdo dinâmico Campo nome do fornecedor Nome do fornecedor.

    • Corpo. Vamos acrescentar informações específicas sobre a fatura:

      • Digite ID de fatura: e anexe o campo de conteúdo dinâmico ID de fatura ID de fatura.

      • Numa nova linha, escreva Data de vencimento da fatura: e anexe o conteúdo dinâmico no campo Data de emissão da fatura (data).

      • Digite Valor devido: e anexe o campo de conteúdo dinâmico Valor devido Valor devido (número).

      • Por fim, como o montante devido é um valor importante, também queremos enviar a pontuação de confiança para esta extração no email. Para fazer isso, digite Valor devido (confiança): e adicione o conteúdo dinâmico campo de confiança do valor devido. Quando terminar, a janela parece semelhante à imagem mostrada a seguir.

      Captura de ecrã dos campos de Outlook completados.

      Dica

      Se não vires automaticamente o conteúdo dinâmico, usa a barra de Pesquisa de conteúdo dinâmico para encontrar entradas nos campos.

  11. Selecionar Guardar no canto superior esquerdo.

    Captura de ecrã do botão de gravar do Logic Apps Designer.

    Nota

    • Esta versão atual só devolve uma única fatura por PDF.
    • O "Para cada ciclo" em torno da ação de enviar email permite um formato de saída que pode devolver mais do que uma fatura de PDFs no futuro.

Pré-requisitos

Para completar este tutorial, precisa dos seguintes recursos:

  • Uma subscrição Azure. Pode criar uma subscrição Azure gratuita

  • Acesso a um site SharePoint.

  • Uma conta de email gratuita Outlook online ou Office 365.

  • Uma fatura modelo para testar a sua aplicação Logic. Pode descarregar e usar o nosso documento de fatura exemplo para este tutorial.

  • Um recurso de Inteligência Documental. Depois de teres a tua subscrição Azure, cria um recurso de Inteligência de Documentos no portal Azure para obter a tua chave e endpoint. Se tiver um recurso de Inteligência Documental existente, navegue diretamente para a sua página de recursos. Podes usar o nível de preço gratuito (F0) para experimentar o serviço, e depois fazer um upgrade para um nível pago para produção.

    • Depois de o recurso ser implementado, selecione Ir para o recurso. Copie os valores Keys e Endpoint do seu recurso no portal Azure e cole-os num local conveniente, como Microsoft Notepad. Precisa dos valores da chave e do endpoint para ligar a sua aplicação à API de Inteligência Documental. Para mais informações, consultecriar um recurso de Inteligência Documental.

      Captura de ecrã que mostra como aceder à chave de recurso e URL do endpoint.

Criar uma pasta SharePoint

Antes de começarmos a criar a Logic App, temos de configurar uma pasta SharePoint.

  1. Inicie sessão na página inicial do seu site SharePoint.

  2. Selecione Documentos, clique no botão ➕ Novo no canto superior esquerdo da janela do site, e escolha Pasta.

    Captura de ecrã do botão adicionar novo.

  3. Introduza um nome para a sua nova pasta e selecione Criar.

    Captura de ecrã da janela de criar e nomear a pasta.

  4. A sua nova pasta está localizada na biblioteca do seu site.

    Captura de ecrã da pasta recém-criada.

  5. Terminámos com o SharePoint por enquanto.

Recurso Create Logic App

Neste ponto, deves ter um recurso de Inteligência de Documentos e uma pasta SharePoint já prontos. Agora, é altura de criar um recurso para a Logic App.

  1. Navegue até ao portal Azure.

  2. Selecione ➕ Criar um recurso na página inicial Azure.

    Captura de ecrã de criar um recurso no portal Azure.

  3. Procura e escolhe Logic App na barra de pesquisa.

  4. Selecione o botão de criar

    Captura de ecrã da página Create Logic App.

  5. De seguida, vai completar os campos Criar Aplicação Lógica com os seguintes valores:

    • Assinatura. Selecione a sua subscrição atual.
    • Grupo de recursos. O grupo de recursos Azure que contém o teu recurso. Escolha o mesmo grupo de recursos que tem para o seu recurso de Inteligência Documental.
    • Tipo. Selecione Consumo. O tipo de recurso Consumption executa em Azure Logic Apps em escala global, multi-inquilino e utiliza o modelo de faturação Consumption.
    • Nome da aplicação Logic. Introduza um nome para o seu recurso. Recomendamos o uso de um nome descritivo, por exemplo YourNameLogicApp.
    • Publicar. Selecione Fluxo de Trabalho.
    • Região. Selecione a sua região local.
    • Ativar a análise de registos. Para este projeto, selecione o nº
    • Tipo de Plano. Selecione Consumo. O tipo de recurso Consumption executa em Azure Logic Apps em escala global, multi-inquilino e utiliza o modelo de faturação Consumption.
    • Redundância de Zonas. Selecionar desativado.

  6. Quando terminares, tens algo semelhante à imagem seguinte (Grupo de recursos, nome da Aplicação Lógica e Região podem ser diferentes). Depois de verificar estes valores, selecione Rever + criar no canto inferior esquerdo.

    Captura de ecrã que mostra os valores dos campos para criar um recurso da Logic App.

  7. É realizada uma breve verificação de validação. Depois de concluir com sucesso, selecione Criar no canto inferior esquerdo.

  8. De seguida, és redirecionado para um ecrã que diz Implantação em progresso. Dá tempo ao Azure para implementar; pode demorar alguns minutos. Depois de concluída a implantação, vês um banner a dizer: A tua implantação está concluída. Quando chegar a este ecrã, selecione Ir para o recurso.

  9. Finalmente, és redirecionado para a página do Designer de Aplicações Lógicas . Há um vídeo curto para uma introdução rápida às Aplicações de Lógica disponível no ecrã inicial. Quando estiver pronto para começar a projetar a sua Logic App, selecione o botão Logic App em branco na secção Modelos.

    Captura de ecrã a mostrar como aceder ao Logic App Designer.

  10. Vês um ecrã que se assemelha à imagem seguinte. Agora, está pronto para começar a desenhar e implementar a sua Logic App.

    Captura de ecrã da página inicial do Logic App Designer.

  11. Procure e selecione SharePoint na barra de pesquisa. Depois, seleciona o trigger Quando um ficheiro é criado (apenas propriedades).

    Captura de ecrã do conector SharePoint e da página de seleção do gatilho.

  12. O Logic Apps liga-o automaticamente à sua(s) conta(s) SharePoint.

  13. Depois de a sua conta estar ligada, preencha os campos Endereço do Site e Nome da Biblioteca . Selecione o campo Adicionar novo parâmetro e selecione Pasta.

    Captura de ecrã da janela Quando um ficheiro é criado com parâmetro adicional.

  14. Selecione o caminho da pasta que inclua a pasta que criou anteriormente.

    Captura de ecrã do campo de parâmetros adicionado.

    Dica

    Selecione a seta no final de cada pasta listada para avançar até à pasta seguinte no caminho: Captura de ecrã de como percorrer o caminho da pasta.

  1. De seguida, vamos adicionar mais um passo ao fluxo de trabalho. Selecione o botão ➕ Nova etapa abaixo do nó recém-criado do SharePoint.

  2. Procure e selecione SharePoint na barra de pesquisa mais uma vez. Depois, selecione a ação Obter conteúdo do ficheiro .

  3. Preencha os campos da seguinte forma:

    • Endereço do local. Selecione o seu site SharePoint.
    • Identificador de ficheiro. Selecione este campo. Aparece um pop-up dinâmico de conteúdo. Se não estiver, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Identificador.
    • Inferir Tipo de Conteúdo. Selecione Sim.

    Captura de ecrã do nó Obter Conteúdo do Ficheiro.

  4. Vamos adicionar mais um novo passo ao fluxo de trabalho. Selecione o botão ➕ Nova etapa abaixo do nó recém-criado do SharePoint.

  5. Um novo nó é adicionado à visualização do designer da Logic App. Procure por Reconhecedor de Formulários (Document Intelligence em breve) na barra de pesquisa Escolha uma operação e selecione Analyze Document for Prebuilt or Custom models (v3.0 API) da lista.

    Captura de ecrã do botão de seleção Analisar Documento para Modelos Pré-construídos ou Personalizados (API v3.0).

  6. Agora, vês uma janela onde podes criar a tua ligação. Especificamente, vais ligar o teu recurso de Inteligência de Documentos ao Logic Apps Designer Studio:

    • Introduza um nome de Ligação. Deveria ser algo fácil de lembrar.

    • Introduza a URL do Endpoint e a Chave de Conta do recurso de Inteligência Documental que copiou anteriormente. Se saltou este passo anteriormente ou perdeu as sequências de caracteres, pode navegar de volta ao seu recurso de Inteligência de Documentos e copiá-las novamente. Quando terminares, seleciona Criar.

      Captura de ecrã da janela de diálogo do conector da Logic App

    Nota

    Se já iniciaste sessão com as tuas credenciais, o passo anterior é ignorado.

  7. De seguida, irá ver a janela de parâmetros de seleção para o conector Analyze Document for Prebuilt or Custom models (v3.0 API).

    Captura de ecrã da janela de seleção de modelos pré-construída.

  8. Preencha os campos da seguinte forma:

    • Identificador de modelo. Especifique qual modelo quer chamar, neste caso estamos a chamar o modelo de fatura predefinido, portanto, introduza prebuilt-invoice.
    • Conteúdo do Ficheiro de Documento/Imagem. Selecione este campo. Aparece um pop-up dinâmico de conteúdo. Se não fizer, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Conteúdo do Ficheiro. Este passo consiste essencialmente em enviar o(s) ficheiro(s) a analisar para o modelo de faturação pré-construído do Document Intelligence. Depois de veres o emblema de conteúdo do ficheiro aparecer no campo de conteúdo do ficheiro Documento/Imagem , completaste este passo corretamente.
    • URL do documento/imagem. Ignora este campo deste projeto porque já estamos a apontar para o conteúdo do ficheiro diretamente da pasta OneDrive.
    • Adicionar novo parâmetro. Ignore este campo para este projeto.

  9. Precisamos de acrescentar mais alguns passos. Mais uma vez, selecione o ➕ botão Novo passo para adicionar outra ação.

  10. Control e seleciona o bloco Control .

    Captura de ecrã do painel de controlo do Choo. Na barra de pesquisa **Escolher uma operação**, selecione um menu de operações.

  11. Desça e selecione o mosaico Para cada Control na lista de Controlo.

    Captura de ecrã do bloco For Each Control no menu Control.

  12. Na janela do passo Para cada, há um campo chamado Selecionar uma saída dos passos anteriores. Selecione este campo. Aparece um pop-up dinâmico de conteúdo. Se não estiver, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha documentos.

    Captura de ecrã da lista dinâmica de conteúdos.

  13. Agora, selecione Adicionar uma Açãodentro da janela Para cada passo.

  14. Na barra de pesquisa Escolha uma operação, introduza Outlook e selecione Outlook.com (pessoal) ou Office 365 Outlook (trabalho).

  15. Na lista de ações, desça até encontrar Enviar um email (V2) e selecione esta ação.

    Captura de ecrã do botão de ação Enviar um email (V2).

  16. Inicie sessão na sua conta Outlook ou Office 365 Outlook. Depois disso, vê-se uma janela onde vamos formatar o email com conteúdo dinâmico que a Inteligência de Documentos extrai da fatura.

  17. Vamos usar a seguinte expressão para completar alguns dos campos:


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

  1. Para aceder a um campo específico, selecionamos o botão adicionar conteúdo dinâmico e selecionamos o separador Expressão .

    Captura de ecrã do campo da função de expressão.

  2. Na caixa ƒx , copie e cole a fórmula acima e substitua FIELD-NAME pelo nome do campo que queremos extrair. Para a lista completa de campos disponíveis, consulte a página de conceitos da API em questão. Neste caso, usamos os valores de extração do campo do modelo de fatura pré-construído.

  3. Estamos quase a acabar! Faça as seguintes alterações nos seguintes campos:

    • Para. Insira o seu endereço de email pessoal ou profissional, ou qualquer outro endereço de email a que tenha acesso.

    • Assunto. Introduza Fatura recebida de: e deixe o cursor posicionado após os dois-pontos.

    • Introduza a seguinte expressão no campo Expressão e selecione OK:

    
   items('For_each')?['fields']?['VendorName']?['content']
    • Depois de inserires a expressão no campo, seleciona o botão OK e o emblema da fórmula aparecerá no local onde deixaste o cursor:

    Captura de ecrã do campo de expressão da fórmula.

    Captura de ecrã do ícone de expressão de fórmula.

  • Corpo. Vamos acrescentar informações específicas sobre a fatura:

    • Digite ID de fatura: e, usando o mesmo método de antes: posicione o cursor, copie a expressão seguinte para o campo de expressão e selecione OK a seguinte expressão:
    
        items('For_each')?['fields']?['InvoiceId']?['content']
    • Numa nova linha, escreva Data de vencimento da fatura: e anexe a seguinte expressão:
    
        items('For_each')?['fields']?['DueDate']?['content']
    • Digite Valor devido: e anexe a seguinte expressão:
    
        items('For_each')?['fields']?['AmountDue']?['content']
    • Por fim, como o valor devido é importante, também queremos enviar a pontuação de confiança para esta extração no email. Para fazer isto, tipo Quantia devida (confiança): e acrescentar a seguinte expressão:
    
        items('For_each')?['fields']?['AmountDue']?['confidence']

  • Quando terminar, a janela ficará semelhante à imagem seguinte:

    Captura de ecrã da janela Enviar um email (V2) com campos concluídos.

  1. Selecionar Guardar no canto superior esquerdo.

    Captura de ecrã do botão de gravar do Logic Apps Designer.

Nota

  • Esta versão atual só devolve uma única fatura por PDF.
  • O "Para cada ciclo" é necessário em torno da ação de enviar email para permitir um formato de saída que possa devolver mais do que uma fatura de PDFs no futuro.

Depois de guardar o seu Logic App, se precisar de fazer uma atualização ou editar, o nó Para cada ficará semelhante à imagem seguinte:

Captura de ecrã do Para cada nó depois de a aplicação ter sido guardada.

  1. Procure e selecione SharePoint na barra de pesquisa mais uma vez. Depois, selecione a ação Obter conteúdo do ficheiro .

  2. Preencha os campos da seguinte forma:

    • Endereço do local. Selecione o seu site SharePoint.
    • Identificador de ficheiro. Selecione este campo. Aparece um pop-up dinâmico de conteúdo. Se não estiver, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Identificador.
    • Inferir Tipo de Conteúdo. Selecione Sim.

    Captura de ecrã do nó Obter Conteúdo do Ficheiro.

  3. De seguida, vamos adicionar mais um novo passo ao fluxo de trabalho. Selecione o botão ➕ Nova etapa abaixo do nó recém-criado do SharePoint.

  4. Um novo nó é adicionado à visualização do designer da Logic App. Pesquise por "Reconhecedor de Formulários (Document Intelligence em breve)" na barra de pesquisa em Escolha uma operação e selecione Analisar fatura da lista.

    Captura de ecrã da ação Analisar Fatura.

  5. Agora, vês uma janela onde podes criar a tua ligação. Especificamente, vais ligar o teu recurso Reconhecedor de Formulários ao Logic Apps Designer Studio:

    • Introduza um nome de Ligação. Deveria ser algo fácil de lembrar.
    • Introduza o recurso Reconhecedor de Formulários URL do endpoint e Chave de Conta que copiou anteriormente. Se saltaste este passo antes ou perdeste as cadeias, podes voltar ao teu recurso Reconhecedor de Formulários e copiá-las novamente. Quando terminares, seleciona Criar.

    Captura de ecrã da janela de diálogo do conector da Logic App.

    Nota

    Se já iniciaste sessão com as tuas credenciais, o passo anterior é ignorado. Continue completando os parâmetros Analisar a Fatura .

  6. A seguir, vê a janela de parâmetros de seleção para o conector Analisar Fatura.

    Captura de ecrã que mostra a janela de análise da fatura.

  7. Preencha os campos da seguinte forma:

    • Conteúdo do Ficheiro de Documento/Imagem. Selecione este campo. Aparece um pop-up dinâmico de conteúdo. Se não fizer, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Conteúdo do Ficheiro. Este passo consiste essencialmente em enviar o(s) ficheiro(s) a analisar para o modelo de faturação pré-construído do Document Intelligence. Depois de veres o emblema de conteúdo do ficheiro aparecer no campo de conteúdo do ficheiro Documento/Imagem , completaste este passo corretamente.
    • URL do documento/imagem. Ignora este campo deste projeto porque já estamos a apontar para o conteúdo do ficheiro diretamente da pasta OneDrive.
    • Inclua detalhes do texto. Selecione Sim.
    • Adicionar novo parâmetro. Ignore este campo para este projeto.

    Captura de ecrã que mostra os campos da janela de analisar fatura.

  8. Temos de acrescentar o último passo. Mais uma vez, selecione o ➕ botão Novo passo para adicionar outra ação.

  9. Na barra de pesquisa Escolha uma operação, introduza Outlook e selecione Outlook.com (pessoal) ou Office 365 Outlook (trabalho).

  10. Na lista de ações, desça até encontrar Enviar um email (V2) e selecione esta ação.

  11. Inicie sessão na sua conta Outlook ou Office 365 Outlook. Depois disso, vê uma janela onde vamos formatar o email a ser enviado com conteúdo dinâmico extraído da fatura.

    Captura de ecrã do botão de ação Enviar um email (V2).

  12. Estamos quase a acabar! Digite as seguintes entradas nos campos:

    • Para. Insira o seu endereço de email pessoal ou profissional, ou qualquer outro endereço de email a que tenha acesso.

    • Assunto. Introduza Fatura recebida de: e depois adicione conteúdo dinâmico Campo nome do fornecedor Nome do fornecedor.

    • Corpo. Vamos acrescentar informações específicas sobre a fatura:

      • Digite ID de fatura: e anexe o campo de conteúdo dinâmico ID de fatura ID de fatura.

      • Numa nova linha, escreva Data de vencimento da fatura: e anexe o conteúdo dinâmico no campo Data de emissão da fatura (data).

      • Digite Valor devido: e anexe o campo de conteúdo dinâmico Valor devido Valor devido (número).

      • Por fim, como o montante devido é um valor importante, também queremos enviar a pontuação de confiança para esta extração no email. Para fazer isso, digite Valor devido (confiança): e adicione o conteúdo dinâmico campo de confiança do valor devido. Quando terminar, a janela parece semelhante à imagem mostrada a seguir.

      Captura de ecrã dos campos de Outlook completados.

      Dica

      Se não vires automaticamente o conteúdo dinâmico, usa a barra de Pesquisa de conteúdo dinâmico para encontrar entradas nos campos.

  13. Selecionar Guardar no canto superior esquerdo.

    Captura de ecrã do botão de gravar do Logic Apps Designer.

    Nota

    • Esta versão atual só devolve uma única fatura por PDF.
    • O "Para cada ciclo" em torno da ação de enviar email permite um formato de saída que pode devolver mais do que uma fatura de PDFs no futuro.

Teste o fluxo de automação

Vamos rever rapidamente o que concluímos antes de testarmos o nosso fluxo:

  • Criámos um gatilho—neste cenário. O gatilho é ativado quando um ficheiro é criado numa pasta pré-especificada na nossa conta OneDrive.
  • Adicionámos uma ação de Inteligência de Documentos ao nosso fluxo. Neste cenário, decidimos usar a API de faturas para analisar automaticamente uma fatura da pasta OneDrive.
  • Adicionámos uma ação do Outlook.com ao nosso fluxo. Enviámos alguns dos dados das faturas analisadas para um endereço de email pré-determinado.

Agora que criámos o fluxo, a última coisa a fazer é testá-lo e garantir que estamos a obter o comportamento esperado.

  1. Para testar a aplicação Logic, primeiro abra um novo separador e navegue até à pasta OneDrive que definiu no início deste tutorial. Adicione este ficheiro à pasta OneDrive Exemplo de fatura.

  2. Volte ao separador designer da Logic App, selecione o botão de ativação Executar e selecione Executar no menu suspenso.

    Captura de ecrã dos botões Executar gatilho e Executar.

  3. Vês uma mensagem no canto superior=direito a indicar que o disparo foi bem-sucedido:

    Captura de ecrã da mensagem de disparo bem-sucedido.

  4. Navegue até à sua página de visão geral da Logic App selecionando o link do nome da sua aplicação no canto superior esquerdo.

    Captura de ecrã do link para navegar para a página de visão geral.

  5. Verifica o estado para ver se a corrida teve sucesso ou falhou. Pode selecionar o indicador de estado para verificar quais os passos que foram bem-sucedidos.

    Captura de ecrã do estado de Sucesso ou Falha.

  6. Se a sua tentativa falhou, verifique o passo falhado para garantir que introduziu a informação correta.

    Captura de ecrã do passo falhado.

  7. Depois de uma execução de fluxo de trabalho ter sucesso, verifique o seu email. Há um novo email com a informação que especificámos.

    Captura de ecrã da mensagem de email recebida.

  8. Quando terminares, desativa ou elimina a tua aplicação Logic para que esse uso pare.

    Captura de ecrã dos botões de desativar e apagar.

Parabéns! Completaste este tutorial.

Próximos passos

Saiba mais sobre os modelos de Inteligência Documental

  • Last updated on