Controle da validação

O Controle de validação é um componente dentro do Apps no Studio Web que incorpora o Validation Station do Document Understanding em seus aplicativos. Isso permite que você revise, corrija ou aprove dados que foram extraídos automaticamente de documentos, como faturas, formulários ou e-mails. Cenários comuns incluem automações com intervenção humana, especialmente quando a extração de dados é incerta ou incompleta. Por exemplo, se uma fatura for digitalizada e o valor total parecer incerto, o Controle de validação permitirá que um humano a verifique e corrija antes do envio.

O Controle de validação permite revisar manualmente documentos diretamente em seu aplicativo da Web, especialmente quando:

• dados estão ausentes ou não estão claros
• os níveis de confiança são baixos
• o julgamento humano é necessário para validar as regras de negócios

Cenários do usuário

Exemplos de cenários de usuário do Controle de validação incluem:

• Aprovação de faturas com totais incertos
• Revisar solicitações de seguro com dados parcialmente extraídos
• Confirmação de nomes e endereços quando o documento for de baixa qualidade

Capabilities

Integrar o Controle de validação em seu aplicativo permite que você:

• Visualize o documento completo diretamente na interface do aplicativo.
• Consulte dados extraídos, como nomes, valores, datas.
• Editar, confirmar ou excluir dados.
• Dispare regras de negócios ou fluxos de trabalho com base em entradas de usuários.
• Valide vários tipos de documentos, valores de tabelas e estruturas de campos complexas.
• Troca segura de dados por meio do Automation Cloud, usando buckets de armazenamento para armazenar e recuperar todo o conteúdo de validação de documentos.

Como funciona

O fluxo de trabalho principal é o seguinte:

1, 2, 3, 4: você carrega um documento para extração. O robô processa seu documento usando o Document Understanding ou o Communications Mining.

5: o robô usa as atividades Criar Artefatos de Validação de Documento ou Criar Artefatos de Validação de Communication Mining para criar um objeto de saída da classe ContentValidationData . Esse objeto inclui os resultados extraídos, o documento original e informações de suporte.

A atividade então cria e armazena todos os dados intermediários que o Controle de Validação precisa para exibir o documento e seus detalhes de extração. Esses dados são salvos em um bucket de armazenamento do Orchestrator e você pode acessá-los usando o objeto ContentValidationData .

6: o robô que extraiu seus dados dispara um aplicativo de ação que inclui o Validation Control. Esse aplicativo é apresentado a você como uma tarefa do Action Center.

Observação: se você estiver criando um aplicativo independente, em vez de adicionar as etapas 6 (Criar tarefa do aplicativo) e 7 (Aguardar a tarefa do aplicativo e retomar), você pode atribuir o objeto ContentValidationData à variável ContentValidationData . Você pode usar essa variável como origem de dados do Controle de validação.

7: Você, como usuário, recebe uma tarefa no Action Center. Você abre o aplicativo da Web e vê o documento de um lado e os dados extraídos do outro. Você pode corrigir valores, confirmar dados ou rejeitar entradas incorretas.

8, 9, 10: depois de enviar os dados validados, o robô usa as atividades Retrieve Document Validation Artefatos ou Retrieve Communications Mining Validation Artefatos para recuperar as informações atualizadas e, em seguida, retoma a automação. Isso garante que o fluxo de trabalho use apenas dados revisados e aprovados.

Limitações

Ao usar o Controle de validação em seu aplicativo, tenha as seguintes limitações em mente:

• Você só pode usá-lo no Automation Cloud. Ambientes locais ou híbridos não são compatíveis.
• O Controle de validação funciona apenas em projetos do Studio Web App. Você não pode usá-lo no Apps VB.
• Você pode usá-lo apenas para tarefas de Validação de Documentos. No momento, ele não oferece suporte à Classificação de documentos.

O objeto DadosValidaçãoDoConteúdo

O objeto ContentValidationData são os dados necessários para o Controle de Validação carregar e renderizar um documento e seus detalhes de extração. Ele serve como a origem de dados para o controle.

Esse objeto é criado e armazenado em um bucket de armazenamento do Orchestrator pelas atividades Create Document Validation Artefatos ou Create Communications Mining Validation Artefatos . Quando uma tarefa é concluída, você pode usar o objeto ContentValidationData como entrada para as atividades Retrieve Document Validation Artefatos ou Retrieve Communications Mining Validation Artefatos para recuperar as informações validadas.

A estrutura JSON ContentValidationData

