Repository: dominios, carpetas y ubicación de objetos
Objetivo y modelo
Repository organiza el trabajo dentro del tenant mediante Domains y Folders. Un Domain delimita una agrupación funcional; una Folder pertenece a un único Domain. Mappings, Sessions, Workflows y Connections conservan una ubicación que ayuda a encontrarlos y a comprender sus relaciones.
La jerarquía no crea un tenant adicional ni elimina los controles de acceso. Compartir un objeto mediante Shared within tenant amplía su disponibilidad dentro del tenant según el alcance autorizado; no lo publica para otras organizaciones. El Domain propietario siempre forma parte del alcance del objeto.
Requisitos y navegación
Entre con permisos de consulta del repositorio. Las acciones de creación, edición o eliminación requieren privilegios adicionales; su ausencia en pantalla no implica que la interfaz esté incompleta. Confirme tenant y rol antes de operar sobre una jerarquía.
El explorador permite consultar categorías como All, Mappings, Sessions, Workflows, Connections y Shared. Use la categoría y la ubicación conjuntamente: un objeto puede existir y no aparecer porque se está mirando otra Folder o un filtro distinto.
Crear una estructura de laboratorio
- Abra Repository.
- Inicie New domain y escriba
Laboratorio ETL. - Añada una descripción que indique que los datos son sintéticos y que la estructura no recibe cargas productivas.
- Cree una Folder, seleccione el Parent domain correspondiente y use
Clientes Demo. - Abra la nueva ubicación y compruebe que el breadcrumb y la lista corresponden al Domain esperado.
- Al crear un Mapping, seleccione esa misma ubicación en sus campos Domain y Folder.
| Campo | Contrato visible |
|---|---|
| Name | Entre 2 y 80 caracteres: letras, números, espacios, guion o guion bajo |
| Description | Opcional, hasta 1.000 caracteres |
| Parent domain | Necesario para una Folder; establece su único Domain propietario |
Los nombres de objetos ejecutables tienen su propia validación. No aplique automáticamente las reglas de nombre de Domain a un Mapping o una Session.
Estado de una Folder
Antes de editar o ejecutar, revise el estado de la carpeta propietaria:
| Estado | Efecto |
|---|---|
| Active | Edición y ejecución disponibles, sujetas a permisos y demás requisitos. |
| Frozen | Artefactos de sólo lectura; las ejecuciones publicadas siguen disponibles. |
| Closed | Artefactos de sólo lectura y ejecución bloqueada. |
Congelar no equivale a cerrar. Una carpeta Closed no se vuelve ejecutable por cambiar filtros o abrir el objeto desde Shared. Solicite al responsable autorizado la transición de estado correspondiente; no duplique el artefacto para eludir una restricción de ciclo de vida.
POC: ubicación y compartición controlada
Cree dos Folders dentro del Domain de laboratorio: Origen y Consumo. Guarde un Mapping de prueba en Origen. Localícelo mediante la categoría Mappings y confirme que su editor muestra la ubicación elegida.
Si su rol permite compartir, active Shared within tenant en el editor. Seleccione un alcance autorizado y guarde conforme al ciclo del objeto. Desde una ubicación consumidora permitida, busque el objeto en Shared. Resultado esperado: el objeto es localizable dentro del alcance concedido y mantiene su ubicación propietaria; no se duplica ni cambia de tenant por aparecer como compartido.
Para completar la prueba, un usuario sin el permiso necesario debe conservar la restricción de acceso. No altere controles de autorización ni utilice otro tenant real para simular esta comprobación.
Validación y recuperación
Cuando una lista esté vacía, descarte filtros activos y vuelva a la ubicación superior. Ante un error de nombre, corrija el campo señalado sin recrear toda la estructura. Si una eliminación se rechaza por referencias, revise las dependencias y resuelva primero los consumidores; no presuponga una eliminación en cascada.
Documente el identificador y la ubicación del objeto antes de reorganizarlo. Los nombres ayudan a las personas, pero las referencias entre objetos no deben interpretarse como simples rutas de archivo.
Relaciones y límites
Continúe con Mappings, Sessions y Workflows. La organización del repositorio es distinta de las rutas de archivos resueltas por una Session en el worker. La POC describe resultados esperados; requiere validación en su laboratorio antes de emplearse como evidencia de aceptación.