Notas de versão

3.1.0 - preview

Data de lançamento: 1º de abril de 2026

Melhorias

Telemetria aprimorada e rastreamento de consumo

Document Understanding activities now include improved telemetry and consumption tracking capabilities.

3.0.0 - Visualização

Data de lançamento: 25 de fevereiro de 2026

Mudanças de impacto

• O suporte para projetos do Windows-Legacy foi removido. A partir dessa versão, o pacote é compatível apenas com projetos do Windows.
• Starting with this version, upgrading the package requires verifying that any downstream processing using the output of the Extract Document Data activity is still functioning correctly. The structure of the data returned by IXP projects has changed significantly. Therefore, it is strongly recommended to validate that any post-processing logic remains compatible. What has changed:
  • Results are now reported as Field Groups instead of Tables.
  • Os valores agora refletem corretamente o tipo de campo definido no seu projeto IXP de documentos não estruturados.
  • Monetary Quantity is now returned as a dedicated field type.
  • Document Validation tasks automatically display results as Field Groups instead of Tables.
  • Data manipulation logic must be updated to handle Field Group values accordingly.

Novidades

To provide extraction capabilities tailored to a specific non-Latin document layout, you can now use a dedicated modern project type called Predefined Non-Latin Languages in the Extract Document Data activity. This project type offers the following extractors:

• Invoices Japan – Recommended for Japanse invoice documents. The extractor can handle common Japanese invoice layouts, and can identify and extract key invoice fields such as supplier information, invoice number, and currency.
• Invoices China - Recommended for Chinese invoice documents. The extractor can handle common Chinese invoice layouts, and can identify and extract key invoice fields such as supplier information, invoice number, and currency.
• Receipts Japan - Recommended for Japanese receipt documents. You can use the extractor to identify and extract fields such as merchant name, transaction date, total amount, tax, and currency from Japanese-language receipts.

For more information visit Extract Document Data.

2.17.4

Data de lançamento: 16 de março de 2026

Correções de bugs

Fixed an issue where the Classify Document and Extract Document Data activities returned a resource not found error after migrating a DU project. Even when you configured the activities to use a tag, they internally used version numbers to locate classifiers and extractors. Because version numbers reset during migration, the activities could not find the correct resources. The activities now use the configured tag to locate resources. As part of this fix, the ProjectVersionName property is no longer visible in Studio for these activities.

Problema conhecido

After upgrading to UiPath.DocumentUnderstanding.Activities version 2.17.0 or 2.17.4, if Generate Data Type is enabled in Studio Desktop, the Extract Document Data activity may throw the following error: <type> is ambiguous in the namespace <namespace>.

Esse problema será resolvido em uma próxima versão do Studio Desktop.

2.17.0

Data de lançamento: 28 de outubro de 2025

Novidades

Reordenação de páginas dentro de um documento durante a classificação

For greater flexibility, you can now reorder pages within a document, when using the Classification Station. To enable this feature, use the EnablePageReordering property, available in the Create Classification Validation Task and Create Classification Validation Task and Wait activities.

Modo compacto da Estação de validação

Validation Station can now be used with a new face: the Compact Display Mode. This provides more space for fields, easier highlighting for the fields that require attention, a centralized business checks section, and a host of other validator-centric features. To enable the Compact Mode, go to the Create Validation Task or Create Validation Task and Wait activities, and set the DisplayMode input argument to Compact.

Correções de bugs

• Corrigimos um problema em que a seleção de um ativo na atividade Extract Document Data acarretava um erro de tempo de design.
• Corrigidos vários problemas relacionados ao processamento de arquivos por meio da estação de classificação e operações de extração de dados subsequentes em subdocumentos.

Problema conhecido

After upgrading to UiPath.DocumentUnderstanding.Activities version 2.17.0 or 2.17.4, if Generate Data Type is enabled in Studio Desktop, the Extract Document Data activity may throw the following error: <type> is ambiguous in the namespace <namespace>.

Esse problema será resolvido em uma próxima versão do Studio Desktop.

Erratum April 16, 2026: Due to a mishap on our side, this known issue was not made available on the original announcement day.

2.16.1

Data de lançamento: 11 de setembro de 2025

Correções de bugs

Corrigido um bug que fazia com que algumas ações no Action Center se tornassem inválidas. Esse problema só ocorria quando a atividade Extract Document Data era configurada com o Extrator Generativo ou um aplicativo externo.

2.16.0

Data de lançamento: 11 de setembro de 2025

