Intelligent Form Extractor

UiPath.IntelligentOCR.Activities.DataExtraction.IntelligentFormExtractor

Description

Importante:

A atividade Intelligent Form Extractor está obsoleta e fora de suporte. Foi removida do seu respectivo pacote, o que significa que você só pode usá-lo em fluxos de trabalho onde foi adicionado anteriormente antes dessa descontinuação.

Embora os fluxos de trabalho que contêm a atividade Intelligent Form Extractor continuem a funcionar normalmente, você não pode adicionar a atividade a novos fluxos de trabalho. Recomendamos usar a atividade Form Extractor .

Analisa, extrai, corresponde e relata as informações necessárias de um documento, levando em consideração a posição das palavras, incluindo campos manuscritos e assinados. Esta atividade só pode ser usada em conjunto com a atividade Data Extraction Scope.

Observação:

Use os seguintes recursos para definir e configurar seu Intelligent Form Extractor:

• Assistente do Gerenciador de modelos;
• Gerenciador de taxonomia;
• Configuração e definição de âncoras .

Compatibilidade do projeto

Windows-Legacy | Windows

Propriedades

Painel de Propriedades

Comum

• DisplayName - O nome de exibição da atividade.

Entrada

• ApiKey - Specifies the API key of the account.
• Endpoint - O URL para o servidor UiPath®. Por padrão, o ponto de extremidade é https://du.uipath.com/svc/intelligentforms. Para obter mais informações, acesse Endpoints públicos do Document Understanding.
• MinOverlapPercentage - Specifies the minimum overlap area (in percentage) between a box in the document and a box in the template required to make an extraction. The percentage value can be set between 0 and 100. The default value is 65.
• Timeout - Specifies the amount of time (in milliseconds) to wait for a response from the server before an error is thrown. The default value is 100000 milliseconds (100 seconds).

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

  Importante:

  Ao usar a versão baseada em nuvem deste software de extração de dados de documentos com qualquer Chave de API da Comunidade da UiPath®, os documentos processados com o software são armazenados e usados pela UiPath® junto com quaisquer dados pessoais que eles possam conter para monitoramento de serviço. Os documentos processados usando qualquer ponto de extremidade de servidor UiPath® com chaves de API Enterprise não são armazenados pela UiPath®. Nenhum documento é processado pela UiPath® se o software for configurado e usado em seu local.

  Observação:

  Depois que um modelo é criado, a atividade pode exibir um aviso informando que o número permitido de áreas manuscritas permitidas em uma página pode ter sido excedido.

  O fluxo de trabalho ainda pode ser executado e um erro é gerado apenas se o número de áreas manuscritas tiver sido realmente excedido (mais de 60/página).

Assistente do Gerenciador de modelos

Permite criar, editar, gerenciar e exportar/importar modelos para os tipos de documentos definidos na taxonomia.

Criar um modelo

• Add an Intelligent Form Extractor activity to your workflow, within a Data Extraction Scope.

• Configure o extrator selecionando Gerenciar modelos. A janela Gerenciador de modelos é exibida.

  Figura 1. Visão geral do assistente Gerenciador de modelos

  

• Selecione Criar modelo para criar um novo modelo. Figura 2. Visão geral do assistente Criar modelo

  

  Observação:

  Se o pacote UiPath.IntelligentOCR.Activities for atualizado para a v5.1.0, em seguida, o parâmetro ForçarAplicaçãoDeOCR foi substituído pelo ApplyOcrOnPDF. Aqui está a compatibilidade entre os parâmetros antigos e novos:

  • ForçarAplicaçãoDeOCR = True é substituído por ApplyOcrOnPDF = Yes;
  • ForçarAplicaçãoDeOCR = False é substituído por ApplyOcrOnPDF = Auto;
  • ForçarAplicaçãoDeOCR = Empty é substituído por ApplyOcrOnPDF = Auto;
  • ForçarAplicaçãoDeOCR = <user-defined variable> é substituído por ApplyOcrOnPDF = Auto.

