A variável Controle de validação

Variável Controle de validação no Studio Web Apps, sua criação automática por instância de controle, sintaxe de nomenclatura e como referenciá-la em automações e lógica de aplicativos.

Cada controle de validação cria automaticamente uma variável dentro do aplicativo. Essa variável contém os dados do documento e você pode usá-la em outras partes do seu aplicativo ou automação.

O nome da variável segue a sintaxe Var<ValidationControlName>_<PageName>, por exemplo, VarValidationControl_MainPage.

A variável Controle de validação permite ler e gravar no Controle de validação.

O Apps gerencia automaticamente essa variável:

• Cria a variável quando você adiciona o Controle de validação na tela.
• Renomeia a variável quando você renomeia o controle.
• Exclui a variável quando você remove o controle.
• Impede você de excluir ou modificar manualmente esta variável, pois ela é protegida.
• Fornece uso em diferentes páginas do aplicativo, pois a variável tem escopo de aplicativo.

Propriedades das variáveis

A variável Controle de validação inclui várias propriedades que você pode referenciar ou vincular:

• Taxonomy—Contém o esquema de documento, as definições de campo e os rótulos.
• ExtractionResult—Contém valores de campos extraídos, brutos e validados.
• SelectedDocumentType—O tipo de documento ativo mostrado no controle.
• SelectedField— O campo atualmente selecionado pelo usuário.
• BusinessRules—Status das regras de validação ao nível de campo.
• IsValid— Sinalizador booleano para substituir a validade do controle.
• DataSource— Contém o objeto ContentValidationData original.

Lendo dados

Para ler o estado atual do conteúdo do Controle de validação, use as seguintes expressões:

• Obtendo os resultados extraídos

  VarValidationControl1_MainPage.ExtractionResult
  

• Obtendo o tipo de documento selecionado

  VarValidationControl1_MainPage.SelectedDocumentType
  

• Obtenção do campo selecionado e seus valores

  VarValidationControl1_MainPage.SelectedField.FieldValue.Value
  

  VarValidationControl1_MainPage.SelectedField.FieldValue.Confidence
  

• Obtenção de campos de taxonomia (útil para listas suspensas)

  VarValidationControl1_MainPage.Taxonomy.GetFields(VarValidationControl1_MainPage.SelectedDocumentType).ToListSource
  

• Leitura de um valor de campo de tabela

  VarValidationControl1_MainPage.ExtractionResult.GetTableFieldValueByTableName("Invoice Items")(0)(0).Value
  

  Onde (0)(0) representa a célula na interseção da primeira coluna com a primeira linha da tabela Itens da fatura.

Consulte a documentação do Document Understanding para cada definição e propriedades de classe.

Gravação de dados

Para editar os valores dentro do Controle de validação, use a atividade Set Variable Value e faça referência à variável:

• Definir um valor de campo no campo Para a variável

  VarValidationControl1_MainPage.Field("Patient Name").Value
  

Campo de definição de valor : João.

• Definir foco em um valor de célula da tabela

  VarValidationControl1_MainPage.Field("Invoice Items").Field("Description", 0).SetFocus = true
  

  Onde ("Description", 0) representa a célula na interseção da coluna "Description" e a primeira linha da tabela Itens da fatura.

• Configuração de sinalizadores de confiança ou confirmação

  VarValidationControl1_MainPage.Field("Patient Name").Confidence = 0.95
  

  VarValidationControl1_MainPage.Field("Patient Name").Confirm = true
  

• Atualizando um campo de vários valores

  VarValidationControl1_MainPage.Field("Diagnosis Code", 2).Value = "E11.9"
  

  Onde 2 representa o número da linha na coluna Código de diagnóstico.

• Exclusão de um valor de campo

  VarValidationControl1_MainPage.Field("Vendor Name").DeleteValue
  

• Atualização de uma célula de uma tabela

  VarValidationControl1_MainPage.Field("Invoice Items").Field("Description", 0).Value = "50.00"
  

  Onde ("Description", 0) representa a célula na interseção da coluna "Description" e a primeira linha da tabela Itens da fatura.