Entidades en soluciones

Ciclo de vida de la entidad de Data Fabric en Soluciones, que abarca la inclusión automática de dependencias, la gestión de la instalación, la actualización y la desinstalación, y las anulaciones de entidades en la depuración y el runtime.

Las entidades de Data Fabric se pueden incluir como recursos en una solución. Cuando utilizas una entidad a nivel de carpeta en un flujo de trabajo que pertenece a una solución, la entidad y sus dependencias se empaquetan, implementan y gestionan como parte del ciclo de vida de la solución.

Esta página cubre cómo se comportan las entidades en cada etapa, desde el modelado hasta la implementación, el runtime, la actualización y la desinstalación.

Cómo una entidad se convierte en un recurso de solución

Cuando añades una actividad de Data Service a un flujo de trabajo dentro de una solución y seleccionas una entidad a nivel de carpeta, esa entidad se registra automáticamente como recurso de solución. No es necesario añadirlo manualmente.

Inclusión automática de dependencias

Añadir una entidad como recurso de solución también incluye todas sus dependencias. Las dependencias incluidas difieren en función del tipo de entidad.

Entidades nativas

• Entidades relacionadas : si la entidad A tiene un campo de relación que apunta a la entidad B, ambas entidades se añaden como recursos de solución.
• Conjuntos de opciones : se incluye cualquier conjunto de opciones utilizado como tipo de campo en la entidad.
• Dependencias anidadas : si la propia Entidad B hace referencia a la Entidad C, esa entidad también se incluye. La cadena de dependencias completa se resuelve automáticamente.

Entidades federadas

• Conexiones : se incluyen las conexiones de Integration Service utilizadas por la entidad federada.
• Entidades de origen nativas : si una entidad federada hace referencia a una entidad nativa como fuente de datos, se incluyen esa entidad nativa y su cadena de dependencia completa.

Nota:

Las entidades a nivel de tenant utilizadas en un flujo de trabajo no se empaquetan automáticamente. Ya deben existir en el entorno de destino para que funcione el flujo de trabajo implementado. Solo las entidades a nivel de carpeta se incluyen como recursos de solución.

Superficies compatibles

Las entidades de Data Fabric en Soluciones son compatibles con los siguientes tipos de flujo de trabajo:

Superficie	Entidades de ámbito de carpeta	Notas
RPA (Studio Web)	✅	Soporte completo para compilar, depurar e implementar
RPA (Studio Desktop 26.10 LTS)	✅	Solo contexto de soluciones. Las actividades clásicas requieren UiPath.DataService.Activities v26.10.0
Maestro BPMN	✅
Caso de Maestro	✅
Flujos de trabajo de API	✅
Agents	✅ (Vista previa)
Flujo de Maestro	A través de nodos de entidad nativos	Utiliza nodos integrados, no actividades de conector
Coded Apps	✅
Agentes de codificación	✅
Aplicaciones VB Standalone Apps	❌
RPA (UB) Apps	❌

Nota:

El espacio de trabajo local no es compatible con las entidades de ámbito de carpeta a través de las actividades del conector de Data Service. El ámbito de la carpeta solo está disponible en los espacios de trabajo en la nube.

Ciclo de vida

1. Crear y modelar entidades

Crea entidades en el nivel de carpeta en la IU de Data Fabric. Establece la Ubicación en Carpeta y selecciona la carpeta de destino de Orchestrator. Puedes crear tanto entidades nativas como entidades federadas. Añade campos, relaciones y conjuntos de opciones según sea necesario.

Para las reglas de ámbito de relación, consulta Crear relaciones. Para la configuración de la entidad federada, consulta Entidades virtuales.

2. Crea un flujo de trabajo

En Studio Web o Studio Desktop (26.10 LTS), añade actividades de Data Service a tu flujo de trabajo. Cada actividad tiene un selector de ámbito : elige Carpeta para trabajar con entidades de ámbito de carpeta.

El ámbito de carpeta en las actividades clásicas requiere UiPath.DataService.Activities v26.10.0 o posterior, donde está disponible de forma general. Para obtener más información, consulta Actividades clásicas.

Solo se muestran las entidades de las carpetas a las que tienes acceso.

3. Depurar

Al depurar un flujo de trabajo dentro de una solución, la ventana Configuración de depuración muestra todos los recursos de la solución, incluidas las entidades.

Para cada entidad, puedes:

• Usar la entidad existente : la depuración se ejecuta en la entidad en su carpeta actual.
• Anular con una entidad diferente : selecciona una entidad compatible de otra carpeta.
• Eliminar la selección : se crea una nueva entidad en una carpeta de depuración en tu espacio de trabajo personal, junto con sus dependencias.

La anulación solo está disponible para las entidades a las que se hace referencia directamente desde una actividad. Una entidad relacionada (por ejemplo, la Entidad B referenciada por la Entidad A a través de un campo de relación) no se puede anular a menos que añadas una actividad independiente que haga referencia a ella directamente desde Recursos de la plataforma.

Nota:

Al anular, asegúrate de que la entidad de reemplazo tenga un esquema compatible. Las relaciones no coincidentes o los campos faltantes pueden causar errores durante la ejecución.

4. Publicar

Publicar la solución desde Studio Web o Studio Desktop. El paquete incluye el flujo de trabajo, los esquemas de entidad, los conjuntos de opciones y las relaciones. Solo se empaqueta el esquema, no se incluyen datos.

5. Implementar (instalar)

