Gerenciador de Taxonomia

Importante:

Caso você use uma GPU Intel Xe e o Gerenciador de Taxonomia não seja exibido corretamente, recomendamos atualizar o driver gráfico para a versão mais recente. Para obter mais informações, consulte esta página.

O Gerenciador de Taxonomia pode ser usado para criar e editar um arquivo de Taxonomia específico para seu projeto de automação atual. Este arquivo de Taxonomia contém tipos de documentos definidos pelo usuário, organizados em Grupos e Categorias.

Você pode aproveitar ainda mais o arquivo de Taxonomia convertendo-o em um tipo de dados. NET com a atividade Load Taxonomy e, em seguida, passando-o como entrada para atividades como:

• Classificar Escopo do Documento
• Train Classifiers Scope
• Escopo de Extratores de Treinamento
• Present Validation Station

O Gerenciador de Taxonomia pode ser acessado somente após a instalação de um pacote UiPath.IntelligentOCR.Activities versão v1.6.0 ou superior como dependência para seu projeto. Após a instalação do pacote, um botão para o Gerenciador de Taxonomia aparece na faixa de opções, na seção Assistentes.

Usando o Gerenciador de Taxonomia

A janela do Gerenciador de Taxonomia permite criar tipos de documentos, organizados por grupos e categorias. Quando aberta pela primeira vez em um projeto, nenhum grupo, categoria ou tipo de documento é definido.

Figura 1. O Gerenciador de taxonomia antes de mapear quaisquer tipos ou campos de documentos

Estabelecendo a Estrutura

O primeiro passo é criar um grupo ou um tipo de documento. A diferença entre os dois é que um grupo envolve uma estrutura hierárquica, enquanto um tipo de documento pode ser criado como um único arquivo. Um projeto complexo implica a criação de grupos, categorias e tipos de documentos; um projeto simples pode exigir apenas um ou dois tipos de documentos.

Criando um Grupo

Quando um grupo é criado, também é necessária uma categoria para o tipo de documento que você deseja criar dentro do grupo. Isso é feito usando o botão Grupo. Depois de escolher um nome para seu grupo, você pode salvá-lo usando o botão Salvar ou usando a tecla Enter.

Criando uma Categoria

Depois que um grupo é definido e selecionado, você pode criar uma Categoria e/ou um Tipo de Documento dentro do grupo, usando seus botões definidos. Selecione Salvar ou use a tecla Enter para salvar a configuração.

Criando um Tipo de documento

Um Tipo de documento pode ser criado como parte de um grupo ou como um documento isolado. Quando criado dentro de um grupo, certifique-se de que o grupo esteja selecionado e, em seguida, selecione Tipo de documento.

Se o Tipo de Documento for criado como um único arquivo, certifique-se de que nenhum grupo esteja selecionado e selecione Tipo de Documento. Depois de selecionar Tipo de Documento, insira um nome para o arquivo e selecione Salvar.

Observação:

Quando uma Ação de Document Understanding é enviada do Orchestrator ao utilizar a versão 2020.10 do Studio, certifique-se de que a taxonomia não tenha tipos de documentos criados sem uma categoria.

Selecionar um Tipo de documento já criado permite alterar seu nome, copiar seu ID exclusivo para a área de transferência ou reatribuí-lo a outro grupo ou categoria. Você também pode inserir um código para o tipo de documento.

Once a document type is saved, a Document Type ID is generated for it. Opening the document for editing displays the ID next to the Document Type Name tab. The Document Type ID has a structure of the type Group.Category.Document and can be copied to the clipboard. The Document Type ID code is an optional functionality and it can be used to find your documents or map your documents to the Document Types that you define in the taxonomy.

Definição das configurações de exibição para o tipo de documento

Depois de criar o tipo de documento, você pode definir suas configurações de exibição. Selecione o tipo de documento no Gerenciador de Taxonomia e acesse Configurações de exibição. è possível alterar as seguintes configurações:

• Limite de confiança de OCR: defina um limite mínimo de confiança ao nível do tipo de documento. Quando o documento é exibido na Estação de validação, tanto o nível de confiança de OCR quanto o nível de confiança de extração para um campo teriam que ser maiores do que o limite configurado no Gerenciador de taxonomia. O valor padrão para o limite de confiança de OCR é de 90%.

• Formato de exibição de data: o formato de data exibido para o tipo de documento.

  O valor padrão é YYYY-MM-DD.

• Separador decimal de número: o separador decimal de número que você deseja usar para o tipo de documento.

