Validação de documentos com ações de aplicativos

Este guia de início rápido ajuda você a começar a validar documentos adicionando a Estação de Validação dentro dos aplicativos UiPath® Action e, em seguida, enviando-os para validação por meio do Action Center como ações do aplicativo. O tutorial usa o UiPath Studio para automatizar o processamento de documentos, o UiPath Apps para exibir a estação de validação e o Action Center para realizar a validação. O tipo de documento usado nos exemplos ao longo deste tutorial é um formulário de seguro de saúde, do tipo formulário de solicitação CMS 1500.

As etapas de visão geral deste guia de início rápido são:

1. Crie o aplicativo de Ação que exibe o Controle de validação.
2. Use um aplicativo configurado anteriormente para criar a automação do Studio que processa o documento e o envia para validação no Action Center.
3. Conclua a ação no Action Center.

Etapas

1. Criar um aplicativo do Action

Pré-requisitos

Certifique-se de que seu tenant:

• Tem Robot Units suficientes, pois o aplicativo é executado usando Serverless Robots.
• Um modelo de Serverless Robot é criado no Orchestrator e provisionado. Para obter mais informações sobre Serverless Robots e como adicioná-los a um tenant, acesse Executar automações Unattended com Serverless Robots.

1. Crie um aplicativo de Ação

Observação: ao contrário dos aplicativos VB disponíveis por meio do serviço do Apps, os aplicativos podem ser acessados por meio do Studio Web.

Para criar um aplicativo do Action Center, siga estas etapas:

1. Acesse o Studio Web.
2. Selecione Criar novo > Aplicativo para criar um novo projeto.
3. Dentro do Explorador de projetos de seu aplicativo, selecione Adicionar páginas, fluxos de trabalho, controles, integrações > Ação.

   Essa etapa adiciona uma Ação ao aplicativo e permite que você configure um esquema de Ação para ele.

4. Expanda Ação e selecione EsquemaDeAção.

   Configure o esquema de ação com os argumentos In e Out que você deseja para ações do aplicativo no Action Center.

   1. Para Resultados, adicione outros resultados personalizados que você deseja que a ação tenha.

      Por exemplo, você pode adicionar um resultado personalizado, chamado "Aprovar".

   2. Para Propriedades de entrada, adicione propriedades para dados que você deseja passar para a ação.

      Essas propriedades aparecerão na atividade Create App Task , quando este aplicativo for selecionado na lista suspensa Apps . As propriedades de entrada permitem que você passe dados de sua automação do Studio para sua ação.

   3. Para Propriedades de Saída, adicione propriedades para argumentos que você deseja recuperar da ação.

      Essas propriedades serão acessíveis a partir da atividade Wait for App Task and Resume , por meio da variável Objeto da Tarefa (Saída) .

   4. Para propriedades de Input/Output , adicione propriedades que funcionem como argumentos In/Out em sua automação do Studio.

      Essas propriedades de entrada/saída aparecem primeiro como propriedades na atividade Create App Task , que você passa para a ação. Em seguida, após a ação ser concluída, você poderá acessar as mesmas propriedades, que foram atualizadas, da atividade Wait for App Task and Resume , através da propriedade Task Object (Output) .

2. Adicione e personalize o Controle de validação

Um controle de validação incorpora a estação de validação, usada em fluxos de trabalho de processamento de documentos. Para adicionar e personalizar um controle de validação em um aplicativo do Action Center, siga estas etapas:

1. Abra o aplicativo de Ação desejado, no qual você deseja incorporar a Estação de Validação.
2. Selecione Abrir caixa de ferramentas.
3. Em Exibir, encontre o Controle de validação e o adicione ao seu aplicativo.
   Adicionar o Controle de validação ao seu aplicativo cria automaticamente uma variável Var<ValidationControl_PageName> na seção Variáveis do aplicativo do Explorador de Projetos do seu aplicativo.
   Observação: você pode usar o Controle de validação e a Variável de aplicativo correspondente para ler informações do Controle de validação. Use a Variável Var<ValidationControl_PageName> do Aplicativo para gravar informações nele.