• Select the document type for your template from the Document Type dropdown list.

  Observação:

  All Document Types are based on the Taxonomy. Make sure to add or create a taxonomy inside the project's folder.

• Add the name of the template in the Template name field. Choose a relevant name that reflects the version or the layout of your document.

• Add the document's path in the Template document field.

• Navigate to the file's path by using the Browse button.

• Selecione um OCR na lista suspensa Mecanismo de OCR e configure de acordo com suas necessidades.

• Selecione Configurar para disparar a edição do modelo. A opção Aplicar OCR em PDF estabelece se o processo de OCR deve ser aplicado ou não aos documentos de PDF. Três opções estão disponíveis na lista suspensa: True, False e Auto. Se definido como True, o OCR é aplicado a todas as páginas PDF do documento. Se definido como False, apenas o texto inserido digitalmente é extraído. O valor padrão é Auto, determinando se o documento requer a aplicação do algoritmo OCR dependendo do documento de entrada. Cada mecanismo de OCR vem com seu próprio conjunto de opções personalizadas. Acesse Mecanismos de OCR para obter mais detalhes sobre todas as opções disponíveis para cada mecanismo de OCR. Se você já criou um modelo, ele pode ser editado, exportado ou removido. As opções Excluir e Exportar ficam disponíveis apenas quando pelo menos um modelo é selecionado. As opções Editar e Remover para um modelo individual estão sempre disponíveis.

Figura 3. Exemplo de um modelo configurado no assistente Gerenciador de modelos

Observação:

Se um campo for marcado nas caixas Assinatura e Escrito manualmente nas caixas Gerenciador de modelos da atividade Intelligent Form Extractor , uma mensagem pop-up aparecerá informando que um campo pode ser adicionado apenas em uma caixa, não ambas.

Configurando o processamento de campo booleano

Para documentos que incluem caixas de seleção, você pode adicionar sinônimos conhecidos para as opções Sim e Não, ou você pode começar a partir de uma lista compilada por nós (consulte as sugestões de Adicionar recomendado). Esses valores são usados para interpretação de conteúdo booleano, que mapeia um valor capturado para um valor Sim ou Não reportado.

Ao lado de Sinônimo para Sim e Sinônimo para Não, selecione Adicionar recomendado para gerar as sugestões.

Figura 4. Imagem animada mostrando a seleção de Adicionar recomendado e geração de sugestões.

Observação:

A caixa de seleção Diferenciação de maiúsculas e minúsculas precisa ser verificada se os sinônimos que você adicionou forem sensíveis a maiúsculas e minúsculas.

Exportando e importando modelos

You can import templates created and exported from other workflows. Use these features to share templates between projects. Once a document type is configured using the Intelligent Form Extractor, you don't need to reconfigure the templates in a new implementation.

Procedimento de exportação

Essas são as etapas que você precisa seguir para exportar um modelo:

1. Crie um ou mais modelos seguindo as etapas explicadas no início desta página.

2. Selecione os modelos que deseja exportar.

3. Selecione uma opção Exportar :

   1. Exportar com arquivos originaisA exportação com arquivos originais os anexa à exportação.

   2. Exportar sem arquivos originais

      Figura 5. As opções Exportar disponíveis no assistente Gerenciador de modelos

      

4. Salve o arquivo do modelo com o nome desejado.

5. Uma mensagem é exibida assim que o modelo é salvo. Selecione OK.

   Figura 6. A mensagem "Modelo(s) X" exportado com sucesso"

   

   Observação:

   Se você não puder compartilhar o conteúdo dos documentos nos quais você criou seus modelos, use a opção Exportar sem arquivos originais. Você ainda pode compartilhar e importar o arquivo de modelo em outros projetos, mas não pode mais editá-los ou visualizá-los.

   Se você quiser editar os modelos uma vez importados em um projeto diferente, certifique-se de usar a opção Exportar com arquivos originais ao exportar e, em seguida, importá-los.

