Criar um fluxo de trabalho dos Aplicativos Lógicos com Informação de Documentos

Este conteúdo se aplica a:marca de seleçãov4.0 (versão prévia) | Versões anteriores:marca de seleção azulv3.1 (disponibilidade geral)marca de seleção azulv3.0 (disponibilidade geral)

Este conteúdo se aplica a:marca de seleçãov2.1 | Versão mais recente:marca de seleção azulv4.0 (versão prévia)

Importante

Esse tutorial e o conector de Informação de Documentos do Aplicativo Lógico têm como destino a API REST de informação de documentos v3.0 e posterior.

Importante

Esse tutorial e o conector de Informação de Documentos do Aplicativo Lógico têm como destino a API REST de informação de documentos v2.1 e deve ser usado com a Ferramenta de Rotulagem FOTT.

Os Aplicativos Lógicos do Azure são uma plataforma baseada em nuvem que pode ser usada para automatizar fluxos de trabalho, sem gravar uma única linha de código. A plataforma permite que você integre facilmente a Microsoft e seus aplicativos com seus aplicativos, dados, serviços e sistemas. Um Aplicativo Lógico é o recurso do Azure criado quando você deseja desenvolver um fluxo de trabalho. Estes são alguns exemplos do que você pode fazer com um Aplicativo Lógico:

  • Crie fluxos de trabalho e processos empresariais visualmente.
  • Integre fluxos de trabalho com aplicativos empresariais e de SaaS (software como serviço).
  • Automatize as tarefas de EAI (integração de aplicativos empresariais) B2B e EDI (intercâmbio eletrônico de dados).

Para obter mais informações, confira Visão Geral dos Aplicativos Lógicos.

Neste tutorial, mostraremos como compilar um fluxo de conector de Aplicativo Lógico para automatizar as seguintes tarefas:

  • Detecte quando uma fatura foi adicionada a uma pasta do OneDrive.
  • Processe a fatura usando o modelo de fatura predefinido da Informação de Documentos.
  • Envie as informações extraídas da fatura para um endereço de email 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ê precisará dos seguintes recursos:

  • Uma assinatura do Azure. Você pode criar uma assinatura gratuita do Azure

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

    Observação

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

  • Uma fatura de exemplo para testar o Aplicativo Lógico. Você pode baixar e usar nosso documento de fatura de exemplo para este tutorial.

  • Um recurso da Informação de Documentos. Depois de obter sua assinatura do Azure, crie um recurso da Informação de Documentos no portal do Azure para obter a chave e o ponto de extremidade. Se você tiver um recurso de Informação de Documento existente, navegue diretamente para a página de recursos. Use o tipo de preço gratuito (F0) para experimentar o serviço e atualizar mais tarde para um nível pago para produção.

    • Após a implantação do recurso, selecione Ir para o recurso. Copie os valores de recursos em Chaves e Ponto de Extremidade do portal do Azure e cole-os em um local viável, como o Bloco de Notas Microsoft. Você precisa dos valores de chave e ponto de extremidade para conectar o aplicativo à API da Informação de Documentos. Para obter mais informações, consulteCriar um recurso de Informação de Documentos.

      Captura de tela mostrando como acessar a chave de recurso e a URL do ponto de extremidade.

Criar uma pasta do OneDrive

Antes de entrarmos na criação do Aplicativo Lógico, precisamos configurar uma pasta do OneDrive.

  1. Conecte-se à home page do OneDrive ou do OneDrive for Business.

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

    Captura de tela da opção Adicionar novo botão.

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

    Captura de tela da janela de criação e nome da pasta.

  4. Você vê a nova pasta nos arquivos.

    Captura de tela da nova pasta.

  5. Por enquanto, terminamos com o OneDrive.

Criar um recurso de Aplicativo Lógico

