Partilhar via


Criar um fluxo de trabalho de Aplicativos Lógicos de Inteligência Documental

Este conteúdo aplica-se a:marca de verificação v4.0 (pré-visualização) | Versões anteriores: Marca de verificação azul v3.1 (GA)Marca de verificação azul v3.0 (GA)

Este conteúdo aplica-se a: marca de verificação v2.1 | Última versão: Marca de verificação azul v4.0 (pré-visualização)

Importante

Este tutorial e o conector de inteligência de documento do aplicativo lógico têm como alvo a API REST de inteligência de documento v3.0 e o encaminhamento.

Importante

Este tutorial e o conector de inteligência de documento do aplicativo lógico têm como alvo a API REST de inteligência de documento v2.1 e devem ser usados com a ferramenta de rotulagem de amostra FOTT.

As Aplicações Lógicas do Azure são uma plataforma baseada na nuvem que pode ser utilizada 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. Um Aplicativo Lógico é o recurso do Azure que você cria quando deseja desenvolver um fluxo de trabalho. Aqui estão alguns exemplos do que você pode fazer com um aplicativo lógico:

  • Crie processos de negócios e fluxos de trabalho visualmente.
  • Integre fluxos de trabalho com software como serviço (SaaS) e aplicações empresariais.
  • Automatize tarefas de integração de aplicativos corporativos (EAI), B2B (business-to-business) e EDI (Electronic Data Interchange).

Para obter mais informações, consulte Visão geral de aplicativos lógicos.

Neste tutorial, mostramos como criar um fluxo de conector do Aplicativo Lógico 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 as informações extraídas da fatura para um endereço de e-mail pré-especificado.

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

Pré-requisitos

Para concluir este tutorial, você precisa dos seguintes recursos:

  • Uma subscrição do Azure. Você pode criar uma assinatura gratuita do Azure

  • Uma conta gratuita de armazenamento na nuvem do OneDrive ou do OneDrive for Business.

    Nota

    • O OneDrive destina-se ao armazenamento pessoal.
    • O OneDrive for Business faz parte do Office 365 e foi projetado para organizações. Ele fornece armazenamento em nuvem onde você pode armazenar, compartilhar e sincronizar todos os arquivos de trabalho.
  • Uma conta de e-mail gratuita do Outlook online ou do Office 365**.

  • Uma fatura de exemplo para testar seu aplicativo lógico. Você pode baixar e usar nosso documento de fatura de exemplo para este tutorial.

  • Um recurso de Document Intelligence. Depois de ter sua assinatura do Azure, crie um recurso de Inteligência Documental no portal do Azure para obter sua chave e ponto de extremidade. Se você tiver um recurso de Document Intelligence existente, navegue diretamente para sua página de recurso. Você pode usar o nível de preço gratuito (F0) para experimentar o serviço e atualizar posteriormente para um nível pago para produção.

    • Após o recurso ser implementado, selecione Ir para recurso. Copie os valores de Chaves e Pontos de Extremidade do seu recurso no portal do Azure e cole-os em um local conveniente, como o Bloco de Notas da Microsoft. Você precisa dos valores de chave e ponto de extremidade para conectar seu aplicativo à API de Document Intelligence. Para obter mais informações, consulte Criar um recurso de Document Intelligence.

      Captura de ecrã a mostrar como aceder à chave de recurso e ao URL do ponto de extremidade.

Criar uma pasta do OneDrive

Antes de começarmos a criar o Aplicativo Lógico, precisamos configurar uma pasta do OneDrive.

  1. Inicie sessão na sua home page do OneDrive ou do OneDrive para Empresas .

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

    Captura de ecrã do botão add-new.

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

    Captura de tela da janela criar e nomear pasta.

  4. Você vê a nova pasta em seus arquivos.

    Captura de ecrã da nova pasta.

  5. Por enquanto, acabamos com o OneDrive.

Criar um recurso do Aplicativo Lógico