Procedimento de importação

Aqui estão as etapas que você precisa seguir para importar um modelo:

1. Selecionar Import.

   Figura 7. A ação de selecionar Importar

   

2. Selecione um arquivo. O assistente de importação aparece e apresenta todos os tipos de documentos e todos os modelos disponíveis no arquivo de exportação selecionado. Selecione os modelos que você deseja importar e escolha a opção Importar direita:

   1. Importar com arquivos originais

   2. Importar sem arquivos originaisFigura 8. As opções Importar disponíveis no assistente Gerenciador de modelos

      

      Observação:

      • Quando os modelos são importados, os tipos de documento são criados automaticamente na Taxonomia do projeto. Se já existir um tipo de documento com o mesmo nome, outro será criado anexando uma contagem ao nome do tipo de documento.
      • Se estiver importando modelos que foram exportados sem os arquivos originais ou se optar por importar modelos sem os arquivos originais, você não terá opções de exibição ou edição para esses modelos.

Situações especiais ao importar um modelo

Quando um modelo é importado, várias situações especiais podem ocorrer. A lista a seguir explica cada tipo de importação e suas especificidades:

• Novo tipo de documento: se um novo tipo de documento for importado, um novo campo será adicionado na configuração do assistente, informando que um novo modelo deve ser criado.

• Tipo de documento duplicado: se um tipo de documento idêntico for importado, a seguinte mensagem de aviso aparecerá: "Esse modelo já existe e será substituído."

• Modelo estendido: se um modelo de tipo de documento que inclui campos extras do que o já existente, for importado, a seguinte mensagem de aviso aparecerá: "Esse tipo de documento será atualizado da seguinte forma: o(s) seguinte(s) campo(s) não existem e serão criado."

• Tipo de documento estendido: se o usuário importar um tipo de documento que inclui campos extras do que o já existente, a seguinte mensagem de aviso aparecerá: "Esse tipo de documento será atualizado da seguinte forma: o(s) seguinte(s) campo(s) não têm configurações a serem importar".

• Tipo de documento com nome idêntico, mas conteúdo diferente: se o usuário importar um tipo de documento que tenha o mesmo nome que o existente, mas campos diferentes, a seguinte mensagem de aviso aparecerá: "Esse tipo de documento será atualizado da seguinte forma":

  • "Os seguintes campos não existem e serão criados"
  • "Os seguintes campos não têm configurações para importar"

• Tipo de documento com tabela ausente: se o usuário importar um tipo de documento que não inclui uma tabela, a seguinte mensagem de aviso aparecerá: "Este tipo de documento será atualizado da seguinte forma: o(s) seguinte(s) campo(s) não possuem configurações para importar."

• Tipo de documento com tabela estendida: se o usuário importar um tipo de documento que inclui uma tabela com colunas extras, a seguinte mensagem de aviso aparecerá: "Este documento será atualizado da seguinte forma: o(s) seguinte(s) campo(s) não existem e serão criados ."

• Tipo de documento com tabela reduzida: se o usuário importar um tipo de documento que inclui uma tabela com colunas ausentes, a seguinte mensagem de aviso aparecerá: "Este documento será atualizado da seguinte forma: o(s) seguinte(s) campo(s) não possuem configurações para importar ".

• Modelo de tabela com diferentes tipos de documentos: se o usuário importar um modelo de tipo de documento que inclui uma tabela com diferentes tipos de documentos, um novo modelo será criado. Se a sua taxonomia incluir uma tabela que tenha um campo com um tipo de documento diferente, a seguinte mensagem será exibida:

  O campo com id xyz foi localizado tanto na taxonomia importada quanto na taxonomia existente, mas seus tipos são incompatíveis (ambos ou nenhum devem ser tabelas).

Assistente do Editor de modelos

Considerações gerais

O Editor de modelo é criado sobre a funcionalidade presente na estação de validação. Para acessá-lo, selecione Editar para um modelo.