A essa altura, você deve ter um recurso de Informação de Documentos e uma pasta do OneDrive com tudo pronto. Agora, chegou a hora de criar um recurso de Aplicativo Lógico.

  1. Navegue até o Portal do Azure.

  2. Na página inicial do Azure, selecione ➕ Criar um recurso.

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

  3. Procure e escolha Aplicativo Lógico na barra de pesquisa.

  4. Selecionar o botão Criar

    Captura de tela da página Criar Aplicativo lógico.

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

    • Assinatura. Selecione a assinatura atual.
    • Grupo de recursos. O grupo de recursos do Azure que contém o seu recurso. Escolha o mesmo grupo de recursos que você tem para o recurso de Informação de Documentos.
    • Type. Selecione Consumo. O tipo de recurso de Consumo é executado em Aplicativos Lógicos do Azure globais e multilocatário, e usa o modelo de cobrança de Consumo.
    • Nome do Aplicativo Lógico. Insira um nome para o recurso. Recomendamos o uso de um nome descritivo, por exemplo, YourNameLogicApp.
    • Publicação. Selecione Fluxo de Trabalho.
    • Região. Selecione a região local.
    • Habilitar o Log Analytics. Para este projeto, selecione Não.
    • Tipo de Plano. Selecione Consumo. O tipo de recurso de Consumo é executado em Aplicativos Lógicos do Azure globais e multilocatário, e usa o modelo de cobrança de Consumo.
    • Redundância de Zona. Selecione desabilitado.
  6. Quando terminar, você terá algo semelhante a seguinte imagem (o grupo de recursos, o nome do Aplicativo Lógico e a Região podem ser diferentes). Depois de verificar esses valores, selecione Examinar e criar no canto inferior esquerdo.

    Captura de tela mostrando os valores de campo para criar um recurso de aplicativo lógico.

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

  8. A seguir você será redirecionado para uma tela informando que a Implantação está em andamento. Aguarde a implantação do Azure. Pode levar alguns minutos. Depois que a implantação for concluída, você verá uma faixa informando que A implantação foi concluída. Ao acessar essa tela, selecione Ir para o recurso.

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

    Captura de tela mostrando como entrar no Designer de Aplicativo Lógico.

  10. Você verá uma tela semelhante à imagem a seguir. Agora, você está pronto para começar a criar e implementar o Aplicativo Lógico.

    Captura de tela da página inicial do Designer de Aplicativo Lógico.

Criar um fluxo de automação