Neste ponto, você deve ter um recurso de Inteligência Documental e uma pasta do OneDrive todos definidos. Agora, é hora de criar um recurso de aplicativo lógico.

  1. Navegue para o portal do Azure.

  2. Selecione ➕ Criar um recurso na home page do Azure.

    Captura de ecrã da criação de um recurso no portal do Azure.

  3. Pesquise e escolha Logic App na barra de pesquisa.

  4. Selecione o botão criar

    Captura de ecrã da página Criar Aplicação Lógica.

  5. Em seguida, você preencherá os campos Criar Aplicativo Lógico com os seguintes valores:

    • Subscrição. Selecione sua assinatura atual.
    • Grupo de recursos. O grupo de recursos do Azure que contém seu recurso. Escolha o mesmo grupo de recursos que você tem para seu recurso de Document Intelligence.
    • Tipo. Selecione Consumo. O tipo de recurso Consumo é executado em Aplicativos Lógicos do Azure globais multilocatários e usa o modelo de cobrança de Consumo.
    • Nome da Aplicação Lógica. 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.
    • Habilite a análise de log. Para este projeto, selecione Não.
    • Tipo de plano. Selecione Consumo. O tipo de recurso Consumo é executado em Aplicativos Lógicos do Azure globais multilocatários e usa o modelo de cobrança de Consumo.
    • Redundância de zona. Selecione desativado.
  6. Quando terminar, você terá algo semelhante à imagem a seguir (Grupo de recursos, nome do aplicativo lógico e região podem ser diferentes). Depois de verificar esses valores, selecione Revisar + criar no canto inferior esquerdo.

    Captura de tela mostrando valores de campo para criar um recurso do Aplicativo Lógico.

  7. Uma breve verificação de validação é executada. Depois que for concluído com êxito, selecione Criar no canto inferior esquerdo.

  8. Em seguida, você será redirecionado para uma tela que diz Implantação em andamento. Dê algum tempo ao Azure para implementar; Pode demorar alguns minutos. Depois que a implantação for concluída, você verá um banner que diz: Sua implantação foi concluída. Quando chegar a esta tela, selecione Ir para recurso.

  9. Finalmente, você será redirecionado para a página Logic Apps Designer . Há um pequeno vídeo para uma rápida introdução aos Aplicativos Lógicos disponível na tela inicial. Quando estiver pronto para começar a criar seu Aplicativo Lógico, selecione o botão Aplicativo Lógico em Branco na seção Modelos .

    Captura de tela mostrando como entrar no Logic App Designer.

  10. Você verá uma tela semelhante à imagem a seguir. Agora, você está pronto para começar a projetar e implementar seu aplicativo lógico.

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