4. Prepare o esquema de ação:
   1. No Explorador de projetos, em Ação, selecione EsquemaDeAção.
   2. Em Propriedades de entrada, selecione Adicionar propriedade.
   3. Na barra de pesquisa de propriedades, selecione Mais opções.
   4. Em Avançado, selecione ContentValidationData.
      Esta é a propriedade de entrada que será exibida na atividade Create App Task . A propriedade de entrada ContentValidationData requer um objeto ContentValidationData como entrada, que pode ser um único objeto ou uma matriz/lista de instâncias ContentValidationData . ContentValidationData contém os artefatos da Estação de Validação. ContentValidationData é criado usando a atividade Create Document Validation Artefatos .
5. Configure o controle de validação:
   1. Acesse as propriedades do Controle de validação.
   2. Na entrada Origem , selecione a entrada Ação que você definiu como um tipo ContentValidationData .
6. Configure o restante do aplicativo com outros Controles de que você precisar.

3. Dados de controle de validação de acesso e suas propriedades

Várias propriedades do Controle de Validação, como Taxonomia, Resultado da Extração, Tipo de Documento Selecionado, Campo Selecionado e Origem de dados, podem ser acessadas usando a variável Controle de Validação (VarValidationControl_PageName). Você pode alterar os valores exibidos no Controle de validação por meio da variável do aplicativo correspondente. Siga as etapas descritas em Editar dados de controle de validação para adicionar, modificar ou remover um valor de campo.

A tabela a seguir descreve as propriedades que você pode acessar a partir do Controle de validação, seu tipo de dados e as descrições.

Tabela 1. Propriedades de controle de validação

Propriedade	Tipo de dados	Description
Taxonomy	UiPath.DocumentProcessing.Contracts.Taxonomy.DocumentTaxonomy	O objeto de taxonomia com o qual o conteúdo foi preparado para exibição. Ele contém informações sobre os tipos de documentos, campos e propriedades de exibição.
ExtractionResult	UiPath.DocumentProcessing.Contracts.Results.ExtractionResult	Os resultados da extração, conforme estão (com ou sem alterações humanas), do Controle de validação.
TipoDeDocumentoSelecionado	System.String	O nome do tipo de documento selecionado atualmente no Controle de Validação.
SelectedField	UiPath.DocumentProcessing.Contracts.Apps.FieldValueDetails	O campo atualmente selecionado no Controle de Validação com seu valor.
DataSource	UiPath.DocumentProcessing.Contracts.Actions.ContentValidationData	Os dados de validação de conteúdo que são atualmente a origem do Controle de Validação.
Hidden	boolean	O estado da propriedade do controle que rege se o controle está visível ou oculto.
Disabled	boolan	O estado da propriedade de controle que rege se o controle é editável ou não.
IsValid	boolean	Verifica a validade do valor do Controle de validação. Se verdadeiro, indica que é válido.

4. Editar dados de controle de validação

Você pode alterar os valores exibidos no Controle de validação por meio da variável do aplicativo correspondente. Por exemplo, você pode alterar os valores do Resultado da Extração exibidos no Controle de Validação por meio da variável do aplicativo correspondente.

O seguinte exemplo mostra como atualizar um valor de campo regular:

1. Selecione qualquer Controle em seu Aplicativo e acesse Eventos.
2. Selecione Definir automação.

   Essa ação abre o painel do designer do Studio Web, onde você pode criar uma automação de gatilho para um determinado controle de aplicativo.

3. No contexto dos Resultados da Extração do documento, para adicionar ou alterar um valor de campo para campos regulares, adicione uma atividade Set Variable Value na automação.
   1. Para o campo Para variável , use AppVariable.VarValidationControl_PageName.Field("<field name>").Value.
      Essa expressão representa o campo que você deseja alterar, acessado por meio da variável VarValidationControl_PageName .
   2. No campo Para insira o valor desejado para o campo referenciado.
   Além de campos regulares, a variável AppVariable.VarValidationControl_PageName também pode manipular campos de vários valores usando AppVariable.VarValidationControl_PageName.Field("<field name>", <index>) e interagir com células de tabela usando AppVariable.VarValidationControl_PageName.Field("<table field name").Field("<column name>", <row index>).
   Para excluir valores, selecione o valor de destino de forma semelhante e use o sinalizador .DeleteValue definido como True.

   As propriedades dos valores que você pode atualizar no controle de validação incluem:

   • Valor textual (.Value)
   • Estado confirmado (.Confirmed)
   • Nível de confiança do valor (.Confidence)
   • Sinalização de exclusão (.DeleteValue)
   • Sinalizador para remover uma referência de valor (.KeepReference)

