Uso de entidades no nível da pasta no Studio

Entidades do Data Fabric no nível da pasta no Studio Web e Studio Desktop para criar fluxos de trabalho dentro de uma solução.

As entidades do Data Fabric no nível da pasta estão disponíveis no Studio Web e Studio Desktop (26.10 LTS) ao trabalhar dentro de uma Solução. Nas atividades clássicas, o escopo da pasta requer UiPath.DataService.Activities v26.10.0 ou posterior, onde está disponível de forma geral. Esta página aborda como selecionar e configurar entidades no ambiente do Studio. Para o ciclo de vida completo — empacotamento, implantação, substituições, atualização e desinstalação — consulte Entidades em Soluções.

Seleção de um escopo de entidade

Cada atividade do Data Service inclui um seletor de escopo. O escopo determina quais entidades estão disponíveis:

• Tenant — Mostra entidades disponíveis em todo o tenant.
• Pasta — Mostra uma árvore de todas as pastas do Orchestrator às quais você tem acesso, junto com as entidades em cada pasta.

Observação:

O escopo da pasta não está disponível em um espaço de trabalho local em nenhuma superfície. Está disponível apenas em espaços de trabalho em nuvem.

Atualização do esquema

Um botão Atualizar está disponível ao lado do seletor de entidades. Selecionar Atualizar atualiza o esquema da entidade selecionada e todas as suas entidades relacionadas (entidades filhas) em uma única ação.

O botão Atualizar comporta-se de maneira diferente dependendo do tipo de atividade:

• Atividades do conector (conector do Data Fabric) — O botão Atualizar está sempre habilitado. Para ver campos recém-adicionados ou removidos após uma alteração de esquema:
  1. Abra o recurso da Solução para a entidade e selecione Atualizar Configuração para puxar o esquema mais recente para a Solução.
  2. Retorne à atividade e selecione Atualizar Esquema para carregar os campos atualizados.
• Atividades clássicas (pacote clássico do Data Service) — O botão Atualizar é habilitado apenas quando uma alteração de esquema é detectada para a entidade selecionada. Selecioná-la atualiza o esquema diretamente.

Inclusão automática de recursos

Quando você usa uma entidade no nível da pasta em uma atividade do Data Service dentro de uma Solução, a entidade é adicionada automaticamente como um recurso da Solução. Todas as dependências — entidades relacionadas, conjuntos de escolhas e suas dependências aninhadas — são incluídas automaticamente. Você não precisa adicioná-las manualmente.

Studio Web

• Selecione o escopo da pasta na atividade para trabalhar com entidades com escopo de pasta.
• As entidades no nível da pasta usadas em fluxos de trabalho são adicionadas automaticamente à Solução.
• Durante a depuração, você pode substituir associações de entidades, usar entidades existentes ou criar novas em seu Espaço de trabalho pessoal.

StudioDesktop

O Studio Desktop 26.10 LTS é compatível com entidades no nível da pasta ao trabalhar com Soluções. Use o mesmo seletor de escopo para escolher entre entidades de tenant e de pasta. Isso requer UiPath.DataService.Activities v26.10.0 ou posterior.

Observação:

O suporte ao Studio Desktop aplica-se a entidades no nível da pasta usadas em um contexto de Soluções.

Substituições de depuração e runtime

As substituições de entidades estão disponíveis em dois estágios:

Durante a depuração — Na janela Configuração de depuração, você pode manter a entidade existente, substituí-la por uma entidade compatível de outra pasta ou remover a seleção para criar uma nova entidade em seu Espaço de trabalho pessoal.

No runtime — Após a implantação, altere as associações de entidades no Orchestrator por meio dos Requisitos do pacote sem republicar.

A substituição do tempo de implantação não é compatível.

A substituição está disponível apenas para entidades referenciadas diretamente de uma atividade. Uma entidade relacionada (por exemplo, Entidade B referenciada por meio de um campo de relacionamento) não é substituída, a menos que você adicione uma atividade separada que faz referência a ela diretamente em Recursos de plataforma.

Observação:

• Substituir permite o mapeamento para uma entidade compatível de uma pasta diferente. O mapeamento entre tenants não é compatível.
• Certifique-se de que a entidade de substituição mantenha relacionamentos de esquema compatíveis para evitar erros de incompatibilidade.

Superfícies compatíveis

Superfície	Entidades no escopo de pastas
RPA (Studio Web)	✅
RPA (Studio Desktop 26.10 LTS)	✅ (Contexto das soluções, UiPath.DataService.Activities v26.10.0)
BPMN do Maestro	✅
Caso do Maestro	✅
Fluxos de trabalho da API	✅
Agents	✅ (Pré-visualização)
Fluxo do Maestro	Via nós de entidade nativos
Apps codificados	✅
Agentes de codificação	✅
Apps VB independentes	❌
RPA (UB) Apps	❌
Espaço de trabalho local	❌