Criar um fluxo de automação

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

  1. Procure e selecione OneDrive ou OneDrive for Business na barra de pesquisa. Em seguida, selecione o gatilho Quando um arquivo é criado .

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

  2. Em seguida, uma janela pop-up será exibida, solicitando que você faça logon em sua conta do OneDrive. Selecione Entrar e siga as instruções para conectar sua conta.

    Gorjeta

    Se tentar iniciar sessão no conector do OneDrive utilizando uma conta do Office 365, poderá receber o seguinte erro: Desculpe, não podemos entrar aqui com sua @MICROSOFT.COM conta.

    • Este erro acontece porque o OneDrive é um armazenamento baseado na nuvem para uso pessoal que pode ser acedido com uma conta Outlook.com ou Microsoft Live e não com uma conta do Office 365.
    • Você pode usar o conector do OneDrive for Business se quiser usar uma conta do Office 365. Certifique-se de que criou uma Pasta do OneDrive para este projeto na sua conta do OneDrive para Empresas.
  3. Depois que sua conta estiver conectada, selecione a pasta que você criou anteriormente em sua conta do OneDrive ou OneDrive for Business . Deixe os outros valores padrão no lugar.

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

  1. Em seguida, vamos adicionar uma nova etapa ao fluxo de trabalho. Selecione o ➕ botão Nova etapa abaixo do nó do OneDrive recém-criado.

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

  2. Um novo nó é adicionado à exibição do designer do Aplicativo Lógico. Procure por Form Recognizer (Document Intelligence em breve) na barra de pesquisa Escolha uma operação e selecione Analisar documento para modelos pré-construídos ou personalizados (v3.0 API) na lista.

    Captura de ecrã do botão de seleção Analisar documento para modelos pré-construídos ou personalizados (API v3.0).

  3. Agora, você vê uma janela para criar sua conexão. Especificamente, você conectará seu recurso de Document Intelligence ao Logic Apps Designer Studio:

    • Insira um nome de conexão. Deve ser algo fácil de lembrar.

    • Insira a URL do ponto de extremidade do recurso Document Intelligence e a chave da conta que você copiou anteriormente. Se você pulou esta etapa anteriormente ou perdeu as cadeias de caracteres, poderá navegar de volta para o recurso Document Intelligence e copiá-las novamente. Quando tiver terminado, selecione Criar.

      Captura de ecrã da janela de diálogo do conector da aplicação lógica

    Nota

    Se você já fez login com suas credenciais, a etapa anterior será ignorada.

  4. Em seguida, você verá a janela de parâmetros de seleção para o conector Analyze Document for Prebuilt or Custom Models (v3.0 API).

    Captura de tela da janela de seleção de modelo pré-construído.

  5. Preencha os campos da seguinte forma:

    • Identificador do modelo. Especifique qual modelo você deseja chamar, neste caso, estamos chamando o modelo de fatura pré-construído, portanto, insira a fatura pré-construída.

    • Conteúdo do arquivo de documento/imagem. Selecione este campo. É apresentado um pop-up de conteúdo dinâmico. Caso contrário, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Conteúdo do arquivo. Esta etapa consiste essencialmente em enviar o(s) arquivo(s) a ser analisado(s) para o modelo de fatura pré-construída do Document Intelligence. Depois de ver o selo de conteúdo do arquivo exibido no campo de conteúdo do arquivo de documento/imagem, você concluiu esta etapa corretamente.

    • URL do documento/imagem. Ignore este campo para este projeto porque já estamos apontando para o conteúdo do arquivo diretamente da pasta OneDrive.

    • Adicione um novo parâmetro. Pule este campo para este projeto.

      Captura de tela da janela de conteúdo de adicionar arquivo.

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

  7. Na barra de pesquisa Escolha uma operação, insira Controle e selecione o bloco Controle.

    Captura de ecrã do mosaico de controlo a partir do menu Escolher uma Operação.

  8. Role para baixo e selecione o bloco Para cada controle na lista Controle .

    Captura de ecrã do mosaico Para Cada Controlo no menu Controlo.

  9. Na janela Para cada etapa, há um campo chamado Selecione uma saída das etapas anteriores. Selecione este campo. É apresentado um pop-up de conteúdo dinâmico. Caso contrário, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha documentos.

    Captura de ecrã da lista de conteúdo dinâmico.

  10. Agora, selecione Adicionar uma ação na janela Para cada etapa.

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

  12. Na lista de ações, role para baixo até encontrar Enviar um e-mail (V2) e selecione esta ação.

    Captura de ecrã do botão de ação Enviar um e-mail (V2).

  13. Tal como acontece com o OneDrive, é-lhe pedido para iniciar sessão na sua conta do Outlook ou do Office 365 Outlook. Depois de entrar, você verá uma janela onde formataremos o e-mail com conteúdo dinâmico que o Document Intelligence extrai da fatura.

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

    
      items('For_each')?['fields']?['FIELD-NAME']?['content']
    
  15. Para acessar um campo específico, selecionamos o botão adicionar o conteúdo dinâmico e selecionamos a guia Expressão .

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

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

  17. Estamos quase a terminar! Faça as seguintes alterações nos seguintes campos:

    • Para. Introduza o seu endereço de e-mail pessoal ou comercial ou qualquer outro endereço de e-mail a que tenha acesso.

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

      
        items('For_each')?['fields']?['VendorName']?['content']
      
    • Corpo. Vamos adicionar informações específicas sobre a fatura:

      • Digite ID da fatura: e, usando o mesmo método anterior, acrescente a seguinte expressão:

        
        items('For_each')?['fields']?['InvoiceId']?['content']
        
      • Em uma nova linha, digite Data de vencimento da fatura: e acrescente a seguinte expressão:

        
          items('For_each')?['fields']?['DueDate']?['content']
        
      • Digite Montante devido: e anexe a seguinte expressão:

        
          items('For_each')?['fields']?['AmountDue']?['content']
        
      • Por fim, como o valor devido é um número importante, também queremos enviar o score de confiança para essa extração no e-mail. Para fazer isso, digite Montante devido (confiança): e acrescente a seguinte expressão:

        
          items('For_each')?['fields']?['AmountDue']?['confidence']
        
    • Quando terminar, a janela será semelhante à seguinte imagem:

      Captura de ecrã da janela Enviar um e-mail (V2) com campos preenchidos.

  18. Selecione Salvar no canto superior esquerdo.

    Captura de tela do botão Salvar do Logic Apps Designer.