• Separador de número de milhar: o separador de número de milhar que você deseja usar para o tipo de documento.

Como criar campos

Quando o Tipo de documento é selecionado, o botão Campo fica disponível para criar um novo campo. Depois que o botão Campo for selecionado, você pode inserir um nome para ele e selecionar seu tipo na lista suspensa.

A categoria Campo tem duas guias: Detalhes e Regras. A guia Detalhes fornece informações sobre o campo selecionado, como Nome do campo, tecla de atalho atribuída ou tipo de campo, enquanto a guia Regras permite que você crie regras que precisam ser atendidas pelo resultado da extração para o campo.

Os seguintes tipos de campo estão disponíveis:

• Texto
• Número
• Quantia Monetária
• Data - A escolha desse tipo também permite que você especifique um formato esperado, que é opcional.
  Observação:

  Se você quiser adicionar um formato esperado, use um formato compatível com MSDN (MicroSoft Developer Network). Este formato pode ser usado por extratores e é usado pela atividade Data Extraction Scope ao tentar analisar uma Data em suas partes constituintes de Dia, Mês e Ano.

• Name
• Address
• Definir - Escolher esse tipo permite que você adicione vários valores ao campo de uma lista preestabelecida.
• Booleano
• Tabela - A escolha desse tipo permite que você edite a estrutura da tabela, pois você pode adicionar colunas e editar seu nome e tipo.
• GrupoDeCampos - A escolha desse tipo permite exibir estruturas de campo hierárquicas na Estação de validação, permitindo a organização lógica dos dados extraídos. Os FieldGroups preservam a estrutura hierárquica dos dados extraídos, tornando mais fáceis e rápidos de validar pacotes de documentos grandes de várias páginas.

Aba Detalhes

Depois que o novo Campo for criado, selecione-o para visualizar mais informações. Por padrão, quando você abre um campo, a guia Detalhes é exibida permitindo que você modifique o nome, cor ou tecla de atalho do campo. Você também pode especificar se é multivalor (É multivalor) ou se permite que valores sem evidência no documento sejam processados (Requer referência).A opção multivalor permite que um campo tenha vários valores, sem ser restrito a uma lista específica.

Para obter mais informações sobre como usar os dois campos, consulte as seguintes descrições:

• É multivalor: se um campo for definido como multivalor, você pode ter mais de um valor relatado para esse campo específico. Por exemplo, você deseja extrair uma "Lista de diretores" onde você pode ter um número variável de entradas. Imagine um campo de vários valores como uma tabela de coluna única.
• Requer referência: quando um campo requer referência, você pode adicionar um valor a ele apenas se selecionar algo do documento que você vê na Estação de Validação. Para campos especiais nos quais você deseja capturar valores que talvez não sejam visíveis no documento, você pode alternar Requer referência para Off. O efeito será que o usuário poderá adicionar um valor sem especificar um local no documento de onde esses valores vêm.

Você também pode selecionar o Tipo do campo na lista suspensa ou adicionar um valor Padrão. Use o campo Valor padrão para definir valores a serem preenchidos no Resultado da extração, caso não haja valor para o campo identificado no documento.

Configurações de validação

Em Configurações de validação, você tem a opção de definir um limite de confiança de extração. Esse limite é considerado ao validar o campo na Estação de Validação. Para definir um limite de confiança de extração, acesse Limite de confiança de extração e insira um valor que varia de 0 a 100.

Figura 2. Visão geral da guia Detalhes de um campo

Você pode optar por habilitar as Notas de validador na guia Detalhes . Ao configurar notas do validador, o validador humano pode adicionar notas sobre a decisão que tomaram durante a validação. Você pode fazer as seguintes configurações:

• Somente leitura: se habilitado, o validador humano pode visualizar quaisquer notas de validador definidas no campo ResultadoDaExtração na Estação de validação, como uma mensagem. Se desabilitado (estado padrão), o validador humano também pode editar essa nota na Estação de Validação e, assim, comunicar de volta ao robô informações sobre a decisão tomada.
• Texto: se Texto for selecionado, a nota de validador é exibida como uma mensagem de texto (ou texto editável quando a edição estiver habilitada) na Estação de Validação. O validador humano pode visualizar, editar ou adicionar uma mensagem de no máximo 200 caracteres na Estação de Validação.
• Opções: se você selecionar Opções, você pode configurar uma série de botões de opção que o validador humano pode visualizar e, se não for somente leitura, selecionar na Estação de Validação. É possível adicionar no máximo 10 opções.
  Dica:

  Verifique a página Classe ExtractionResult na seção UiPath.DocumentProcessing.Contracts para obter mais informações sobre os dois métodos relacionados às notas de validador GetFieldValidatorNotes(<fieldId>) e SetFieldValidatorNotes(<fieldId>, <validatorNote>).

