Construir um bot para fazer upload de documentos no Automação de documento

Construa um bot para fazer upload de documentos para uma instância de aprendizagem específica para processamento e extração.

Pré-requisitos

  • Certifique-se de ter o nome da instância de aprendizagem de destino.
  • Se você tiver uma quantidade adequada de Executores de bots conectados. Para instruções sobre como conectar um Bot Runner, consulte a etapa 5 de Configurar seu ambiente do Automação de documento.
    Nota: Você precisa de um Bot Runner dedicado para esse bot e Executores de bots adicionais para os bots de extraction e download, dependendo do número médio de páginas nos documentos. Revise a explicação abaixo para obter mais orientações sobre quantos Executores de bots são necessários.
  • Decida qual será o intervalo de programação para a implantação desse bot com um intervalo máximo a cada trinta minutos.
  • Determine o número médio de páginas nos documentos que aguardam o upload.
Esse bot é necessário para a automação de ponta a ponta do processo de extração de documentos. Quando implantado, o bot verifica se há Executores de bots suficientes para tratar os documentos, comparando o número de arquivos já carregados com um valor calculado. O cálculo considera o número de Executores de bots, o intervalo de programação e o número médio de páginas nos documentos.
Nota: Essa etapa é importante, pois controla o número de documentos que estão sendo carregados para garantir processamento tranquilo e evitar sobrecarregar os Executores de bots, o que pode causar um erro de tempo limite.
Para determinar o número de Executores de bots necessários, considere o seguinte:
  • Um Bot Runner pode processar um documento de uma página em um minuto.
  • Um Bot Runner pode processar um documento de duas páginas em dois minutos.
  • Um Bot Runner pode processar um documento de uma página 1440 em um minuto.
  • Dois Executores de bots podem processar dois documentos de uma página em um minuto.
Use esta equação para determinar quantos Executores de bots são necessários:
Number of Documents to Process per day * Average Number of Pages per document / 1440 = Number of Executores de bots
Nota: Se o resultado da equação não for um número inteiro, você deve arredondar para o número inteiro seguinte para obter um número adequado de Executores de bots. Por exemplo, se o resultado da equação for 4,2, serão necessários 5 Executores de bots.
Como exemplo, se você quiser processar 10.000 documentos por dia com uma média de uma página por documento, você precisa de sete Executores de bots:
10,000 documents * 1 page per document / 1440 = 7 Executores de bots

Procedimento