Nota

  • Esta versão atual retorna apenas uma única fatura por PDF.
  • O "Para cada loop" é necessário em torno da ação de envio de e-mail para habilitar um formato de saída que pode retornar mais de uma fatura de PDFs no futuro.
  1. Em seguida, vamos adicionar uma nova etapa ao fluxo de trabalho. Selecione o ➕ botão Nova etapa abaixo do nó do OneDrive recém-criado.

  2. Um novo nó é adicionado à exibição do designer do Aplicativo Lógico. Procure por "Form Recognizer (Document Intelligence a publicar)" na barra de pesquisa Escolha uma operação e selecione Analisar fatura na lista.

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

  3. Agora, você vê uma janela onde você pode criar sua conexão. Especificamente, você conectará seu recurso do Reconhecimento de Formulário ao Logic Apps Designer Studio:

    • Insira um nome de conexão. Deve ser algo fácil de lembrar.
    • Insira a URL do ponto de extremidade do recurso do Reconhecedor de Formulário e a Chave da Conta que você copiou anteriormente. Se você ignorou esta etapa anteriormente ou perdeu as cadeias de caracteres, poderá navegar de volta para o recurso do Reconhecimento de Formulário e copiá-las novamente. Quando tiver terminado, selecione Criar.

    Captura de ecrã da janela de diálogo do conector da aplicação lógica.

    Nota

    Se você já fez login com suas credenciais, a etapa anterior será ignorada. Continue preenchendo os parâmetros Analisar fatura.

  4. Em seguida, você verá a janela de parâmetros de seleção para o conector Analisar fatura .

    Captura de tela mostrando os campos da janela de análise de fatura.

  5. Preencha os campos da seguinte forma:

    • Conteúdo do arquivo de documento/imagem. Selecione este campo. É apresentado um pop-up de conteúdo dinâmico. Caso contrário, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Conteúdo do arquivo. Esta etapa consiste essencialmente em enviar o(s) arquivo(s) a ser analisado(s) para o modelo de fatura pré-construída do Document Intelligence. Depois de ver o selo de conteúdo do arquivo exibido no campo de conteúdo do arquivo de documento/imagem, você concluiu esta etapa corretamente.
    • URL do documento/imagem. Ignore este campo para este projeto porque já estamos apontando para o conteúdo do arquivo diretamente da pasta OneDrive.
    • Inclua detalhes do texto. Selecione Yes (Sim).
    • Adicione um novo parâmetro. Pule este campo para este projeto.
  6. Temos de acrescentar o último passo. Mais uma vez, selecione o ➕ botão Nova etapa para adicionar outra ação.

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

  8. Na lista de ações, role para baixo até encontrar Enviar um e-mail (V2) e selecione esta ação.

  9. Inicie sessão na sua conta do Outlook ou do Office 365 Outlook . Depois de fazer isso, você verá uma janela onde vamos formatar o e-mail a ser enviado com conteúdo dinâmico extraído da fatura.

    Captura de ecrã do botão de ação Enviar um e-mail (V2).

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

    • Para. Introduza o seu endereço de e-mail pessoal ou comercial ou qualquer outro endereço de e-mail a que tenha acesso.

    • Assunto. Insira Fatura recebida de: e anexe conteúdo dinâmico Campo Nome do fornecedor Nome do fornecedor.

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

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

      • Em um novo tipo de linha Data de vencimento da fatura: e anexe o conteúdo dinâmico Data da fatura Campo Data da fatura (data).

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

      • Por fim, como o valor devido é um número importante, também queremos enviar o score de confiança para essa extração no e-mail. Para fazer este tipo Montante devido (confiança): e adicione o conteúdo dinâmico Montante devido campo confiança do montante devido. Quando terminar, a janela será semelhante à imagem a seguir.

      Captura de ecrã dos campos do Outlook preenchidos.

      Gorjeta

      Se você não vir o conteúdo dinâmico exibido automaticamente, use a barra de conteúdo dinâmico Pesquisar para localizar entradas de campo.

  11. Selecione Salvar no canto superior esquerdo.

    Captura de tela do botão Salvar do Logic Apps Designer.

    Nota

    • Esta versão atual retorna apenas uma única fatura por PDF.
    • O "Para cada loop" em torno da ação de envio de e-mail permite um formato de saída que pode retornar mais de uma fatura de PDFs no futuro.

Pré-requisitos