Agora que você tem o recurso de conector de Aplicativo Lógico instalado 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 tela do conector do OneDrive e da página de seleção de 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 os prompts para se conectar à conta.

    Dica

    Se você tentar entrar no conector do OneDrive usando uma conta Office 365, poderá receber o seguinte erro: não é possível entrar aqui com sua conta@MICROSOFT.COM.

    • Esse erro ocorre porque o OneDrive é um armazenamento em nuvem para uso pessoal, que pode ser acessado com uma conta Outlook.com ou Microsoft Live, não com uma conta Office 365.
    • Você pode usar o conector do OneDrive for Business, se quiser usar uma conta Office 365. Verifique se você criou uma Pasta do OneDrive para este projeto na conta OneDrive for Business.
  3. Depois que a conta estiver conectada, selecione a pasta criada anteriormente na conta OneDrive ou OneDrive for Business. Deixe os outros valores padrão implantados.

    Captura de tela da janela Quando um arquivo é criado.

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

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

  2. Um novo nó deverá é adicionado à exibição do designer do Aplicativo Lógico. Pesquise por Reconhecimento de Formulários (Inteligência de Documentos em breve) na barra de pesquisa Escolher uma operação e selecione Analisar Documento para modelos predefinidos ou personalizados (API v3.0) na lista.

    Captura de tela do botão de seleção Analisar Documento para modelos predefinidos ou personalizados (API v3.0)

  3. Agora você vê uma janela para criar a conexão. Especificamente, você conectará o recurso de Informação de Documentos ao Estúdio do Designer dos Aplicativos Lógicos:

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

    • Insira a URL do ponto de extremidade do recurso de Informação de Documentos e a Chave de Conta copiada anteriormente. Se você ignorou essa etapa anteriormente ou perdeu as cadeias de caracteres, poderá navegar de volta para o recurso de Informação de Documentos e copiá-las novamente. Quando terminar, selecione Criar.

      Captura de tela da janela de diálogo do conector de aplicativo lógico

    Observação

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

  4. Você verá a janela de parâmetros de seleção do conector Analisar Documento para Modelos Predefinidos ou Personalizados (API v3.0).

    Captura de tela da janela seleção de modelo predefinido.

  5. Preencha os campos da seguinte maneira:

    • Identificador de modelo. Especifique qual modelo você deseja chamar. Nesse caso, estamos chamando o modelo de fatura predefinido, portanto, insira fatura predefinida.

    • Conteúdo do arquivo de documento/imagem. Selecione esse campo. Um pop-up de conteúdo dinâmico será exibido. Caso contrário, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Conteúdo do arquivo. Essa etapa está basicamente enviando os arquivos a serem analisados para o modelo de fatura predefinido da Informação de Documentos. Depois de ver a notificação de Conteúdo do arquivo mostrada no campo Conteúdo do Documento/Arquivo de Imagem, você terá concluído essa etapa corretamente.

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

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

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

  6. Precisamos adicionar mais algumas etapas. Mais uma vez, selecione o botão ➕ Nova etapa para adicionar outra ação.

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

    Captura de tela do bloco de controle do menu Escolher uma operação.

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

    Captura de tela do bloco Para cada controle no menu Controle

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

    Captura de tela da lista de conteúdo dinâmico.

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

  11. Na barra de pesquisa Escolher uma operação, insira Outlook e selecione Outlook.com (pessoal) ou Office 365 Outlook (profissional).

  12. Na lista de ações, role para baixo até encontrar Enviar um email (v2) e selecione essa ação.

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

  13. Assim como ocorre com o OneDrive, você será solicitado a entrar na conta Outlook ou Office 365 Outlook. Depois de entrar, você verá uma janela em que vamos formatar o email com o conteúdo dinâmico que a Inteligência de Documentos extrai da fatura.

  14. Vamos usar a seguinte expressão para concluir 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 tela do campo 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 desejamos extrair. Para obter a lista completa de campos disponíveis, consulte a página de conceito para a API fornecida. Nesse caso, usamos os valores de extração de campo do modelo de fatura predefinido.

  17. Estamos quase lá. Faça as seguintes alterações nos seguintes campos:

    • Para. Insira o endereço de email pessoal ou comercial ou qualquer outro endereço de email a que você tenha acesso.

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

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

      • Digite ID da Fatura: e, usando o mesmo método de antes, acrescente a seguinte expressão:

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

        
          items('For_each')?['fields']?['DueDate']?['content']
        
      • Insira o Valor devido: e acrescente a seguinte expressão:

        
          items('For_each')?['fields']?['AmountDue']?['content']
        
      • Por fim, como o valor devido é um número importante, também convém enviar a pontuação de confiança para essa extração no email. Para fazer isso, digite o Valor 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 tela da janela Enviar um email (v2) com os campos completos.

  18. No canto superior esquerdo, selecione Salvar.

    Captura de tela da tela do botão salvar do designer de Aplicativos Lógicos.