Para construir o bot, siga estas etapas:

  1. Navegue até Automação > Guia Privado e clique em Criar um bot.
    Não coloque o bot na pasta Espaço de trabalho para documentos.
  2. Forneça um nome para o bot, por exemplo, Extraction-Scheduler.
  3. Crie as seguintes variáveis: Criar uma variável
    Nome da variável Descrição Tipo de dados Valor
    File_Count Aumenta com cada iteração de loop para contar o número de arquivos carregados para processamento. Número 0
    Extraction_DeviceCount Número de dispositivos Bot Runner conectados à Control Room Número Digite o número de dispositivos Bot Runner conectados
    Scheduler_Interval Intervalo de programação em minutos Número Digite o intervalo para o qual você programará esse bot para funcionar ao implantá-lo (no mínimo, 2 min, no máximo, 30 min)
    Average_Pages Número médio de páginas por documento Digite o número médio aproximado de páginas nos documentos
    FilesInFolder Possui nome de arquivo e extensão Dicionário --
    SourcePath Caminho do arquivo para a pasta contendo documentos que aguardam upload para o Automação de documento String Insira o caminho do arquivo
    OutputPath Caminho do arquivo para a pasta que contém os dados extraídos e documentos inválidos ou com falha String Digite o caminho do arquivo onde você deseja a saída de extração
  4. Insira uma ação Loop para iterar através de todos os documentos em um caminho de arquivo específico.
    1. Clique duas vezes ou arraste a ação do Loop.
    2. Selecione o iterador Para cada arquivo na pasta.
    3. Insira a variável SourcePath no campo Caminho da pasta.
    4. Insira a variável FilesInFolder no campo Atribuir nome de arquivo e extensão a esta variável.
  5. Insira uma ação Se para comparar o número de documentos carregados para processamento com o número de dispositivos Bot Runner multiplicados por um intervalo de programação e divididos pelo número médio de páginas.
    Nota: Você deve incluir essa equação para limitar o número de arquivos carregados para processamento ao mesmo tempo e garantir que os Executores de bots sejam capazes de processar os documentos.
    1. Arraste a ação Se no recipiente do Loop.
    2. Selecione a condição Número.
    3. Insira a variável File_Count no campo Valor da fonte.
    4. Selecione o operador Menos de.
    5. Digite o seguinte no campo Valor de destino: $Extraction_DeviceCount$*$Scheduler_Interval$/$Average_Pages$
  6. Insira Se: Senão e Loop: Interrupção ações para terminar o loop se a condição não for atendida:
    1. Arraste o Se: Senão ação ao lado de Se ação no recipiente do Loop .
    2. Arraste o Loop: Interrupção ação no Se: Recipiente Senão.
  7. Insira um mecanismo de tratamento de erros para registrar quaisquer possíveis erros:
    1. Arraste o Gerenciador de erros: Testar ação no recipiente Se .
    2. Arraste o Gerenciador de erros: Capturar ação ao lado de Gerenciador de erros: Tentar ação.
    3. Arraste uma ação Atrasar abaixo do Gerenciador de erros: Capturar ação.
    4. Defina um atraso de 10 segundos.
  8. Configure ações para carregar documentos para o processo associado a uma instância de aprendizagem específica.
    1. Arraste o Process Composer: Criar uma solicitaçãoação abaixo do Gerenciador de erros: Tentar ação.
      Nota: Você está apontando para um caminho de processo público que Automação de documento cria de forma automática. Por exemplo, consulte a seguinte imagem:
      Process-Composer-Public-Processor
    2. Marque a opção Definir LearningInstanceName e forneça o nome da instância de aprendizagem para onde enviar os documentos.
    3. Marque a opção Definir InputFile e insira $SourcePath$/$FilesInFolder{name}$.$FilesInFolder{extension}$.
    4. Marque a opção Definir InputFileName e insira $FilesInFolder{name}$.$FilesInFolder{extension}$.
    5. Marque a opção Definir OutputFolder e insira $OutputPath$.
    6. Arraste o Número: Incremento abaixo do Process Composer: Criar uma solicitaçãoação ação.
    7. Insira a variável File_Count nos campos Número e Atribuir saída à variável.
      A ação Número aumenta o valor de File_Count em um cada vez que um arquivo é carregado na instância de aprendizagem. Desde que o valor em File_Count seja menor do que o total na equação que você inseriu na etapa 5, o bot pode executar outra iteração de loop para carregar outro documento para a instância de aprendizagem.
  9. Faça uma cópia do arquivo carregado para um local diferente em sua área de trabalho para acompanhar quais documentos foram carregados com sucesso:
    1. Arraste o Arquivo: Copiar arquivo de desktop ação abaixo do Número: Incrementar ação.
    2. Insira $SourcePath$/$FilesInFolder{name}$.$FilesInFolder{extension}$ no campo Arquivo de origem.
    3. Forneça o caminho da pasta onde copiar os arquivos.
  10. Remova os documentos após serem carregados no Automação de documento para que não sejam recarregados na próxima iteração:
    1. Arraste o Arquivo: Excluir ação.
    2. Insira $SourcePath$/$FilesInFolder{name}$.$FilesInFolder{extension}$ no campo Arquivo.
  11. Clique em Salvar.

O bot concluído deve ser parecido com o da imagem abaixo:

Captura de tela do bot concluído

Próximas etapas

Publique o processo e o bot. Veja a etapa 3 de Publicar a instância de aprendizado para produção