Conexiones de Proyecto
Las Conexiones de Proyecto permiten que los objetos de un mismo Proyecto utilicen una conexión compartida sin asociarla a los Roles de la aplicación. Son objetos del Catálogo Studio y se crean y gestionan en el Designer por Proyecto.
Diferencias respecto a las conexiones Environment
| Aspecto | Conexión Environment | Conexión de Proyecto |
|---|---|---|
| Gestión | Administradores autorizados, desde Configuraciones | Owner y Editor, desde el Designer por Proyecto |
| Visibilidad | Depende de los Roles asociados | Depende de la pertenencia al Proyecto |
| Uso | Objetos compatibles con los Roles requeridos | Todos los objetos compatibles que pertenecen al Proyecto |
| Nombre | No puede modificarse después de la creación | Puede actualizarlo quien gestione todos los Proyectos asociados |
| Uso compartido | Mediante Roles | Mediante la asociación a uno o varios Proyectos |
Las conexiones Environment siguen funcionando con las reglas existentes. En particular, su nombre continúa siendo la referencia estable que se muestra en los Workflow y no se puede cambiar desde su interfaz.
Requisitos previos y permisos
Para crear o modificar una Conexión de Proyecto debes ser Owner o Editor del Proyecto abierto. Si la conexión pertenece a varios Proyectos, la gestión requiere un rol con capacidad de edición en todos los Proyectos implicados.
Los Viewer pueden ver la conexión en el Catálogo y utilizarla en los objetos a los que tienen acceso, pero no pueden modificarla. Los datos protegidos no se muestran en resúmenes ni selectores.
Crear una conexión
- Abre el Proyecto en Designer Workbench.
- Abre Conexiones de Proyecto en el panel lateral derecho.
- Selecciona Nueva.
- Introduce el nombre y la descripción y elige el tipo propuesto.
- Completa los campos mostrados y selecciona uno o varios Proyectos editables. Para SSH, Autenticación permite elegir Contraseña o Clave privada; la ruta de la clave solo es obligatoria con Clave privada.
- Usa Verificar para probar los datos introducidos incluso antes de guardar.
- Guarda o selecciona Cancelar para descartar la creación y cerrar el panel.
El guardado y la verificación se realizan sin recargar la página. Durante la creación solo están disponibles las acciones no destructivas; desactivar, revocar y eliminar aparecen después de guardar. Si la prueba falla, el panel muestra un mensaje operativo: corrige los campos indicados y repite la prueba.
No introduzcas información confidencial en el nombre o la descripción ni la copies en capturas de pantalla, tickets o documentos compartidos.
Catálogo Studio y asociación a Proyectos
Después de crearla, la conexión aparece en el Catálogo Studio con el tipo Conexión de Proyecto y en los Proyectos a los que está asociada. También aparece en el modal Añadir objeto al Proyecto cuando puede añadirse al Proyecto seleccionado.
Una sola conexión puede pertenecer a varios Proyectos: no se crea una copia y los cambios son compartidos. Todos los objetos compatibles de cada Proyecto asociado pueden seleccionarla.
Utilizarla en los objetos del Proyecto
La opción Proyecto o Conexión de Proyecto aparece en los selectores de los consumidores compatibles, entre ellos:
- Task de Workflow que utilizan conexiones de base de datos o SSH;
- fuentes de datos de las Vistas de Usuario;
- entidades de los Modelos Semánticos;
- Data Resource de los Portales.
La conexión debe pertenecer al menos a un Proyecto del objeto que la utiliza. Si un objeto está compartido entre varios Proyectos, Sybot comprueba que la referencia siga siendo válida en su ámbito antes de guardar o ejecutar.
Modificar el estado y el ámbito
Desde el panel lateral puedes actualizar la descripción, los campos permitidos, el nombre, los Proyectos asociados y el estado. Una conexión revocada no puede reactivarse.
Sybot impide quitar un Proyecto o eliminar la conexión cuando todavía la utiliza un Task, una Vista de Usuario, un Modelo Semántico o un Portal de ese ámbito. Primero debes sustituir o eliminar la referencia en los objetos indicados.
Importación y exportación
Los packages de Vistas de Usuario, Modelos Semánticos y Portales registran la referencia a la Conexión de Proyecto, pero no incluyen los valores protegidos. Durante la importación, Sybot propone una conexión compatible del Proyecto de destino. Si no existe, créala o asóciala al Proyecto y repite la operación.
Solución de problemas
| Problema | Comprobación |
|---|---|
| La conexión no aparece | Comprueba que esté activa, sea compatible y esté asociada a un Proyecto del objeto. |
| El panel es de solo lectura | Comprueba que seas Owner o Editor en todos los Proyectos asociados. |
| No se puede quitar un Proyecto | Busca los objetos indicados como dependencias y sustituye primero la conexión. |
| Una importación requiere una asociación | Crea o asocia una Conexión de Proyecto compatible en el Proyecto de destino. |
| La prueba o la Preview fallan | Usa el mensaje mostrado y comunica solo el nombre, la hora y la referencia de diagnóstico, sin valores confidenciales. |
Para conocer el funcionamiento general del contexto, consulta Designer por Proyecto. Para las conexiones administrativas basadas en Roles, consulta Conexiones.