Acesse Estação de validação para saber mais sobre o uso básico da Estação de Validação.

Além das opções disponíveis na parte direita da tela Estação de Validação, há as seguintes opções no Editor de modelo:

• : define o modo de seleção de âncora.
• : limpa toda a seleção de âncora

Ao criar um novo modelo, um texto explicativo aparece ao abrir o Editor de modelo. Caso você queira acessar o texto novamente, acesse a seção Visualização de documentos no lado direito, selecione Mais opções e, em seguida, Mostrar texto explicativo.

Figura 9. A ação de mostrar o texto da explicação

Configuração de âncoras

Anchors can be defined once the Template Editor is opened from the Template Manager and can be found among the Selection Mode options.

When defining or editing a page-level template, although it is optional, the first thing that needs to be performed is the Page 1 Matching Info selection. This step is mandatory only for fixed form templates.

Situated on the left side of the screen, the Page 1 Matching Info selection requires a text input (tokens only are accepted) from the first page of the template that is always in the same position within that particular template layout and forms a unique graph of words (considering relative distances and angles between words) across all the templates defined for a particular document type.

In other words, the Page 1 Matching Info (and all other Page Matching Info fields) are "fingerprints" of a particular page and are extensively used in identifying the right matching template at runtime.

For this reason, for the Page 1 Matching Info field, it is strongly recommended to select 10 to 20 words, preferably longer, spread across the entire page area.

The other Page Matching Info fields (one for each template page) must be filled in only if you are attempting data extraction from that particular page, and do not require cross-template uniqueness anymore. If no fields need to be extracted from a particular page, defining the page-level matching info for that page is not mandatory.

Configurando campos simples

For all fields other than Tables, configuring the template consists of selecting a Custom Area and assigning it to a particular field.

For fixed form configurations, data fields can only be configured using Custom Area selections.

Para um campo, você pode definir uma ou mais dessas Áreas personalizadas, usando a opção Adicionar. Se duas ou mais Áreas personalizadas forem definidas para um único campo, no runtime, se o campo for definido na Taxonomia como Valor único, todos os valores serão concatenados em um único valor relatado. Se o campo for definido como Valor múltiplo, cada valor será relatado individualmente.

O ícone ao lado de cada campo indica o tipo de seleção compatível: Tokens ou área personalizada.

Figura 10. Imagem animada mostrando os tipos de seleções compatíveis com campos de amostra

Observação:

If an empty area is selected, the selection is automatically set as Custom area. If text is detected inside the selected area, you are asked to choose the type of the selection between Tokens or Custom area.

Use the Validation Station selection mode feature to lock your selection between Tokens and Custom Areas.

Configurando tabelas

Conforme mencionado acima, há campos nos quais as informações podem ser adicionadas apenas por meio de Tokens (como os campos de Informação de correspondência de página) ou apenas usando uma Área personalizada (como os campos simples). Para campos de tabela, você pode fazer o seguinte:

• Defina cada célula uma por uma, assim que o Editor de tabela for expandido, adicionando seleção Área personalizada a cada célula individualmente.
• Use a funcionalidade de marcação de tabela, marcando a área da tabela, separadores de linha de desenho e coluna e, em seguida, atribuindo a tabela assim marcada ao campo. Certifique-se de que a área extraída tenha o mesmo número de colunas e linhas que a área do modelo.

Para usar a funcionalidade de marcação de tabela:

1. Selecione Mais opções para o campo de tabela
2. Selecione Extrair nova tabela.
3. Selecione a tabela que você deseja extrair.
4. Para cada campo acima de cada coluna de tabela, selecione o nome da coluna que você deseja que ele represente. Você também pode optar por Extrair cabeçalho.
5. Por fim, selecione Salvar nova tabela.

Figura 11. Imagem animada de um exemplo usando a funcionalidade de marcação de tabela

Configuração das âncoras