Observação

  • Essa versão atual retorna apenas uma única fatura por PDF.
  • O loop “For each" é necessário em torno da ação enviar email para habilitar um formato de saída que pode retornar mais de uma fatura de PDFs no futuro.
  1. Em seguida, adicionaremos uma nova etapa ao fluxo de trabalho. Selecione o botão ➕ Nova etapa no nó do OneDrive recém-criado.

  2. Um novo nó deverá é adicionado à exibição do designer do Aplicativo Lógico. Pesquise "Reconhecimento de Formulários (Inteligência de Documentos em breve)" na barra de pesquisa Escolher uma operação e selecione Analisar fatura na lista.

    Captura de tela da ação Analisar fatura.

  3. Agora você vê uma janela para criar a conexão. Especificamente, você conectará o recurso de Reconhecimento de Formulários ao Estúdio do Designer dos Aplicativos Lógicos:

    • Insira um Nome de conexão. Deve ser algo fácil de lembrar.
    • Insira a URL do ponto de extremidade do recurso de Reconhecimento de Formulários e a Chave de Conta copiada anteriormente. Se você ignorou essa etapa anteriormente ou perdeu as cadeias de caracteres, poderá navegar de volta para o recurso de Reconhecimento de Formulários e copiá-las novamente. Quando terminar, selecione Criar.

    Captura de tela da janela de diálogo do conector de aplicativo lógico.

    Observação

    Se você já fez logon com suas credenciais, a etapa anterior será ignorada. Continue concluindo 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 maneira:

    • Conteúdo do arquivo de documento/imagem. Selecione esse campo. Um pop-up de conteúdo dinâmico será exibido. Caso contrário, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Conteúdo do arquivo. Essa etapa está basicamente enviando os arquivos a serem analisados para o modelo de fatura predefinido da Informação de Documentos. Depois de ver a notificação de Conteúdo do arquivo mostrada no campo Conteúdo do Documento/Arquivo de Imagem, você terá concluído essa etapa corretamente.
    • URL do documento/imagem. Ignore esse campo para esse projeto porque já estamos apontando para o conteúdo do arquivo diretamente da pasta do OneDrive.
    • Incluir Detalhes do Texto. Selecione Sim.
    • Adicionar novo parâmetro. Ignore esse campo para esse projeto.
  6. Precisamos adicionar a última etapa. Mais uma vez, selecione o botão ➕ Nova etapa para adicionar outra ação.

  7. Na barra de pesquisa Escolher uma operação, insira Outlook e selecione Outlook.com (pessoal) ou Office 365 Outlook (profissional).

  8. Na lista de ações, role para baixo até encontrar Enviar um email (v2) e selecione essa ação.

  9. Entre em sua conta do Outlook ou do Outlook do Office 365. Feito isso, você verá uma janela onde vamos formatar o e-mail a ser enviado com o conteúdo dinâmico extraído da fatura.

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

  10. Estamos quase lá. Digite as seguintes entradas nos campos:

    • Para. Insira o endereço de email pessoal ou comercial ou qualquer outro endereço de email a que você tenha acesso.

    • Assunto. Insira a Fatura recebida de: e, em seguida, anexe o nome do Fornecedor no campo Nome do fornecedor do conteúdo dinâmico.

    • Corpo. Adicionaremos as informações específicas sobre a fatura:

      • Digite ID da fatura: e acrescente a ID da fatura no campo ID da fatura do conteúdo dinâmico.

      • Em uma nova linha, digite Data de vencimento da fatura: e acrescente a data da fatura (data) no campo Data da fatura do conteúdo dinâmico.

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

      • Por fim, como o valor devido é um número importante, também convém enviar a pontuação de confiança para essa extração no email. Para fazer isso, digite Valor devido (confiança): e adicione a confiança do valor devido no campo Valor devido do conteúdo dinâmico. Quando você terminar, a janela será semelhante à imagem a seguir.

      Captura de tela dos campos completos do Outlook.

      Dica

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

  11. No canto superior esquerdo, selecione Salvar.

    Captura de tela da tela do botão salvar do designer de Aplicativos Lógicos.

    Observação

    • Essa versão atual retorna apenas uma única fatura por PDF.
    • O loop “For each" em torno da ação enviar email habilita um formato de saída que pode retornar mais de uma fatura de PDFs no futuro.

Pré-requisitos