Para concluir este tutorial, você precisa dos seguintes recursos:

  • Uma subscrição do Azure. Você pode criar uma assinatura gratuita do Azure

  • Acesso a um site do SharePoint.

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

  • Uma fatura de exemplo para testar seu aplicativo lógico. Você pode baixar e usar nosso documento de fatura de exemplo para este tutorial.

  • Um recurso de Document Intelligence. Depois de ter sua assinatura do Azure, crie um recurso de Inteligência Documental no portal do Azure para obter sua chave e ponto de extremidade. Se você tiver um recurso de Document Intelligence existente, navegue diretamente para sua página de recurso. Você pode usar o nível de preço gratuito (F0) para experimentar o serviço e atualizar posteriormente para um nível pago para produção.

    • Após o recurso ser implementado, selecione Ir para recurso. Copie os valores de Chaves e Pontos de Extremidade do seu recurso no portal do Azure e cole-os em um local conveniente, como o Bloco de Notas da Microsoft. Você precisa dos valores de chave e ponto de extremidade para conectar seu aplicativo à API de Document Intelligence. Para obter mais informações, consulte Criar um recurso de Document Intelligence.

      Captura de ecrã a mostrar como aceder à chave de recurso e ao URL do ponto de extremidade.

Criar uma pasta do Sharepoint

Antes de começarmos a criar o Aplicativo Lógico, precisamos configurar uma pasta do Sharepoint.

  1. Entre na home page do site do SharePoint .

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

    Captura de ecrã do botão add-new.

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

    Captura de tela da janela criar e nomear pasta.

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

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

  5. Por enquanto, acabamos com o SharePoint.

Criar recurso do Aplicativo Lógico

