Códigos de status de processamento de documento

Para determinar as páginas que devem ser exibidas para um operador, o Datacap mantém uma variável Status para cada objeto na hierarquia de lotes de tempo de execução. Por exemplo, um status de 0 indica que as operações no objeto foram bem-sucedidas enquanto um código de status 1 indica um problema ou potencial problema.

O Datacap atualiza o status quando as regras são iniciadas.

O Datacap usa outros códigos de status, como 49, o que indica que uma página foi varrida com êxito. Por padrão, o Datacap exibe todas as páginas, mas é possível configurar um aplicativo para exibir apenas páginas com um status de 1.

Os problemas a seguir resultam em um código de status de 1.

  • Caracteres não reconhecidos ou de baixa confiança: por padrão, se uma página tiver qualquer caractere de baixa confiança, o Datacap configura o status da página como 1. Os campos com caracteres de baixa confiança são exibidos em amarelo na área de janela de verificação.
  • Falhas de validação: se um campo falhar na validação, o Datacap configura o status do campo como 1 e o status da página como 1 e exibe o campo em vermelho na área de janela de verificação.
    Importante: Quando há uma falha de validação, o Datacap configura o status de todos os objetos pai para 1, incluindo o objeto de lote. Por exemplo, se um subcampo falhar, o Datacap configura o campo pai para 1. O pai do campo (a página) é configurada como 1. O documento-pai da página é configurado para 1. O status do objeto de lote pai é configurado para 1. Há somente um objeto de lote em um lote.

Use a ação Status_Preserve_OFF na biblioteca rrunner para configurar o status corretamente. Essa ação e a ação Status_Preserve_ON relacionada determinam se as regras de validação podem atualizar o status de um objeto.

Biblioteca Ação Descrição
rrunner Status_Preserve_OFF Desativa a configuração Preservação do status de uma página e seus campos-filho, o que significa que as regras de validação podem atualizar o status de um objeto se uma validação falhar.
rrunner Status_Preserve_ON Ativa a configuração Preservação do status de uma página e seus campos-filho, o que significa que as regras de validação não podem mudar o status de um objeto.

Na maioria das situações, você deseja certificar-se de que Preservação do status esteja desativado no início da validação.

A regra de nível de página padrão Validar página no conjunto de regras Validar que é gerado pelo assistente do Aplicativo configura Preservação do status para desativado.

A regra é anexada ao tipo de página padrão, mas deve-se anexá-la manualmente a quaisquer novas páginas criadas.

Lendo a variável de status

Não é possível verificar a variável de status para uma página ou um campo a partir do Datacap Studio. Portanto, deve-se ler os arquivos de dados do lote de tempo de execução:

  • É possível obter o status de cada página a partir do arquivo de dados do perfil da tarefa (por exemplo, Profiler.xml).
  • É possível obter o status de cada campo a partir dos arquivos de dados da página (por exemplo, tm000001.xml).
    Profiler.xml (status da página) tm000001.xml (status do campo)
    <P id="TM000001">
       <V n="TYPE">Rental_Agreement</V>
       <V n="STATUS">1</V>
       <V n="IMAGEFILE">tm000001.tif</V>
       etc.
    </P>
    <F id="Pickup_Date">
       <V n="TYPE">Pickup_Date</V>
       <V n="Position">194,402,563,458</V>
       <V n="STATUS">0</V>
       <C cn="10" cr="203,416,225,438">77</C>
       <C cn="10" cr="230,423,245,438">111</C>
       etc.
    </F>

Em Profiler.xml, uma entrada como <P id="TM000001"> é a definição de página. Em tm000001.xml, uma entrada como <F id="Pickup_Date"> é a definição de campo.