Carregar Taxonomia

UiPath.IntelligentOCR.Activities.TaxonomyManagement.LoadTaxonomy

Transforma o arquivo taxonomy.json criado com a ajuda do Gerenciador de Taxonomia em uma variável que pode ser utilizada posteriormente com outras atividades.

Propriedades

Comum

• NomeDeExibição - o nome de exibição da atividade.

Diversos

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

Saída

• Taxonomia - A taxonomia que você deseja carregar, armazenada em uma variável DocumentTaxonomy . Esta saída pode ser utilizada posteriormente em atividades que recebam uma taxonomia como entrada.
  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.

Métodos de extensão da taxonomia

Serialize()

Ao ser requisitado em um objeto DocumentTaxonomy, o método Serialize() retorna uma representação JSON do objeto para poder ser armazenado e recuperado para uso posterior.

Deserialize(String)

A extensão estática DocumentTaxonomy.Deserialize(jsonString) retorna um objeto DocumentTaxonomy alimentado com os dados codificados em JSON passados como parâmetro.

GetFields(String)

Ao ser requisitado em um objeto DocumentTaxonomy , o método GetFields() requisitado com uma string DocumentTypeId retorna uma lista de campos definidos dentro desse tipo de documento.

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.

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 o seu grupo, você pode salvá-lo usando o botão Salvar ou simplesmente pressionando Enter.

Criando uma Categoria

Após um grupo ser definido e selecionado, você pode criar uma Categoria e/ou um Tipo de Documento dentro do grupo, usando seus botões definidos.

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, verifique se o grupo está selecionado e clique no botão Tipo de documento.

Se o Tipo de documento foi criado como um arquivo isolado, certifique-se de que nenhum grupo esteja selecionado e clique no botão Tipo de documento. Após clicar no botão Tipo de documento, insira um nome para o arquivo e clique no botão Salvar.

Observação: quando uma ação de Document Understanding for enviada do Orchestrator durante o uso do Studio v20.10, certifique-se de que a taxonomia não tenha nenhum tipo de documento criado sem categoria.

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

Depois que um tipo de documento é salvo, uma ID de tipo de documento é gerada para ele. Abrir o documento para edição exibe a ID ao lado da guia Nome do tipo de documento . O Document Type ID tem uma estrutura do tipo Group.Category.Document e pode ser copiado para a área de transferência. O código de ID do tipo de documento é uma funcionalidade opcional e pode ser usado para localizar seus documentos ou mapear seus documentos para os tipos de documento definidos na taxonomia.

Como criar campos

Quando o Tipo de Documento é selecionado, o botão Campo fica disponível para você criar um novo campo. Depois que o botão Campo for clicado, você poderá 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 criar regras que precisam ser atendidas pelo resultado da extração do campo.

Os tipos de campos disponíveis são:

• Texto
• Número
• Data - Escolher esse tipo também permite especificar um formato esperado, que é opcional.
  Observação:

  Se deseja adicionar um formato esperado, use um formato compatível com MSDN.

  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 adicionar vários valores ao campo a partir de uma lista preestabelecida.
• Booleano
• Tabela - Escolher este tipo permite editar a estrutura da tabela, pois você pode adicionar colunas e editar seu nome e tipo.
  
  

  

  
  

Aba Detalhes

Após a criação do novo Campo, clique nele para visualizar mais informações. Por padrão, quando você abre um campo, a guia Detalhes é exibida, permitindo que você modifique o nome, a cor ou a 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 de vários valores permite que um campo tenha vários valores, sem ficar 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ê poderá ter mais de um valor relatado para esse campo específico. 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 somente 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ê pode optar por habilitar as notas do 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 estiver habilitado, o validador manual pode visualizar quaisquer notas do validador definidas no campo ExtractionResult no Validation Station como uma mensagem. Se desabilitado (estado padrão), o validador humano também pode editar essa nota no Validation Station e, assim, comunicar de volta ao robô informações sobre a decisão tomada.
• Texto: se Texto estiver selecionado, a nota do validador é exibida como uma mensagem de texto (ou texto editável, quando a edição está habilitada) no Validation Station. O validador humano pode exibir, editar ou adicionar uma mensagem de no máximo 200 caracteres no Validation Station.
• Opções: se você selecionar Opções, você pode configurar uma série de botões de opção que a validação manual 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: Consulte a página Classe ExtractionResult da seção UiPath.DocumentProcessing.Contracts para obter mais informações sobre os dois métodos relacionados às notas do 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 o botão Excluir .