Neste ponto, você deve ter um recurso de Inteligência Documental e uma pasta do SharePoint todos definidos. Agora, é hora de criar um recurso de aplicativo lógico.

  1. Navegue para o portal do Azure.

  2. Selecione ➕ Criar um recurso na home page do Azure.

    Captura de ecrã da criação de um recurso no portal do Azure.

  3. Pesquise e escolha Logic App na barra de pesquisa.

  4. Selecione o botão criar

    Captura de ecrã da página Criar Aplicação Lógica.

  5. Em seguida, você preencherá os campos Criar Aplicativo Lógico com os seguintes valores:

    • Subscrição. Selecione sua assinatura atual.
    • Grupo de recursos. O grupo de recursos do Azure que contém seu recurso. Escolha o mesmo grupo de recursos que você tem para seu recurso de Document Intelligence.
    • Tipo. Selecione Consumo. O tipo de recurso Consumo é executado em Aplicativos Lógicos do Azure globais multilocatários e usa o modelo de cobrança de Consumo.
    • Nome da Aplicação Lógica. 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.
    • Habilite a análise de log. Para este projeto, selecione Não.
    • Tipo de plano. Selecione Consumo. O tipo de recurso Consumo é executado em Aplicativos Lógicos do Azure globais multilocatários e usa o modelo de cobrança de Consumo.
    • Redundância de zona. Selecione desativado.
  6. Quando terminar, você terá algo semelhante à imagem a seguir (Grupo de recursos, nome do aplicativo lógico e região podem ser diferentes). Depois de verificar esses valores, selecione Revisar + criar no canto inferior esquerdo.

    Captura de tela mostrando valores de campo para criar um recurso do Aplicativo Lógico.

  7. Uma breve verificação de validação é executada. Depois que for concluído com êxito, selecione Criar no canto inferior esquerdo.

  8. Em seguida, você será redirecionado para uma tela que diz Implantação em andamento. Dê algum tempo ao Azure para implementar; Pode demorar alguns minutos. Depois que a implantação for concluída, você verá um banner que diz: Sua implantação foi concluída. Quando chegar a esta tela, selecione Ir para recurso.

  9. Finalmente, você será redirecionado para a página Logic Apps Designer . Há um pequeno vídeo para uma rápida introdução aos Aplicativos Lógicos disponível na tela inicial. Quando estiver pronto para começar a criar seu Aplicativo Lógico, selecione o botão Aplicativo Lógico em Branco na seção Modelos .

    Captura de tela mostrando como entrar no Logic App Designer.

  10. Você verá uma tela semelhante à imagem a seguir. Agora, você está pronto para começar a projetar e implementar seu aplicativo lógico.

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

  11. Procure e selecione SharePoint na barra de pesquisa. Em seguida, selecione o gatilho Quando um arquivo é criado (somente propriedades).

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

  12. As Aplicações Lógicas iniciam automaticamente sessão na(s) sua(s) conta(s) do SharePoint.

  13. Depois que sua conta estiver conectada, preencha os campos Endereço do Site e Nome da Biblioteca. Selecione o campo Adicionar novo parâmetro e selecione Pasta.

    Captura de tela da janela Quando um arquivo é criado com o parâmetro adicionado.

  14. Selecione o caminho do diretório, incluindo a pasta que você criou anteriormente.

    Captura de tela do campo de parâmetro adicionado.

    Gorjeta

    Selecione a seta no final de cada pasta listada para percorrer até a próxima pasta no caminho: Captura de tela de como percorrer o caminho da pasta.

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

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

  3. Preencha os campos da seguinte forma:

    • Endereço do site. Selecione seu site do SharePoint.
    • Identificador de arquivo. Selecione este campo. É apresentado um pop-up de conteúdo dinâmico. Caso contrário, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Identificador.
    • Inferir tipo de conteúdo. Selecione Yes (Sim).

    Captura de tela do nó Obter conteúdo do arquivo.

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

  5. Um novo nó é adicionado à exibição do designer do Aplicativo Lógico. Procure por Form Recognizer (Document Intelligence em breve) na barra de pesquisa Escolha uma operação e selecione Analisar documento para modelos pré-construídos ou personalizados (v3.0 API) na lista.

    Captura de ecrã do botão de seleção Analisar documento para modelos pré-construídos ou personalizados (API v3.0).

  6. Agora, você vê uma janela onde você pode criar sua conexão. Especificamente, você conectará seu recurso de Document Intelligence ao Logic Apps Designer Studio:

    • Insira um nome de conexão. Deve ser algo fácil de lembrar.

    • Insira a URL do ponto de extremidade do recurso Document Intelligence e a chave da conta que você copiou anteriormente. Se você pulou esta etapa anteriormente ou perdeu as cadeias de caracteres, poderá navegar de volta para o recurso Document Intelligence e copiá-las novamente. Quando tiver terminado, selecione Criar.

      Captura de ecrã da janela de diálogo do conector da aplicação lógica

    Nota

    Se você já fez login com suas credenciais, a etapa anterior será ignorada.

  7. Em seguida, você verá a janela de parâmetros de seleção para o conector Analisar documento para modelos pré-construídos ou personalizados (API v3.0).

    Captura de tela da janela de seleção de modelo pré-construído.

  8. Preencha os campos da seguinte forma:

    • Identificador do modelo. Especifique qual modelo você deseja chamar, neste caso, estamos chamando o modelo de fatura pré-construído, portanto, insira a fatura pré-construída.
    • Conteúdo do arquivo de documento/imagem. Selecione este campo. É apresentado um pop-up de conteúdo dinâmico. Caso contrário, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Conteúdo do arquivo. Esta etapa consiste essencialmente em enviar o(s) arquivo(s) a ser analisado(s) para o modelo de fatura pré-construída do Document Intelligence. Depois de ver o selo de conteúdo do arquivo exibido no campo de conteúdo do arquivo de documento/imagem, você concluiu esta etapa corretamente.
    • URL do documento/imagem. Ignore este campo para este projeto porque já estamos apontando para o conteúdo do arquivo diretamente da pasta OneDrive.
    • Adicione um novo parâmetro. Pule este campo para este projeto.
  9. Precisamos de acrescentar mais alguns passos. Mais uma vez, selecione o ➕ botão Nova etapa para adicionar outra ação.

  10. Controle e selecione o bloco Controle .

    Captura de tela do bloco de controle do Choo. Na barra de pesquisa **Escolha uma operação**, insira um menu Operação.

  11. Role para baixo e selecione o bloco Para cada controle na lista Controle .

    Captura de ecrã do mosaico Para Cada Controlo no menu Controlo.

  12. Na janela Para cada etapa, há um campo chamado Selecione uma saída das etapas anteriores. Selecione este campo. É apresentado um pop-up de conteúdo dinâmico. Caso contrário, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha documentos.

    Captura de ecrã da lista de conteúdo dinâmico.

  13. Agora, selecione Adicionar uma ação na janela Para cada etapa.

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

  15. Na lista de ações, role para baixo até encontrar Enviar um e-mail (V2) e selecione esta ação.

    Captura de ecrã do botão de ação Enviar um e-mail (V2).

  16. Inicie sessão na sua conta do Outlook ou do Office 365 Outlook. Depois de fazer isso, você verá uma janela onde vamos formatar o e-mail com conteúdo dinâmico que o Document Intelligence extrai da fatura.

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

    
      items('For_each')?['fields']?['FIELD-NAME']?['content']
    
  18. Para acessar um campo específico, selecionamos o botão adicionar o conteúdo dinâmico e selecionamos a guia Expressão .

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

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

  20. Estamos quase a terminar! Faça as seguintes alterações nos seguintes campos:

    • Para. Introduza o seu endereço de e-mail pessoal ou comercial ou qualquer outro endereço de e-mail a que tenha acesso.

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

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

      
        items('For_each')?['fields']?['VendorName']?['content']
      
      • Depois de inserir a expressão no campo, selecione o botão OK e o selo da fórmula aparecerá no local onde você deixou o cursor:

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

      Captura de ecrã do emblema de expressão de fórmula.

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

      • Digite ID da fatura: e, usando o mesmo método anterior: posicione o cursor, copie a seguinte expressão no campo de expressão e selecione OK a seguinte expressão:

        
        items('For_each')?['fields']?['InvoiceId']?['content']
        
      • Em uma nova linha, digite Data de vencimento da fatura: e acrescente a seguinte expressão:

        
          items('For_each')?['fields']?['DueDate']?['content']
        
      • Digite Montante devido: e anexe a seguinte expressão:

        
          items('For_each')?['fields']?['AmountDue']?['content']
        
      • Por fim, como o valor devido é um número importante, também queremos enviar o score de confiança para essa extração no e-mail. Para fazer isso, digite Montante devido (confiança): e acrescente a seguinte expressão:

        
          items('For_each')?['fields']?['AmountDue']?['confidence']
        
    • Quando terminar, a janela será semelhante à seguinte imagem:

      Captura de ecrã da janela Enviar um e-mail (V2) com campos preenchidos.

  21. Selecione Salvar no canto superior esquerdo.

    Captura de tela do botão Salvar do Logic Apps Designer.

