Dados do documento

Dados de documento são um recurso que serve tanto como uma variável de entrada quanto de saída, em seus fluxos de trabalho do Document Understanding. O objeto Dados do documento contém todas as informações necessárias sobre um único documento. Se você classifica um documento, o objeto inclui o Tipo de documento. Se você extrair dados, o objeto contém os campos extraídos correspondentes. Independentemente da atividade, os Dados do documento contêm consistentemente o texto e o DOM (Modelo de objeto do documento) do documento.

Com o Document Data você pode: coletar todas as informações necessárias sobre um documento em uma variável, salvar dados em cada propriedade do objeto e reutilizá-lo para outras atividades no fluxo de trabalho.

Dados de documentos contêm informações sobre os seguintes atributos:

• TipoDeDocumento: fornece dados sobre o tipo de documento identificado, preenchido por atividades como Classify Document ou Create Classification Validation Task.
• Dados: contém os valores do campo extraídos. É gerado sob demanda pela propriedade Gerar Dados , que gera um tipo de saída de IDocumentData<ExtractorType>. Quando a propriedade Gerar dados está definida como False, você pode acessar os valores de campo extraídos somente por meio de métodos do tipo Get.
• DetalhesDoArquivo: contém detalhes sobre o IResource.
• SubDocumentos: inclui uma coleção de Dados de Documentos, preenchido por atividades como Create Classification Validation Task.
• MetadadosDoDocumento : contém informações sobre o processamento do documento, como:
  • Idioma detectado do texto
  • Campos extraídos como Tabela de Dados
  • Modelo de objeto do documento (DOM): contém o modelo de objeto do documento, que é usado por todas as atividades.
  MetadadosDoDocumento é atualizado pela atividade que processa o documento primeiro. Após preenchidos, os metadados são compartilhados e usados por todas as atividades sucessoras que recebem o objeto Dados de documento.
  Dica: a menos que uma atividade seja a primeira parte da atividade do Document Understanding de um fluxo de trabalho do Studio, use Dados do documento como entrada. Use a variável Arquivo como entrada apenas se a atividade for a primeira parte do Document Understanding de um fluxo de trabalho do Studio.

Compreensão e acesso a dados

Dados do documento contêm informações detalhadas sobre os resultados da extração. Os Dados podem ser de dois tipos, dependendo se você escolher gerá-los sob demanda, para poder utilizá-los posteriormente em seu fluxo de trabalho, ou não gerá-los, podendo executar métodos get e set neles, criados para implementações avançadas, para aumentar a flexibilidade.

A propriedade Gerar tipo de dados na atividade Extract Document Data permite que você escolha se os dados serão gerados sob demanda ou não. Consulte os seguintes cenários:

• Quando você define Gerar tipo de dados como True (a configuração padrão): dados do documento são gerados como IDocumentData<ExtractorType>. Esses dados são gerados sob demanda e mudam com base em modificações feitas na atividade Extract Document Data. Com essa configuração, você não pode alterar o tipo de documento na Estação de Validação, e o JIT (Just in Time) é selecionado por padrão.
• Quando você define Gerar tipo de dados como False: Saídas de dados do documento como IDocumentData<DictionaryData>. Com essa configuração, a propriedade Dados do documento não será mais gerada e você não poderá navegar por ela.

  Você pode acessar seus dados usando métodos específicos, dependendo do ID do campo. Esses IDs ficam disponíveis ao configurar o tipo de documento ou ao recuperar as informações usando APIs. Visite Editando ou adicionando novos campos e Obter a API de solicitação de extração para mais informações.

  • Quando você define Gerar tipo de dados como False para extração generativa, os campos recuperados correspondem aos nomes fornecidos no prompt. Por exemplo, se o nome do campo no prompt for definido como a b c (incluindo os espaços), você deve usar o mesmo que o ID do campo ao usar os métodos específicos.

Passando dados do documento para atividades

Quando você usa Dados do documento, o primeiro objeto de saída é criado a partir do seu arquivo de entrada. Após criar esse objeto, recomendamos que você passe ele para as suas próximas atividades. Ao passá-lo para suas próximas atividades, você pode reutilizar o Text e o DOM do seu arquivo original. Essa abordagem evita o trabalho de digitalizar o arquivo a cada vez.