Correções de bugs

Corrigimos um problema no qual o Studio mostrava erros relacionados a tenants ao configurar atividades em Projetos Modernos do Document Understanding com configurações de aplicativos externos.

Problemas conhecidos

Actions in Action Center become invalid when the Extract Document Data activity is configured with either the Generative Extractor or an external application. This issue was fixed in version 2.16.1.

v2.14.0

Data de lançamento: 16 de abril de 2025

Extrair dados do documento pelo tipo de documento classificado: usando um extrator com base no resultado da operação de classificação

In your classic and modern projects you can now use the output of the Classify Document activity within the Extract Document Data activity. This allows you to automatically select the appropriate extractor for processing by identifying the extractor that can process the documents of the type provided for DocumentData.DataType. In the list of extractors, choose Use Classification Result for the suggested extractor. Visit Extract Document Data for more information about using classification results to select an extractor.

Novidades

Recursos de extração aprimorados usando novos extratores

To provide extraction capabilities tailored to a category of documents, you can now use a dedicated modern project type called Generative Predefined. This project type offers the following extractors:

• Long Documents Simple Layout – This is the existent Generative Extractor.
• Long Documents Complex Layout (Preview) – Optimized for long form documents that include images, handwriting, form elements or other complex layouts, such as floating callout boxes. Examples of documents that are suitable for this extractor: insurance policies, or other similar long form documents with complex layouts.
• Short Document Complex Layout (Preview) – Optimized for short documents that include images, handwriting, form elements or other complex layouts like floating callout boxes. For example: identity cards, or healthcare intake forms with complex layouts.

For more information visit Extract Document Data.

Uso de tags e versões para referenciar projetos modernos do Document Understanding

To consume a snapshot of a model, activities and APIs now allow you to consume certain versions of your projects during classification and extraction. The Tag and Version properties provide granular control for consuming a version of a published model. For more information about consuming versions with DocumentUnderstanding.Activities, visit Classify Document and Extract Document Data. For information about exposing the version in your project, visit Document Details. For information on the newly available APIs for consuming tags and versions, visit Discovery APIs and Digitization APIs.

Suporte para atividades de uma configuração local

You can now use the Classify Document and Extract Document Data activities even if the robot is connected to a local Orchestrator. At design-time, you can use Document Understanding resources from different organizations or tenants. Similarly, at runtime, you can execute these activities while connected to a local Orchestrator in Studio.

The new Design-time external connection and Runtime external connection properties allow you to directly use external application credentials, or credentials stored in Orchestrator, to access Document Understanding resources during design-time or runtime.

Observação:

Ensure your selected tenant has Document Understanding enabled. If you create a runtime external connection, then make sure that you also allocate AI Units to the selected tenant.

Melhorias

• For the Generative Predefined project, the existent Generative Extractor is now called Long Document Simple Layout Extractor.
• When selecting an extractor for the Generative project types, the former Prompt collection in the Classify Document and Extract Document Data activities, has been renamed to Document Type details, which describes the purpose of the collection more accurately.
  • Inside the updated Document Type details collection, the former Generative prompt column is now Instruction. The Instruction field represents the instructions you want to offer about the information that should be extracted for a certain field name.For more information about the updates, check the Classify Document and Extract Document Data activities.
• A parte de digitalização de seus fluxos de trabalho de processamento de documentos agora pode reconhecer e retornar dados de documentos que contêm valores circulados, sublinhados ou riscados.

v2.12.1

Data de lançamento: 19 de novembro de 2024

Correções de bugs

Um processo de classificação e extração de longa duração falhava devido a um tempo limite padrão. Agora, estamos considerando a soma de todos os tempos limite definidos nas atividades como um tempo limite global para todas as operações nos bastidores. Além disso, melhoramos a mensagem de erro para esclarecer melhor a causa da falha nessa situação específica.

v2.4.5

Data de lançamento: 21 de outubro de 2024

Correções de bugs

This version resolves the Unknown sections in the AI Units consumption overview dashboard that were caused by missing data.

v2.9.6

Data de lançamento: 14 de outubro de 2024

Correções de bugs

This version resolves the Unknown sections in the AI Units consumption overview dashboard that were caused by missing data.

v2.12.0

Data de lançamento: 3 de outubro de 2024

Novidades

Desabilite a geração de Dados do Documento sob demanda, para flexibilidade aprimorada em implementações avançadas.