Nota

  • Esta versão atual retorna apenas uma única fatura por PDF.
  • O "Para cada loop" é necessário em torno da ação de envio de e-mail para habilitar um formato de saída que pode retornar mais de uma fatura de PDFs no futuro.

Depois de salvar seu aplicativo lógico, se você precisar fazer uma atualização ou editar seu Para cada nó será semelhante à seguinte imagem:

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. Em seguida, selecione a ação Obter conteúdo do arquivo.

  2. Preencha os campos da seguinte forma:

    • Endereço do site. Selecione seu site do SharePoint.
    • Identificador de arquivo. Selecione este campo. É apresentado um pop-up de conteúdo dinâmico. Caso contrário, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Identificador.
    • Inferir tipo de conteúdo. Selecione Yes (Sim).

    Captura de tela do nó Obter conteúdo do arquivo.

  3. Em seguida, vamos adicionar outra nova etapa ao fluxo de trabalho. Selecione o ➕ botão Nova etapa abaixo do nó do SharePoint recém-criado.

  4. Um novo nó é adicionado à exibição do designer do Aplicativo Lógico. Procure por "Form Recognizer (Document Intelligence nextcoming)" na barra de pesquisa Escolha uma operação e selecione Analisar fatura na lista.

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

  5. Agora, você verá uma janela onde criar sua conexão. Especificamente, você conectará seu recurso do Reconhecimento de Formulário ao Logic Apps Designer Studio:

    • Insira um nome de conexão. Deve ser algo fácil de lembrar.
    • Insira a URL do ponto de extremidade do recurso do Reconhecedor de Formulário e a Chave da Conta que você copiou anteriormente. Se você ignorou esta etapa anteriormente ou perdeu as cadeias de caracteres, poderá navegar de volta para o recurso do Reconhecimento de Formulário e copiá-las novamente. Quando tiver terminado, selecione Criar.

    Captura de ecrã da janela de diálogo do conector da aplicação lógica.

    Nota

    Se você já fez login com suas credenciais, a etapa anterior será ignorada. Continue preenchendo os parâmetros Analisar fatura.

  6. Em seguida, você verá a janela de parâmetros de seleção para o conector Analisar fatura .

    Captura de tela mostrando a janela de análise de fatura.

  7. Preencha os campos da seguinte forma:

    • Conteúdo do arquivo de documento/imagem. Selecione este campo. É apresentado um pop-up de conteúdo dinâmico. Caso contrário, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Conteúdo do arquivo. Esta etapa consiste essencialmente em enviar o(s) arquivo(s) a ser analisado(s) para o modelo de fatura pré-construída do Document Intelligence. Depois de ver o selo de conteúdo do arquivo exibido no campo de conteúdo do arquivo de documento/imagem, você concluiu esta etapa corretamente.
    • URL do documento/imagem. Ignore este campo para este projeto porque já estamos apontando para o conteúdo do arquivo diretamente da pasta OneDrive.
    • Inclua detalhes do texto. Selecione Yes (Sim).
    • Adicione um novo parâmetro. Pule este campo para este projeto.

    Captura de tela mostrando os campos da janela de análise de fatura.

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

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

  10. Na lista de ações, role para baixo até encontrar Enviar um e-mail (V2) e selecione esta ação.

  11. Inicie sessão na sua conta do Outlook ou do Office 365 Outlook . Depois de fazer isso, você verá uma janela onde vamos formatar o e-mail a ser enviado com conteúdo dinâmico extraído da fatura.

    Captura de ecrã do botão de ação Enviar um e-mail (V2).

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

    • Para. Introduza o seu endereço de e-mail pessoal ou comercial ou qualquer outro endereço de e-mail a que tenha acesso.

    • Assunto. Insira Fatura recebida de: e anexe conteúdo dinâmico Campo Nome do fornecedor Nome do fornecedor.

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

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

      • Em um novo tipo de linha Data de vencimento da fatura: e anexe o conteúdo dinâmico Data da fatura Campo Data da fatura (data).

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

      • Por fim, como o valor devido é um número importante, também queremos enviar o score de confiança para essa extração no e-mail. Para fazer este tipo Montante devido (confiança): e adicione o conteúdo dinâmico Montante devido campo confiança do montante devido. Quando terminar, a janela será semelhante à imagem a seguir.

      Captura de ecrã dos campos do Outlook preenchidos.

      Gorjeta

      Se você não vir o conteúdo dinâmico exibido automaticamente, use a barra de conteúdo dinâmico Pesquisar para localizar entradas de campo.

  13. Selecione Salvar no canto superior esquerdo.

    Captura de tela do botão Salvar do Logic Apps Designer.

    Nota

    • Esta versão atual retorna apenas uma única fatura por PDF.
    • O "Para cada loop" em torno da ação de envio de e-mail permite um formato de saída que pode retornar mais de uma fatura de PDFs no futuro.