Você pode usar as mesmas etapas para alterar outros dados do Controle de validação no runtime. A única diferença é que você usa uma variável diferente, no campo Para a variável , de forma que ela corresponda aos dados do controle de validação que você deseja alterar. Por exemplo, você pode usar a variável AppVariable.ValidationControl.SelectedDocumentType se quiser atualizá-la com um valor diferente.

Figura 1. As atividades Set Variable Value por meio das quais você pode atualizar dados do Controle de Validação

5. Criar eventos para o Controle de validação

Você pode disparar vários eventos específicos do Controle de validação. No Explorador de Projetos, navegue até o Controle de validação e selecione-o. O painel Eventos do Controle de validação permite que você defina automações para eventos específicos.

A tabela a seguir descreve os eventos de Controle de validação disponíveis:

Tabela 2. Eventos do controle de validação

Evento	Description
Pronto	Dispara quando o Controle de validação é carregado.
Tipo de documento alterado	Dispara quando o usuário altera o tipo do documento no Controle de Validação.
Campo selecionado	Dispara quando o usuário seleciona um dos campos ou o valor de um campo no Controle de validação.
Valor do campo alterado	Dispara quando o usuário adiciona, remove ou substitui um valor de campo no Controle de validação.

6. Use atividades dedicadas ao Controle de validação

Você pode usar atividades específicas dedicadas a trabalhar com o Controle de validação, do pacote AppEvents.Activities :

1. Definir foco de campo de controle de validação: permite que você se concentre em um campo, com base em um evento configurado.
2. Salvar estado do controle de validação: salva o estado do controle de validação. Você pode usar isso quando quiser revisitar e concluir a validação mais tarde.

Expressões comuns de controle de validação

Quando estiver criando seu aplicativo que contém um Controle de Validação, você pode usar as seguintes expressões para acessar vários dados expostos pelo Controle de Validação. A tabela a seguir descreve as expressões mais comuns que você pode usar ao trabalhar com o Controle de validação:

Tabela 3. Expressões comuns do controle de validação

Finalidade	Expression
Acesse os resultados da extração exibidos no controle de validação	AppVariable.VarValidationControl_PageName.ExtractionResult MainPage.ValidationControl.ExtractionResult
Acesse a taxonomia carregada no Controle de Validação	AppVariable.VarValidationControl_PageName.Taxonomy MainPage.ValidationControl.Taxonomy
Acesse o campo selecionado no Controle de Validação	AppVariable.VarValidationControl_PageName.SelectedField MainPage.ValidationControl.SelectedField As propriedades do campo selecionado podem ser: Field.FieldName – Nome do campo. Field.FieldType – Tipo de campo. Field.ValidatorNotes – As notas do validador do campo. Field.Values – Todos os valores de um campo selecionado. Field.Value – Informações relacionadas ao valor do campo: FieldValue.Value FieldValue.Confidence FieldValue.OperatorConfirmed FieldValue.FieldValueIndex (para campos de vários valores, retorna o índice ao qual o Valor de campo selecionado pertence).
Acesse propriedades adicionais do Controle de validação	MainPage.ValidationControl.<PropertyName>
Ler dados de resultados de extração	Use os métodos expostos pela classe Resultado da Extração.
Ler dados de taxonomia	Use os métodos expostos pela classe Taxonomia.
Acesse um valor de campo para atualizá-lo no Controle de Validação	AppVariable.<ValidationControlVariable>.Field("<FieldName>").Value
Recuperar a lista de nomes de campos exibidos no Controle de Validação	AppVariable.<ValidationControlVariable>.ExtractionResult.GetFields().Select(Function(f) f.FieldName)

6. Publique e implante o aplicativo

Depois de criar seu aplicativo de Ação e disparar automações para os Controles dentro dele, você pode publicá-lo. A publicação do aplicativo o disponibiliza para uso na criação de ações do aplicativo. Para obter mais informações sobre a publicação de aplicativos, acesse Publicação, implantação e atualização de projetos de aplicativos.

2. Criar automação do Studio

Pré-requisitos

• Instale as seguintes versões do pacote de atividades:
  • IntelligentOCR.Activities versão 6.24.0
  • Persistence.Activities versão 1.5.5 ou posterior.
  • AppEvents.Activities versão 3.12.0 ou posterior.
• Crie um bucket de armazenamento no Orchestrator, na mesma pasta em que você deseja publicar a automação de processamento do documento.

  Os dados necessários para carregar o controle de validação dentro dos aplicativos são armazenados em um bucket de armazenamento do Orchestrator.