Os campos criados podem ser excluídos usando o botão excluir que aparece ao lado ou reordenados usando a função arrastar e soltar.

Um campo também pode ser excluído da janela Detalhes, selecionando Excluir.

Retracing these steps, you can create multiple groups, categories, and document types, which you can then filter by using the Search field.

Aba Regras

As regras de campo ajudam você a otimizar os resultados da extração e validá-los automaticamente ao executar seu fluxo de trabalho. Sua função é aumentar a eficiência da extração e ajudar você a validar facilmente os campos que precisam de atenção na Estação de validação, destacando-os. Você pode criar várias regras que se aplicam a um campo.

You define a rule by setting the Evaluator type and the Criticality level.

Tipo de avaliador

Use the Evaluator Type to specify how the defined rules should be evaluated. There are two evaluator types that you can choose from: AND, OR.

Tabela 1. Tabela mostrando Tipos de avaliadores, suas descrições e exemplos deles.

Tipo de avaliador	Description	Exemplo
AND	Use esse tipo de avaliador quando todas as regras precisarem ser executadas.	Rule : Invoice Number starts with A And ends with X. Valid Result : The valid field value is A123X. Invalid Result : The valid field value is A123.
OU	Apenas uma das regras precisa ser executada.	Regra : o número da fatura começa com A OR é 123. Valid Result : The valid field value is A123, 123. Resultado inválido : o valor campo válido é 234, 1A23.

Nível de criticidade

Indicates the criticality of all rules defined for a field. You cannot set a MUST level if the rule is broken in the Validation Station session. There are two criticality levels that you can choose from: MUST, SHOULD.

A regra criada é acionada assim que o nível de criticidade definido é identificado.

When you want to submit a rule, a MUST rule requires 100% success, otherwise the Submit operation fails. A SHOULD rule allows you to Submit it even if the rule is broken.

Você sempre pode verificar se uma regra é quebrada usando o método do ajudante da classe Classe ExtractionResult , que reside no pacote de atividades UiPath.DocumentProcessing.Contracts.

Tabela 2. Tabela que exibe Níveis de criticidade e suas descrições

	Description
MUST	Use este nível de criticidade quando a regra criada for imperativa para ser incluída no processo de Resultado da Extração.
SHOULD	Use este nível de criticalidade quando a regra criada for opcional.

Once you have selected the Evaluator Type and the Criticality Level, you must set a type applicable for your newly created rule. There are several options you can choose from. Here's a complete list with all the available ones:

• Não está vazio
• Valores possíveis
• Inicia com
• Termina com
• Contém
• Comprimento fixo
• É email
• RegEx
  Observação:

  O tipo de campo para o qual você criou uma regra dita o número de tipos de regras possíveis dos quais você pode selecionar um. Por exemplo, um campo do tipo Texto exibe todos os tipos de regras possíveis, enquanto um campo do tipo Data exibe apenas dois tipos de regras, Não vazio e valores Possíveis .

Tipo de regras

A tabela a seguir mostra detalhes para cada tipo de regra disponível, classificado dependendo do nível de criticidade e do tipo de avaliador.

Tabela 3. Tipos de regras e suas descrições, dependendo do nível de criticidade e do tipo do avaliador

	Description	Tipo de campo	Nível de criticidade	Tipo de avaliador