Para concluir este tutorial, você precisará dos seguintes recursos:

  • Uma assinatura do Azure. Você pode criar uma assinatura gratuita do Azure

  • Acesso ao site do SharePoint.

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

  • Uma fatura de exemplo para testar o Aplicativo Lógico. Você pode baixar e usar nosso documento de fatura de exemplo para este tutorial.

  • Um recurso da Informação de Documentos. Depois de obter sua assinatura do Azure, crie um recurso da Informação de Documentos no portal do Azure para obter a chave e o ponto de extremidade. Se você tiver um recurso de Informação de Documento existente, navegue diretamente para a página de recursos. Use o tipo de preço gratuito (F0) para experimentar o serviço e atualizar mais tarde para um nível pago para produção.

    • Após a implantação do recurso, selecione Ir para o recurso. Copie os valores de recursos em Chaves e Ponto de Extremidade do portal do Azure e cole-os em um local viável, como o Bloco de Notas Microsoft. Você precisa dos valores de chave e ponto de extremidade para conectar o aplicativo à API da Informação de Documentos. Para obter mais informações, consulteCriar um recurso de Informação de Documentos.

      Captura de tela mostrando como acessar a chave de recurso e a URL do ponto de extremidade.

Como criar uma pasta do SharePoint

Antes de entrarmos na criação do 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 próximo ao canto superior esquerdo da janela do site e escolha Pasta.

    Captura de tela da opção Adicionar novo botão.

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

    Captura de tela da janela de criação e nome da pasta.

  4. Sua nova pasta está localizada em sua biblioteca de sites.

    Captura de tela da pasta recém-criada.

  5. Terminamos com o SharePoint por enquanto.

Como criar recurso de Aplicativo Lógico