Um método distinto de definir os limites de uma área personalizada da qual os dados devem ser extraídos é usar âncoras no nível do campo. Isso permite direcionar a extração de dados com base em configurações de nível de campo, possibilitando assim mais flexibilidade ao definir suas regras de extração de formulário.

Consequentemente, no tempo de execução, o Intelligent Form Extractor sabe como realizar o seguinte:

• identificar se um modelo de nível de página corresponde e extrair informações de acordo com a melhor correspondência de modelo de nível de página que ele reconhece;
• identificar se alguma configuração baseada em âncora corresponde e extrair informações de acordo com sua aplicação no documento a ser processado;
• calcule pontuações de confiança apropriadas para todas as correspondências possíveis para poder relatar o melhor resultado (a correspondência de maior probabilidade) de todas as opções disponíveis.

Criando uma nova configuração de âncora

1. Make sure you are in the Anchor Selection mode.

2. Desenhe uma caixa ao redor da área de valor.

3. Selecione um Rótulo (âncora principal) para sua área de valor usando um dos seguintes métodos:

   • Selecione a primeira palavra e, em seguida, use Ctrl + Selectpara a última palavra da seleção.
   • Selecione, arraste e, em seguida, solte para capturar um intervalo de palavras.
     Observação:

     A Label can only contain consecutive words from the same visual line.

4. Selecione qualquer âncora adicional que identificaria exclusivamente seu rótulo. O mesmo princípio de seleção se aplica.

5. Assign your anchor construct to the appropriate field by selecting Extract Value for that particular field.

   Figura 12. Exemplo de criação de várias âncoras para um campo

   

   Observação:

   Você também pode usar os exemplos anteriores desta página para saber como criar um modelo e definir áreas e âncoras de extração.

Edite uma configuração de âncora existente

1. Destaque sua configuração de âncora.

2. Faça alterações (exclua quaisquer âncoras, o rótulo, até mesmo a área de valor, se desejar, adicione novos elementos, etc.).

3. Selecione Mais opções para uma âncora de campo e, em seguida, use a opção Alterar valor extraído para atualizar sua associação de campo. Figura 13. Exemplo de alteração do valor extraído para um campo

   

   Observação:

   • Se você excluir a área de destino, todas as âncoras serão excluídas e o processo deve ser reiniciado.
   • Se você excluir o rótulo (âncora principal), a primeira âncora na ordem em que foi criada se tornará o novo rótulo.

Excluir uma configuração de âncora existente

Para excluir uma configuração de âncora, você pode:

• Selecione Mais opções para uma âncora de campo e use a opção Marcar como Ausente para um valor salvo.

  Figura 14. Exemplo de uso da opção Marcar como ausente para excluir uma configuração de âncora

  

• Selecione Mais opções para uma âncora de campo e use a opção Remover valor, caso de uma lista de âncoras definidas para um determinado campo.

  Figura 15. Exemplo de uso da opção Remover valor para excluir uma configuração de âncora

  

Configurações de combinação e junção

Você pode definir quantos modelos quiser para o mesmo tipo de documento. Você pode ter vários modelos de nível de página, várias âncoras para o mesmo campo, até mesmo modelos contendo âncoras de nível de página e de campo.

Observação:

• Ao definir âncoras no nível do campo, certifique-se de que seu rótulo esteja próximo à sua área de valor e seja suportado por âncoras adicionais se a mesma construção de texto puder ser encontrada em vários locais no mesmo documento.
• Quanto maior o comprimento dos seus rótulos e âncoras, mais precisão você recebe. A área de valor é sempre calculada com base em sua posição relativa em relação ao seu rótulo (âncora principal). Escolha suas âncoras principais adequadamente. Ter âncoras no nível do campo permite que os campos se movam dentro do modelo e ainda sejam capturados, oferecendo mais flexibilidade nas alterações de layout do documento.

Integração de Compreensão de Documentos

A atividade Intelligent Form Extractor faz parte das Document Understanding Solutions. Acesse o Guia do Document Understanding para obter mais informações.