Não está vazio	O valor extraído não pode estar vazio, o que significa que o campo é obrigatório. Se o valor estiver ausente, a validação/entrada manual será necessária.	Aplicável aos campos dos seguintes tipos: Número text data Address name DEFINIR Booleano	MUST SHOULD	AND OU
Valores possíveis	O usuário define todos os valores possíveis e os dados extraídos são um dos valores adicionados como entrada durante a criação da regra (por exemplo, o Tipo de Funcionário é "tempo integral", "meio período" ou "estágio").	Aplicável aos campos dos seguintes tipos: Número text data	MUST SHOULD	AND OU
Expression	Defina expressões matemáticas que atuam como uma regra para extrair dados.	Aplicável aos campos do tipo número. Uma condição é necessária ao configurar a regra. Escolha uma das seguintes opções: É igual a Não é igual a é maior que é maior ou igual a é menor ou igual a Uma expressão matemática é necessária. Use os operadores predefinidos para definir sua expressão. Verifique os seguintes exemplos: Quantidade de soma * Preço unitário líquido\n- Total = Subtotal + Entrega Desconto — o operador de soma reúne todos os valores da coluna de uma tabela.	MUST SHOULD	AND OU
Inicia com	Esta é uma regra fixa, o que significa que o valor extraído precisa começar com um dos valores adicionados pelo usuário.	Aplicável aos campos dos seguintes tipos: text Address name	MUST SHOULD	AND OU
Termina com	Esta é uma regra fixa, o que significa que o valor extraído precisa terminar com um dos valores adicionados pelo usuário.	Aplicável aos campos dos seguintes tipos: text Address name	MUST SHOULD	AND OU
Contém	Esta é uma regra fixa, o que significa que o valor extraído precisa conter um dos valores adicionados pelo usuário.	Aplicável aos campos dos seguintes tipos: text Address name	MUST SHOULD	AND OU
Comprimento fixo	Esta é uma regra fixa, o que significa que o valor extraído precisa ter um determinado comprimento fixo.	Aplicável aos campos dos seguintes tipos: text Address name	MUST SHOULD	AND OU
É email	Esta é uma regra fixa, o que significa que o valor extraído precisa ser escrito em um formato de e-mail.	Aplicável aos campos dos seguintes tipos: text Address name	MUST SHOULD	AND OU
RegEx	Esta é uma regra fixa, o que significa que o valor extraído precisa conter uma expressão regular semelhante a um dos valores adicionados pelo usuário.	Aplicável aos campos dos seguintes tipos: text Address name	MUST SHOULD	AND OU

Usando Regras

Vamos tomar um exemplo prático para entender melhor a aplicabilidade dessas regras. Criaremos um conjunto de regras para o campo Endereço do documento. Verifique as seguintes etapas de exemplos para saber como você pode criar uma nova regra ou um conjunto de regras para um campo:

1. Selecione um campo no painel Taxonomia.
2. Acesse a guia Regras .
3. Selecione Adicionar novo, para adicionar uma nova regra.
4. Digite a regra full address , para a qual o Tipo é Contém e a Expressão é st, str, street.
5. Escolha o Tipo de avaliador. Nesse exemplo, selecione OR.
6. Escolha o nível de Criticidade. Nesse exemplo, selecione MUST.
7. Selecione Adicionar novo.
8. Digite a regra phone number, para a qual o Tipo é Não está vazio.
9. Selecione Adicionar novo.
10. Digite a regra city or state , para a qual o Tipo é Contém e a Expressão é city, state.

A imagem animada a seguir mostra as etapas descritas anteriormente.

Figura 3. Imagem animada exibindo como adicionar três regras para um campo

Outras opções

Editando

You can Edit the name of any group, category, or document type that you have created. This can be done by selecting one of the three levels of configuration and editing the Name field.

Excluindo

Grupos, categorias e tipos de documento também podem ser excluídos. Há duas opções disponíveis:

• Selecionar Excluir, no elemento pai do objeto que você deseja excluir.
• Selecionar Excluir enquanto seleciona o objeto que você deseja excluir.

Em ambos os casos, um pop-up é exibido pedindo que você confirme a ação de exclusão. Selecione Excluir para aprovar a ação.

Personalização e acessibilidade

Uma tecla de atalho e uma cor são alocadas automaticamente para o campo recém-criado. Você pode usá-las para melhor visibilidade e navegação mais rápida em sua taxonomia. Personalize-as clicando na tecla de atalho ou no campo do código de cores.

Um campo personalizado com cor e tecla de atalho pode instruir a Estação de Validação e o Gerenciador de Modelos a usar a cor atribuída ao exibir o campo e a usar a tecla de atalho atribuída como um atalho para fornecer valores aos campos. Consulte a página Estação de validação para obter mais informações sobre como usar os atalhos de campo para atribuir valores a um campo.

Para atribuir uma cor e uma tecla de atalho para um campo, selecione o campo e escolha um código de cor específico no campo Cor e, em seguida, selecione uma tecla de atalho específica no menu Tecla de atalho.

Navegue pelo Gerenciador de Taxonomia usando os atalhos de teclado. Selecione Mostrar atalhos de teclado disponíveis e ative a opção Alternar atalhos de teclado para evitar o disparo acidental dos atalhos de teclado. Os nós também podem ser recolhidos.

Observação:

The changes you make in the Taxonomy Manager are automatically saved into the taxonomy.json file specific to your project.