You can now change the output type of the Extract Document Data activity using the new Generate Data Type property. When you set this property to False, the output type changes from IDocumentData<ExtractorType> to IDocumentData<DictionaryData>. Setting Generate Data Type to Flase simplifies retrieving and changing field values, and allows you to change the document type in the Validation Station.

Visit the Extract Document Data and Document data pages to check how to use the Generate Data Type property and what methods you can use to access the extraction results.

Melhorias

You can now set the Orchestrator storage bucket to work with Additional options for the Create Classification Validation Task and Create Classification Validation Task and Wait activities. If there is no specific storage bucket created, you can create a default one.

Correções de bugs

• A execução de um fluxo de trabalho do Studio Web em um robô Mac falhou com a seguinte exceção: "Não foi possível carregar arquivo ou montagem 'UiPath.DocumentUnderstanding.Common.SDK'".
• As atividades responsáveis por criar tarefas do Action Center travavam ao corrigir manualmente certos números ou datas em um documento.
• Corrigido um erro que ocorria no Studio Web ao retomar um fluxo de trabalho. Anteriormente, esse erro acontecia após a primeira validação de uma classificação de documentos, que envolvia recuperar arquivos do Microsoft OneDrive e validá-los no Action Center.

v2.2.6

Data de lançamento: 3 de outubro de 2024

Melhoramos a estabilidade do produto atualizando nossas dependências comuns para as versões mais recentes. Essa atualização é automática e não requer nenhuma ação de sua parte.

v2.9.5

Data de lançamento: 31 de julho de 2024

Correções de bugs

When attempting to load a document attached to an entity in UiPath® Apps, workflows in Studio Web that use the Extract Document Data activity no longer result in a "System.InvalidOperationException" error.

v2.9.4

Data de lançamento: 12 de julho de 2024

Correções de bugs

Corrigido o problema que fazia com que a classificação de documentos falhasse com o erro “Um URI de solicitação inválido foi fornecido”.

v2.9.3

Data de lançamento: 20 de junho de 2024

Correções de bugs

As atividades responsáveis por criar tarefas do Action Center travavam ao corrigir manualmente certos números ou datas em um documento.

v2.4.3

Data de lançamento: 5 de junho de 2024

Melhoramos a estabilidade do produto atualizando nossas dependências comuns para as versões mais recentes. Essa atualização é automática e não requer nenhuma ação de sua parte.

v2.9.2

Data de lançamento: 5 de junho de 2024

Melhoramos a estabilidade do produto revisando certas dependências.

v2.9.1

Data de lançamento: 27 de maio de 2024

Melhorias

• Aumento do tamanho da solicitação de 500 para 1000 caracteres por pergunta, para maior clareza em suas instruções. Além disso, se você atingir o limite de tamanho da solicitação de 1000 caracteres por pergunta, receberá um erro de "Limite excedido".
• As mensagens de erro para a atividade Extract Document Data foram aprimoradas para maior clareza e facilidade de depuração.

Correções de bugs

• The document type remained as Unknown in the Validation Station after using the Generative Extractor and Generative Classifier activities, or after manually assigning the document type.

v2.9.0

Data de lançamento: 29 de abril de 2024

Estas notas de versão contêm todas as atualizações feitas entre novembro de 2023 e março de 2024.

Observação:

In case of upgrading from version earlier than v.2.4.1, make sure to reopen the workflow after upgrading the UiPath.DocumentUnderstanding.Activities package.

Novidades

Melhoria da confiança na extração para Extract Document Data

We've improved our Extract Document Data activity to increase score accuracy and decrease validation time. This enhancement the Auto-validation and Confidence threshold properties, enabling the cross-verification of extraction results from specific models against a generative model.

Visit Extract Document Data to learn how to increase your extraction confidence levels.

Tarefas de validação de classificação

Temos o prazer de anunciar que as seguintes atividades já estão disponíveis:

• Create Classification Validation Task: Allows you to create a validation task in Action Center.
• Create Classification Validation Task and Wait: Allows you to create a validation task in Action Center and pause the workflow until completion.
• Wait for Classification Validation Task and Resume: Allows you to suspend the execution of the current workflow until a specified document validation action is completed.

Melhorias