A essa altura, você deve ter um recurso de Inteligência de Documentos e uma pasta do OneDrive com tudo pronto. Agora, chegou a hora de criar um recurso de Aplicativo Lógico.

  1. Navegue até o Portal do Azure.

  2. Na página inicial do Azure, selecione ➕ Criar um recurso.

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

  3. Procure e escolha Aplicativo Lógico na barra de pesquisa.

  4. Selecionar o botão Criar

    Captura de tela da página Criar Aplicativo lógico.

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

    • Assinatura. Selecione a assinatura atual.
    • Grupo de recursos. O grupo de recursos do Azure que contém o seu recurso. Escolha o mesmo grupo de recursos que você tem para o recurso de Informação de Documentos.
    • Type. Selecione Consumo. O tipo de recurso de Consumo é executado em Aplicativos Lógicos do Azure globais e multilocatário, e usa o modelo de cobrança de Consumo.
    • Nome do Aplicativo Lógico. Insira um nome para o recurso. Recomendamos o uso de um nome descritivo, por exemplo, YourNameLogicApp.
    • Publicação. Selecione Fluxo de Trabalho.
    • Região. Selecione a região local.
    • Habilitar o Log Analytics. Para este projeto, selecione Não.
    • Tipo de Plano. Selecione Consumo. O tipo de recurso de Consumo é executado em Aplicativos Lógicos do Azure globais e multilocatário, e usa o modelo de cobrança de Consumo.
    • Redundância de Zona. Selecione desabilitado.
  6. Quando terminar, você terá algo semelhante a seguinte imagem (o grupo de recursos, o nome do Aplicativo Lógico e a Região podem ser diferentes). Depois de verificar esses valores, selecione Examinar e criar no canto inferior esquerdo.

    Captura de tela mostrando os valores de campo para criar um recurso de aplicativo lógico.

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

  8. A seguir você será redirecionado para uma tela informando que a Implantação está em andamento. Aguarde a implantação do Azure. Pode levar alguns minutos. Depois que a implantação for concluída, você verá uma faixa informando que A implantação foi concluída. Ao acessar essa tela, selecione Ir para o recurso.

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

    Captura de tela mostrando como entrar no Designer de Aplicativo Lógico.

  10. Você verá uma tela semelhante à imagem a seguir. Agora, você está pronto para começar a criar e implementar o Aplicativo Lógico.

    Captura de tela da página inicial do Designer de Aplicativo Lógico.

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

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

  12. Os Aplicativos Lógicos conecta você automaticamente à sua conta do SharePoint.

  13. Depois que sua conta estiver conectada, conclua 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.

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

    Captura de tela do campo de parâmetro adicionado.

    Dica

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

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

  2. Pesquise e selecione SharePoint na barra de pesquisa. Localize e selecione a ação Obter conteúdo do arquivo.

  3. Preencha os campos da seguinte maneira:

    • Endereço do Site. Seu endereço do site do SharePoint.
    • Identificador do arquivo. Selecione esse campo. Um pop-up de conteúdo dinâmico será exibido. Caso contrário, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Identificador.
    • Inferir o Tipo de Conteúdo. Selecione Sim.

    Captura de tela do nó Obter Conteúdo do Arquivo.

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

  5. Um novo nó deverá é adicionado à exibição do designer do Aplicativo Lógico. Pesquise por Reconhecimento de Formulários (Inteligência de Documentos em breve) na barra de pesquisa Escolher uma operação e selecione Analisar Documento para modelos predefinidos ou personalizados (API v3.0) na lista.

    Captura de tela do botão de seleção Analisar Documento para modelos predefinidos ou personalizados (API v3.0)

  6. Agora você vê uma janela para criar a conexão. Especificamente, você conectará o recurso de Informação de Documentos ao Estúdio do Designer dos Aplicativos Lógicos:

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

    • Insira a URL do ponto de extremidade do recurso de Informação de Documentos e a Chave de Conta copiada anteriormente. Se você ignorou essa etapa anteriormente ou perdeu as cadeias de caracteres, poderá navegar de volta para o recurso de Informação de Documentos e copiá-las novamente. Quando terminar, selecione Criar.

      Captura de tela da janela de diálogo do conector de aplicativo lógico

    Observação

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

  7. Você verá a janela de parâmetros de seleção do conector Analisar Documento para Modelos Predefinidos ou Personalizados (API v3.0).

    Captura de tela da janela seleção de modelo predefinido.

  8. Preencha os campos da seguinte maneira:

    • Identificador de modelo. Especifique qual modelo você deseja chamar. Nesse caso, estamos chamando o modelo de fatura predefinido, portanto, insira fatura predefinida.
    • Conteúdo do arquivo de documento/imagem. Selecione esse campo. Um pop-up de conteúdo dinâmico será exibido. Caso contrário, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Conteúdo do arquivo. Essa etapa está basicamente enviando os arquivos a serem analisados para o modelo de fatura predefinido da Informação de Documentos. Depois de ver a notificação de Conteúdo do arquivo mostrada no campo Conteúdo do Documento/Arquivo de Imagem, você terá concluído essa etapa corretamente.
    • URL do documento/imagem. Ignore esse campo para esse projeto porque já estamos apontando para o conteúdo do arquivo diretamente da pasta do OneDrive.
    • Adicionar novo parâmetro. Ignore esse campo para esse projeto.
  9. Precisamos adicionar mais algumas etapas. 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 de Operação.

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

    Captura de tela do bloco Para cada controle no menu Controle

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

    Captura de tela da lista de conteúdo dinâmico.

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

  14. Na barra de pesquisa Escolher uma operação, insira Outlook e selecione Outlook.com (pessoal) ou Office 365 Outlook (profissional).

  15. Na lista de ações, role para baixo até encontrar Enviar um email (v2) e selecione essa ação.

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

  16. Entre em sua conta do Outlook ou do Outlook do Office 365. Depois de entrar, você verá uma janela em que vamos formatar o email com o conteúdo dinâmico que a Informação de Documentos extrai da fatura.

  17. Vamos usar a seguinte expressão para concluir 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 tela do campo 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 desejamos extrair. Para obter a lista completa de campos disponíveis, consulte a página de conceito para a API fornecida. Nesse caso, usamos os valores de extração de campo do modelo de fatura predefinido.

  20. Estamos quase lá. Faça as seguintes alterações nos seguintes campos:

    • Para. Insira o endereço de email pessoal ou comercial ou qualquer outro endereço de email a que você tenha acesso.

    • Assunto. Insira a 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 tela do campo expressão de fórmula.

      Captura de tela do selo expressão de fórmula.

    • Corpo. Adicionaremos as informações específicas sobre a fatura:

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

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

        
          items('For_each')?['fields']?['DueDate']?['content']
        
      • Insira o Valor devido: e acrescente a seguinte expressão:

        
          items('For_each')?['fields']?['AmountDue']?['content']
        
      • Por fim, como o valor devido é um número importante, também convém enviar a pontuação de confiança para essa extração no email. Para fazer isso, digite o Valor 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 tela da janela Enviar um email (v2) com os campos completos.

  21. No canto superior esquerdo, selecione Salvar.

    Captura de tela da tela do botão salvar do designer de Aplicativos Lógicos.