Você pode acessar o objeto ContentValidationData em um formato JSON a partir dos logs do fluxo de trabalho, depois de habilitar as atividades de log. Esse JSON informa ao Controle de validação exatamente onde encontrar todos os arquivos de que ele precisa no bucket de armazenamento para exibir o documento e seus dados extraídos. Um exemplo de um objeto ContentValidationData serializado no formato JSON é o seguinte:

{
"BucketName":"DUValidationStationTestSb",
"BucketId":186140,
"FolderId":756377,
"FolderKey":"c2751834-1f05-4f4e-9cb8-509406f6faac",
"DocumentId":"4e32cef6-d4ee-4eac-a382-e80a2640de8a",
"DocumentPath":"v1\\4e32cef6-d4ee-
4eac-a382-e80a2640de8a\\CMS 1500.zip",
"EncodedDocumentPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\encoded.zip",
"TextPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\text.zip",
"DocumentObjectModelPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\dom.zip",
"TaxonomyPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\taxonomy.zip",
"AutomaticExtractionResultsPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\input_results.zip",
"ValidatedExtractionResultsPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\output_results.zip",
"ExtractorPayloadsPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\extractor_payloads.zip",
"ShowOnlyRelevantPageRange":false,
"AdditionalDataPath":"",
"OriginalDocumentFileName":"CMS 1500.pdf",
"CustomizationInfoPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\customization_info.zip"
}

Onde:

• BucketName e BucketId— essas propriedades indicam o bucket de armazenamento onde todos os arquivos relacionados à validação de documentos são armazenados.
• FolderId e FolderKey—Essas propriedades indicam uma pasta específica dentro do bucket de armazenamento onde o documento e seus arquivos relacionados estão localizados.
• DocumentId— Um identificador exclusivo para o documento específico que está sendo validado.
• DocumentPath— O caminho completo para o arquivo do documento original dentro do bucket de armazenamento.
• EncodedDocumentPath, TextPath, DocumentObjectModelPath, TaxonomyPath—Esses são caminhos para vários arquivos intermediários também armazenados no bucket. Esses arquivos são essenciais para o Controle de validação renderizar o documento corretamente. Eles incluem dados como as informações de layout do documento (DocumentObjectModelPath) e o texto completo (TextPath).
• AutomaticExtractionResultsPath— O caminho para o arquivo que contém os dados que foram extraídos automaticamente pelo robô.
• ValidatedExtractionResultsPath—Aqui é onde os dados finais validados são salvos após a validação ser concluída.
• OriginalDocumentFileName— O nome do arquivo original.

Usando DadosDeValidaçãoDoConteúdo como Origem de dados

Se você usar a atividade Criar Artefatos de Validação de Documento , poderá atribuir o objeto ContentValidationData resultante diretamente ao Controle de Validação como sua origem de dados. Para fazer isso, você deve:

1. Adicione um aplicativo de ação ao seu projeto.
2. Para as Propriedades de entrada do ActionSchema, selecione + Adicionar propriedade.
3. Pesquise o objeto ContentValidationData , selecione-o e forneça um nome para ele. Por exemplo, "cvd".

4. Defina o campo Origem de dados do Controle de validação como a propriedade de entrada de ação "cvd". Isso define ActionProperties.cvd como a origem de dados de seu Controle de validação.

   

   

No entanto, ao criar manualmente um objeto JSON, você não pode usá-lo diretamente com o Controle de validação. Você deve primeiro convertê-lo em uma expressão Visual Basic (VB) com um conjunto simplificado de propriedades, como BucketId, FolderKey, DocumentId.

Por exemplo:

New UiPath.DocumentProcessing.Contracts.Actions.ContentValidationData With { 
.BucketId = 186140, 
.FolderKey =
new Guid("c2751834-1f05-4f4e-9cb8-509406f6faac"), 
.DocumentId = "4e32cef6-d4ee-4eac-a382-e80a2640de8a",
.DocumentObjectModelPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/dom.zip", 
.TaxonomyPath = "v1/4e32cef6-
d4ee-4eac-a382-e80a2640de8a/taxonomy.zip", 
.TextPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/text.zip",
.EncodedDocumentPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/encoded.zip", 
.AutomaticExtractionResultsPath
= "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/input_results.zip",
.CustomizationInfoPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/customization_info.zip"
}

Observação: você pode usar essa abordagem como uma forma avançada de solucionar problemas do seu aplicativo sem criar uma tarefa do Action Center.