Refazendo essas etapas, é possível criar vários grupos, categorias e tipos de documento que você pode filtrar usando o campo Pesquisar.

Aba Regras

As regras de campo estão aqui para ajudá-lo a otimizar os resultados da extração e validá-los automaticamente ao executar seu fluxo de trabalho. A função deles é aumentar a eficiência da extração e facilitar a validação dos campos que precisam de atenção no Validation Station, destacando-os. Você pode criar várias regras que se aplicam a um campo.

Você define uma regra definindo o tipo de avaliador e o nível de criticidade.

Tipo de avaliador

Use o Tipo de avaliador para especificar como as regras definidas devem ser avaliadas. Existem dois tipos de avaliadores que você pode escolher: AND, OR.

Tipo de avaliador	Description	Exemplo
AND	Use esse tipo de avaliador quando todas as regras precisarem ser executadas.	Regra : O número da fatura começa com A e termina com X. Resultado Válido : O valor do campo válido é A123X. Resultado inválido : o valor do campo válido é A123.
OU	Apenas uma das regras precisa ser executada.	Regra : O número da fatura começa com A OU é 123. Resultado válido : o valor campo válido é A123, 123. Resultado inválido : o valor campo válido é 234, 1A23.

Nível de criticidade

Indica a criticidade de todas as regras definidas para um campo. Você não pode definir um nível MUST se a regra for quebrada na sessão da Estação de Validação. Existem dois níveis de criticalidade que você pode escolher: MUST, SHOULD.

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

Quando você deseja enviar uma regra, uma regra MUST requer 100% de sucesso, caso contrário, a operação de envio falha. Uma regra DEVERIA permitir que você a envie mesmo se a regra for quebrada.

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

Nível de criticidade	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.

Depois de selecionar o Tipo de avaliador e o Nível de criticidade, você deve definir um tipo aplicável à sua regra recém-criada. Existem várias opções que você pode escolher. Aqui está uma lista completa com todos os disponíveis:

• Não está vazio
• Valores possíveis
• Inicia com
• Termina com
• Contém
• Comprimento fixo
• É email
• RegEx
  Nota: O tipo de campo para o qual você criou uma regra determina o número de tipos de regra 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 está vazio e Valores possíveis.

Tipo de regras

Veja uma lista com todos os tipos de regras disponíveis, classificados de acordo com o nível de criticidade:

Tipo de Regra	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 do tipo: 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 ao criar a regra (por exemplo, O tipo de empregador pode ser "temporário integral", "temporário parcial" ou " estágio ".	Aplicável aos campos do tipo: 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 é obrigató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. Usar os operadores predefinidos para definir sua expressão. Eis aqui alguns 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 do tipo: 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 do tipo: 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 do tipo: 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 do tipo: 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 do tipo: 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 do tipo: text Address name	MUST SHOULD	AND OU

Usando Regras

Vamos dar um exemplo prático para entender melhor a aplicabilidade dessas regras. Veja como você pode criar uma nova regra ou um conjunto de regras para um campo:

Outras opções

Editando

Você pode Editar o nome de qualquer grupo, categoria ou tipo de documento criado. Isso pode ser feito selecionando um dos três níveis de configuração e editando o campo Nome.

Excluindo

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

• clique no Botão
  
  

  

  
  
• clique no Excluir do lado superior direito da janela.
  
  

  

  
  

Em ambos os casos, um pop-up é exibido solicitando a confirmação da ação de exclusão. Clique em Excluir para aprovar a ação conforme mostrado nos GIFs acima.

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. Aqui você pode encontrar mais informações sobre como usar os atalhos de campo para atribuir valores a um campo.

Navegue pelo Gerenciador de Taxonomia usando os atalhos de teclado. Ative a opção Alternar atalhos de teclado para evitar o acionamento acidental dos atalhos de teclado. Os nós também podem ser recolhidos com apenas um clique.

Aqui está uma visão mais detalhada de todos os atalhos de teclado disponíveis.

Observação: as alterações feitas no Gerenciador de Taxonomia são salvas automaticamente no arquivo taxonomy.json específico para seu projeto.