Observação

  • Essa versão atual retorna apenas uma única fatura por PDF.
  • O loop “For each" é necessário em torno da ação enviar email 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 nó Para cada será semelhante à imagem a seguir:

Captura de tela da tela Para cada nó após o aplicativo ter sido salvo.

  1. Pesquise e selecione SharePoint na barra de pesquisa. Localize e selecione a ação Obter conteúdo do arquivo.

  2. Preencha os campos da seguinte maneira:

    • Endereço do Site. Seu endereço do site do SharePoint.
    • Identificador do arquivo. Selecione esse campo. Um pop-up de conteúdo dinâmico será exibido. Caso contrário, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Identificador.
    • Inferir o Tipo de Conteúdo. Selecione Sim.

    Captura de tela do nó Obter Conteúdo do Arquivo.

  3. Em seguida, adicionaremos uma nova etapa ao fluxo de trabalho. Selecione o botão ➕ Nova etapa no nó do SharePoint recém-criado.

  4. Um novo nó deverá é adicionado à exibição do designer do Aplicativo Lógico. Pesquise "Reconhecimento de Formulários (Informação de Documentos em breve)" na barra de pesquisa Escolher uma operação e selecione Analisar fatura na lista.

    Captura de tela da ação Analisar fatura.

  5. Agora você vê uma janela para criar a conexão. Especificamente, você conectará o recurso de Reconhecimento de Formulários ao Estúdio do Designer dos Aplicativos Lógicos:

    • Insira um Nome de conexão. Deve ser algo fácil de lembrar.
    • Insira a URL do ponto de extremidade do recurso de Reconhecimento de Formulários e a Chave de Conta copiada anteriormente. Se você ignorou essa etapa anteriormente ou perdeu as cadeias de caracteres, poderá navegar de volta para o recurso de Reconhecimento de Formulários e copiá-las novamente. Quando terminar, selecione Criar.

    Captura de tela da janela de diálogo do conector de aplicativo lógico.

    Observação

    Se você já fez logon com suas credenciais, a etapa anterior será ignorada. Continue concluindo 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 os campos da janela de análise de fatura.

  7. Preencha os campos da seguinte maneira:

    • Conteúdo do arquivo de documento/imagem. Selecione esse campo. Um pop-up de conteúdo dinâmico será exibido. Caso contrário, selecione o botão Adicionar conteúdo dinâmico abaixo do campo e escolha Conteúdo do arquivo. Essa etapa está basicamente enviando os arquivos a serem analisados para o modelo de fatura predefinido da Informação de Documentos. Depois de ver a notificação de Conteúdo do arquivo mostrada no campo Conteúdo do Documento/Arquivo de Imagem, você terá concluído essa etapa corretamente.
    • URL do documento/imagem. Ignore esse campo para esse projeto porque já estamos apontando para o conteúdo do arquivo diretamente da pasta do OneDrive.
    • Incluir Detalhes do Texto. Selecione Sim.
    • Adicionar novo parâmetro. Ignore esse campo para esse projeto.

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

  8. Precisamos adicionar a última etapa. Mais uma vez, selecione o botão ➕ Nova etapa para adicionar outra ação.

  9. Na barra de pesquisa Escolher uma operação, insira Outlook e selecione Outlook.com (pessoal) ou Office 365 Outlook (profissional).

  10. Na lista de ações, role para baixo até encontrar Enviar um email (v2) e selecione essa ação.

  11. Entre em sua conta do Outlook ou do Outlook do Office 365. Feito isso, você verá uma janela onde vamos formatar o e-mail a ser enviado com o conteúdo dinâmico extraído da fatura.

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

  12. Estamos quase lá. Digite as seguintes entradas nos campos:

    • Para. Insira o endereço de email pessoal ou comercial ou qualquer outro endereço de email a que você tenha acesso.

    • Assunto. Insira a Fatura recebida de: e, em seguida, anexe o nome do Fornecedor no campo Nome do fornecedor do conteúdo dinâmico.

    • Corpo. Adicionaremos as informações específicas sobre a fatura:

      • Digite ID da fatura: e acrescente a ID da fatura no campo ID da fatura do conteúdo dinâmico.

      • Em uma nova linha, digite Data de vencimento da fatura: e acrescente a data da fatura (data) no campo Data da fatura do conteúdo dinâmico.

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

      • Por fim, como o valor devido é um número importante, também convém enviar a pontuação de confiança para essa extração no email. Para fazer isso, digite Valor devido (confiança): e adicione a confiança do valor devido no campo Valor devido do conteúdo dinâmico. Quando você terminar, a janela será semelhante à imagem a seguir.

      Captura de tela dos campos completos do Outlook.

      Dica

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

  13. No canto superior esquerdo, selecione Salvar.

    Captura de tela da tela do botão salvar do designer de Aplicativos Lógicos.

    Observação

    • Essa versão atual retorna apenas uma única fatura por PDF.
    • O loop “For each" em torno da ação enviar email habilita um formato de saída que pode retornar mais de uma fatura de PDFs no futuro.