Implementa el paquete en una carpeta de destino desde Orchestrator o desde Studio Web.

Durante la implementación:

• Las entidades a nivel de carpeta se crean automáticamente en la carpeta de destino.
• Se vuelven a crear conjuntos de opciones y relaciones.
• El flujo de trabajo está vinculado a las entidades recién creadas.

Solo se crea el esquema. Los datos existentes no se copian. Cada entorno mantiene sus propios datos.

Importante:

No se admite la creación de entidades en línea durante la implementación. Las entidades se crean a partir del esquema definido en el paquete de soluciones. Si necesitas crear entidades fuera de una solución, utiliza la IU de Data Fabric.

6. Ejecutar (runtime)

Después de la implementación, ejecuta el flujo de trabajo desde Orchestrator. La automatización interactúa con las entidades en la carpeta de destino, exactamente como lo hizo durante el desarrollo.

Anulaciones de runtime a través de los requisitos del paquete

Después de implementar una solución, puedes cambiar qué entidad utiliza un flujo de trabajo sin volver a publicar. En Orchestrator, navega hasta el proceso implementado y abre la pestaña Requisitos del paquete . Reemplaza una entidad por otra entidad compatible de la misma carpeta o de una carpeta diferente.

La entidad de reemplazo debe tener un esquema compatible. El flujo de trabajo se ejecuta utilizando la entidad anulada mientras toda la lógica permanece sin cambios.

Solo las entidades a las que se hace referencia directamente desde una actividad aparecen en Requisitos del paquete para anularlas.

Nota:

No se admite la anulación del tiempo de implementación. Las anulaciones de entidad están disponibles durante la depuración y en tiempo de ejecución a través de Requisitos del paquete.

7. Actualizar

Al modificar el esquema de la entidad (por ejemplo, añadir un nuevo campo), vuelve a publicar la solución y actualiza la implementación en Orchestrator.

Durante la actualización:

• El esquema de la entidad se actualiza en la carpeta de destino para que coincida con la nueva versión.
• Los datos existentes se conservan: no se eliminan ni se sobrescriben registros.
• Se añaden nuevos campos al esquema. Los campos eliminados se eliminan del esquema, pero se conservan los datos subyacentes.
• Si la entidad ya contiene datos, puedes revisar qué cambios se aplican antes de confirmar la actualización.
• Si los cambios de esquema son incompatibles (por ejemplo, un cambio de tipo de campo), la actualización muestra un conflicto. Navega a la IU de Data Fabric para revisar y resolver el conflicto entre los esquemas de entidad de origen y destino antes de volver a intentar la actualización.

8. Desinstalar

Al desinstalar una solución se elimina el flujo de trabajo y los recursos asociados de la carpeta de destino.

El comportamiento de la entidad durante la desinstalación depende de si la entidad contiene datos:

• Entidades sin datos : eliminadas junto con sus conjuntos de opciones y relaciones.
• Entidades con datos : conservados para evitar la pérdida accidental de datos. La entidad permanece en la carpeta y se puede administrar directamente en la IU de Data Fabric, a menos que se elimine la carpeta.

Resumen del comportamiento del ciclo de vida

Operación	Esquema de entidad	Datos de la entidad	Conjuntos de opciones	relaciones
Instalar	Creado en la carpeta de destino	No copiado: comienza vacío	Recreado	Recreado
Actualizar	Actualizado para que coincida con la nueva versión	Conservado	ha actualizado	ha actualizado
Desinstalar (sin datos)	eliminado	N/D	eliminado	eliminado
Desinstalar (contiene datos)	Conservado	Conservado	Conservado	Conservado

Actualización del esquema

Cuando un esquema de entidad cambia en Data Fabric después de haberlo seleccionado en una actividad, utiliza el botón Actualizar junto al selector de entidades en Studio Web. El botón Actualizar actualiza el esquema de la entidad seleccionada y todas sus entidades relacionadas en una sola acción.

• Actividades del conector (conector de Data Fabric) : el botón Actualizar siempre está habilitado. Para ver los campos recién añadidos o eliminados, primero abre el recurso de solución para la entidad y selecciona Actualizar configuración, luego vuelve a la actividad y selecciona Actualizar esquema.
• Actividades heredadas (paquete clásico de Data Service) : para las entidades nativas, el botón Actualizar solo se habilita cuando se detecta un cambio de esquema para la entidad seleccionada. Al seleccionarlo se actualiza el esquema directamente. La actualización de esquema para entidades federadas no es compatible con estas actividades.

Clonar entidades en todos los ámbitos

Puedes copiar un esquema de entidad de un ámbito a otro utilizando la exportación e importación. Por ejemplo, para utilizar un diseño de entidad a nivel de tenant en una carpeta, exporta el esquema desde el nivel de tenant en la IU de Data Fabric, que exporta todos los esquemas de entidad nativos a nivel de tenant a la vez. A continuación, importas ese archivo en el nivel de carpeta de destino, eligiendo cuáles de las entidades exportadas y conjuntos de opciones traer a la carpeta.

Las entidades seleccionadas se crean en la carpeta de destino con el mismo esquema. No se copian datos. Para obtener el procedimiento detallado de exportación e importación, consulta Exportación e importación de esquemas.

Limitaciones conocidas

Las entidades a nivel de carpeta en Soluciones conllevan limitaciones en las anulaciones de tiempo de implementación, las relaciones entre ámbitos, la denominación de entidades y las superficies no compatibles. Para obtener la lista completa, consulta Limitaciones conocidas.