• Adicione o documento que você deseja processar dentro da pasta do projeto do Studio.
• Opcionalmente, se você quiser usar recursos de extração ou validação generativos, precisará de unidades de serviço específicas
  • Se você se inscreveu no plano Flex, você precisa de AI Units

  Para obter mais informações sobre as funcionalidades generativas do Document Understanding, acesse as funcionalidades generativas.

1. Processar um arquivo usando o Document Understanding

Adicione atividades que usem o Document Understanding para processar um arquivo. Prepare o documento para validação no Action Center por meio de aplicativos, usando digitalização e extração.

Após adicionar as atividades para processar o arquivo, as seguintes variáveis devem estar disponíveis:

• DocumentTaxonomy (Taxonomia): recuperado por meio da atividade Load Taxonomy .
• Dom (Modelo de Objeto do Documento) e text (Texto do Documento): adquiridos por meio da atividade Digitize Document .
• doc (Caminho do documento): representa o caminho para o arquivo processado.
• autoExtractionResults (ExtractionResults): esta é a saída da atividade Data Extraction Scope , independentemente dos métodos de extração usados.

2. Envie as informações de validação para o aplicativo

Depois que o documento estiver pronto para ser validado, você poderá preparar todas as informações a serem enviadas para o aplicativo criado e implantado anteriormente. Siga estas etapas:

1. Adicione uma atividade Create Document Validation Artefatos para criar o objeto Content Validation Data que armazena as informações necessárias para carregar o Controle de validação no aplicativo Ação.
   Neste exemplo, configure a atividade usando as variáveis criadas anteriormente ou emitidas:

   • Caminho da Pasta do Bucket: o nome da pasta do Orchestrator na qual o bucket de armazenamento foi criado.
   • Nome do Bucket: storageBucketName
   • Caminho do diretório do bucket: o caminho do diretório dentro do bucket de armazenamento inserido anteriormente, onde você deseja armazenar os dados da ação.
   • CaminhoDoDocumento: doc
   • Texto do documento: text
   • Modelo de objeto do documento: dom
   • Taxonomia: taxonomy
   • Resultados da Extração Automática: autoExtractionResults
2. Adicione uma atividade Create App Task para que você possa vincular o objeto Content Validation Data ao aplicativo criado anteriormente e, em seguida, enviá-lo ao Action Center para validação.

   Neste exemplo, configure a atividade da seguinte forma:

   • Título: CVD
   • Prioridade: Medium
   • Aplicativos: Demo.Validation.Control.in.Apps
   • Versão do Aplicativo: v2.0.0

     Depois de selecionar o aplicativo e a versão correspondente que você deseja usar para criar a ação, as propriedades de entrada desse aplicativo serão mostradas no corpo da atividade.

     • Neste exemplo, uma das propriedades de entrada é Action_Content_Validation_Data, que requer os artefatos de validação de documentos criados anteriormente: contentValidationData.
   Figura 2. A atividade Create App Task
   

   

   
   
3. Adicione uma atividade Wait for App Task and Resume para retornar as informações sobre a ação e retomar o fluxo de trabalho.

   No campo Tarefa do aplicativo criada , insira a variável de saída da atividade Criar tarefa do aplicativo .

4. Adicione uma atividade Retrieve Document Validation Artefatos para retornar os artefatos de validação de documentos após o usuário realizar a validação no Action Center.

   Passe a variável de saída da atividade Criar Artefatos de Validação de Documento como a entrada da atividade Retrieve de Artefatos de Validação de Documento .

   Dica: você também pode criar variáveis de saída dedicadas para informações adicionais armazenadas nos artefatos de validação, como AutomaticExtractionResults e ValidatedExtractionResults.

3. Realize a validação no Action Center

1. Abra o Action Center e vá para Minhas ações ou Gerenciar ações.
2. Na guia Não atribuída , encontre a ação que você acabou de criar usando a automação anterior do Studio.
3. Se quiser atribuir a ação a si mesmo, selecione a ação desejada e, então, selecione Atribuir a si mesmo.
4. Se você quiser atribuir a ação a outro usuário, selecione Mais opções para a ação desejada. Em seguida, selecione Atribuir ao usuário e selecione um usuário na lista suspensa.
5. Acesse a guia Pendente e conclua a ação para retomar o fluxo de trabalho do Studio.