Testar o fluxo de automação

Vamos examinar rapidamente o que concluímos antes de testar nosso fluxo:

  • Criamos um gatilho nesse cenário. O gatilho é quando um arquivo é criado em uma pasta predeterminada em nossa conta OneDrive.
  • Adicionamos uma ação da Informação de Documentos ao nosso fluxo. Nesse cenário, decidimos usar a API da fatura para analisar automaticamente uma fatura da pasta do OneDrive.
  • Adicionamos uma ação do 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, falta testá-lo e verificar se estamos obtendo o comportamento esperado.

  1. Para testar o Aplicativo Lógico, primeiro abra uma nova guia e navegue até a pasta do OneDrive configurada no início deste tutorial. Adicione esse arquivo à Fatura de exemplo da pasta do OneDrive.

  2. Volte à guia de designer do Aplicativo Lógico e selecione o botão Executar gatilho e 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 Gatilho bem-sucedido.

  4. Navegue até a página de visão geral do Aplicativo Lógico selecionando o link do nome do aplicativo no canto superior esquerdo.

    Captura de tela da navegação para o link da página de 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 tela do status Bem-sucedido ou Falhou.

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

    Captura de tela da etapa com falha.

  7. Após a execução bem-sucedida de um fluxo de trabalho, verifique seu email. Há um novo email com as informações especificadas.

    Captura de tela da mensagem de email recebida.

  8. Quando terminar, desabilite ou exclua seu aplicativo lógico para que o uso seja interrompido.

    Captura de tela dos botões desabilitar e exluir.

Parabéns! Você concluiu este tutorial.

Próximas etapas