Consumo dos resultados da extração para campos de valor único e vários

Se você configurar um campo de tipo de documento para ter vários valores, o sistema espera vários valores. Um exemplo pode ser uma pergunta de múltipla escolha em um formulário. Os resultados aparecem no atributo de vários valores no campo, retornados como uma lista. Se o campo de tipo de documento estiver configurado para ser de valor único, o sistema retornará o resultado no atributo de valor no campo por padrão.

A seguinte tabela mostra como os Dados de documento retornam campos de valor único e múltiplo:

Tabela 1. Os valores retornados por Dados de documentos para campos de valores únicos e múltiplos

	não tem valor	Tem um valor	Tem dois ou mais valores	DocumentData.Data.FieldName.Value	DocumentData.Data.FieldName.MultiValues
Valor Único	Sim	Não	N/A	“”	null
Valor Único	Não	Sim	N/A	<value that was identified>	null
Multivalor	Sim	Não	Não	“”	[] (matriz vazia)
Multivalor	Não	Sim	Não	<value that was identified>	[<array com um valor idêntico ao do .Value>]
Multivalor	Não	Não	Sim	<first value that was identified>	[<array com n valores, com o primeiro valor sendo idêntico ao .Value>]

Retornando campos extraídos como uma tabela de dados

É possível retornar os campos extraídos de um documento como uma Tabela de dados, usando o objeto Dados do documento. Então, você pode usar a variável Data Table dentro das atividades do Excel.

Para retornar os campos extraídos como uma Tabela de dados, escolha a saída ResultsAsDatatable para a atividade Extract Document Data .

Propriedades

As propriedades da variável Dados do documento podem ser preenchidas e consumidas por uma ou várias atividades. Dependendo da atividade que preenche a variável, as propriedades podem diferir. Verifique a lista a seguir:

• A atividade DocumentType - Classify Document preenche os seguintes valores:
  • NomeDeExibição (usado para modelos personalizados): nome do Tipo de documento.
  • ID (usado para modelos prontos para uso): nome do Tipo de documento.
  • Confiança: confiança na classificação.
  • URL: URL de onde o Tipo de Documento está acessível; isso pode ser personalizado ou predefinido, referenciado por meio do respectivo projeto no centro do Document Understanding.
• Campos - Extract Document Data, Create Validation Task, Create Validation Task and Wait, Wait for Validation Task e Resume preenchem os seguintes valores:
  • Valor do campo: valor de extração do campo.
  • Pontuação de confiança da extração: pontuação de confiança da extração, conforme fornecido pelo modelo.
  • Pontuação de confiabilidade de OCR: pontuação de confiabilidade fornecida pelo mecanismo de OCR.
• Detalhes do arquivo — as atividades que criam o objeto de dados do documento, e recebem um arquivo como entrada, preenchem os seguintes valores:
  • Nome completo: nome completo do arquivo.
  • Extensão: extensão do arquivo.
  • Intervalo de Páginas: intervalo de páginas do arquivo.
• Subdocumentos: coleção de dados de documentos, preenchida pela atividade Classify Document .
  Observação: isso não é preenchido atualmente e será adicionado no futuro, juntamente com a validação de classificação e recursos de divisão.
• DocumentMetaData:
  • DOM: o modelo de objeto do documento, usado por todas as atividades. (preenchido por atividades criando o objeto de dados de documento, recebendo um arquivo como entrada.)
  • Texto: todo o texto extraído. (preenchido por atividades criando o objeto de dados de documento, recebendo um arquivo como entrada.)
  • Idioma: o idioma detectado no documento. (preenchido por atividades criando o objeto de dados de documento, recebendo um arquivo como entrada.)
  • Confiança de divisão: se o documento for dividido, o documento será retornado pelo modelo de divisão. (preenchido pela atividade Classify Document )
    Observação: isso não é preenchido atualmente e será adicionado no futuro, juntamente com a validação de classificação e recursos de divisão.
  • Resultados como Tabelas de dados: campos exportados como Tabela de dados. (preenchido pela atividade Extract Document Data ).