Testar o fluxo de automação

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

  • Criamos um gatilho — nesse cenário. O gatilho é ativado quando um arquivo é criado em uma pasta pré-especificada em nossa conta do OneDrive.
  • Adicionamos uma ação de Inteligência Documental ao nosso fluxo. Nesse cenário, decidimos usar a API de fatura para analisar automaticamente uma fatura da pasta OneDrive.
  • Adicionamos uma ação Outlook.com ao nosso fluxo. Enviamos alguns dos dados da fatura analisados para um endereço de e-mail pré-determinado.

Agora que criamos o fluxo, a última coisa a fazer é testá-lo e ter certeza de que estamos obtendo o comportamento esperado.

  1. Para testar o Aplicativo Lógico, primeiro abra uma nova guia e navegue até a pasta do OneDrive que você configurou no início deste tutorial. Adicione este ficheiro à pasta do OneDrive Fatura de exemplo.

  2. Retorne à guia Designer do Aplicativo Lógico e selecione o botão Executar gatilho e selecione Executar no menu suspenso.

    Captura de tela dos botões Executar gatilho e Executar.

  3. Você verá uma mensagem no canto superior = direito indicando que o gatilho foi bem-sucedido:

    Captura de tela da mensagem de gatilho bem-sucedido.

  4. Navegue até a página de visão geral do Logic App selecionando o link do nome do aplicativo no canto superior esquerdo.

    Captura de tela do link da página de navegação para visão geral.

  5. Verifique o status, para ver se a execução foi bem-sucedida ou falhou. Você pode selecionar o indicador de status para verificar quais etapas foram bem-sucedidas.

    Captura de ecrã do estado Êxito ou Falha.

  6. Se a execução falhou, verifique a etapa de falha para garantir que você inseriu as informações corretas.

    Captura de ecrã do passo falhado.

  7. Depois que a execução de um fluxo de trabalho for bem-sucedida, verifique seu e-mail. Há um novo e-mail com as informações que especificamos.

    Captura de ecrã da mensagem de e-mail recebida.

  8. Depois de terminar, desative ou exclua seu aplicativo lógico para que o uso pare.

    Captura de ecrã dos botões de desativação e eliminação.

Parabéns! Você concluiu este tutorial.

Próximos passos