• You can now set the Orchestrator storage bucket to work with Additional options for the Create Validation Task and Wait and Create Validation Task activities. If there is no specific storage bucket created, you can create a default one.
• The optional Timeout property is now available for the Extract Document Data and Classify Document activities. This parameter configures a timeout for the activities.
• The selected extractor in the Extract Document Data activity now overrides the document type. Doesn't apply to generative models.
• In case of multi-value fields, all values are returned under Document Data for the Extract Document Data activity. The values are available in DocumentData.Data.FieldName.MultiValues[].
• This release brings the following updates to the Document Data object:
  • The Name property from the Document Type attribute is replaced with the following:
    • DisplayName for custom models
    • ID for out-of-the-box models
  • Duas novas propriedades são adicionadas, preenchidas a partir do resultado da estrutura do Document Understanding:
    • ID
    • NomeDeExibição

Restrições conhecidas

Os painéis existentes do Document Understanding Insights, atualmente em visualização, não exibem mais dados do pacote DocumentUnderstanding.Activities multiplataforma. Eles agora relatam apenas dados de fluxos de trabalho IntelligentOCR.Activities.

Os dados do DocumentUnderstanding.Activities multiplataforma agora são relatados em um novo painel separado do Insights.

Correções de bugs

• The ClassificationResults output property of the Create Classification Validation Task activity is renamed to DocumentData. CAUTION:
  Observação:

  A propriedade CreatedClassificationValidationTask.ClassificationResults não estará disponível após a atualização se estiver em seu fluxo de trabalho atual.

• The output property ExtractionResults of the Create Validation Task activity is renamed to DocumentData. CAUTION:
  Observação:

  Caso seu fluxo de trabalho use a propriedade CreatedDocumentValidationTask.ExtractionResults , ela não estará disponível após a atualização.

• Fixed an issue where the Wait for Validation Task and Resume activity didn't recognize numbers in the 3.1342,7 format, causing an "Input string was not in correct format" error. All number formats are now fully supported.

v2.4.2

Data de lançamento: 10 de abril de 2024

Correções de bugs

Resolved an issue where the Extract Document Data activity opened with an error that could not be reviewed because the activity didn't expand.

v2.4.1

Data de lançamento: 1º de setembro de 2023

Disponibilidade geral de funcionalidades generativas

É com grande satisfação que anunciamos que as funcionalidades generativas UiPath.DocumentUnderstanding.Activities agora estão em disponibilidade geral. Isso inclui o seguinte:

• Atividade Classificar documento
• Atividade Extrair dados de documento

Novos recursos e melhorias

O pacote UiPath.DocumentUnderstanding.Activities agora é compatível com sistemas macOS.

A new property, Extracted fields validation confidence %, is added for the following activities:

• Criar tarefa de validação e aguardar
• Aguarde a tarefa de validação de documentos e retome

v2.4.0

Data de lançamento: 11 de outubro de 2023

Disponibilidade geral das atividades Document Understanding

Estamos animados em anunciar que o pacote UiPath.DocumentUnderstanding.Activities agora está em disponibilidade geral.

Observação:

Generative features are still in public preview.

v2.2.4

Data de lançamento: 28 de setembro de 2023

Novos recursos e melhorias

O pacote UiPath.DocumentUnderstanding.Activities agora é compatível com sistemas macOS.

v2.2.3

Data de lançamento: 11 de maio de 2023

Correções de bugs

• Corrigimos um bug que fazia com que a atividade Extract Document Data parasse de carregar quando um modelo era usado.
• We fixed a bug where ActionCatalog fields wouldn't work for Create Document Validation Action and Create Validation Task and Wait activities.
• We fixed a bug that was causing an error when Classify Document activity was used in a workflow.

v2.2.2

Data de lançamento: 11 de maio de 2023

Correções de bugs

Corrigimos um bug no qual os usuários recebiam um erro ao tentar usar o valor de um campo extraído com a atividade Extract Document Data e o valor não estava presente.

Problemas conhecidos

O pacote UiPath.DocumentUnderstanding.Activities não é compatível com sistemas macOS.

v2.2.1

Data de lançamento: 5 de maio de 2023

New features and Improvements

The Extract PDF Text activity is the latest addition to the package, allowing you to extract all characters from a specified PDF file and store it in a string variable. When the Apply OCR option is enabled, it extracts the information using OCR, and when disabled it extracts the native content.

Duas atividades tiveram seus nomes atualizados e uma atividade atualizou os campos:

• Create Document Validation Task became Create Validation Task.
• Wait for Document Validation Task and Resume became Wait for Validation Task and Resume.
• Set PDF Password now offers more detailed field names, such as:
  • Nova senha de gerenciamento
  • Nova senha de abertura
  • Senha de gerenciamento atual
  • Senha de abertura atual