Connessioni di Progetto
Le Connessioni di Progetto permettono agli oggetti dello stesso Progetto di usare una connessione condivisa senza associarla ai Ruoli applicativi. Sono oggetti del Catalogo Studio e vengono create e gestite nel Designer per Progetto.
Differenze rispetto alle connessioni Environment
| Aspetto | Connessione Environment | Connessione di Progetto |
|---|---|---|
| Gestione | Amministratori autorizzati, da Configurazioni | Owner ed Editor, dal Designer per Progetto |
| Visibilità | Dipende dai Ruoli associati | Dipende dall’appartenenza al Progetto |
| Utilizzo | Oggetti compatibili con i Ruoli richiesti | Tutti gli oggetti compatibili appartenenti al Progetto |
| Nome | Non può essere modificato dopo la creazione | Può essere aggiornato da chi gestisce tutti i Progetti associati |
| Condivisione | Tramite Ruoli | Tramite associazione a uno o più Progetti |
Le connessioni Environment continuano a funzionare con le regole esistenti. In particolare, il loro nome rimane il riferimento stabile mostrato nei Workflow e non può essere rinominato dalla relativa interfaccia.
Prerequisiti e permessi
Per creare o modificare una Connessione di Progetto occorre essere Owner o Editor del Progetto aperto. Se la connessione appartiene a più Progetti, la gestione richiede un ruolo modificabile in tutti i Progetti coinvolti.
I Viewer possono vedere la connessione nel Catalogo e usarla negli oggetti ai quali hanno accesso, ma non possono modificarla. I dati protetti non vengono mostrati nei riepiloghi o nei selettori.
Creare una connessione
- Aprire il Progetto nel Designer Workbench.
- Aprire Connessioni di Progetto nel pannello laterale destro.
- Selezionare Nuova.
- Inserire nome e descrizione, quindi scegliere la tipologia proposta.
- Compilare i campi mostrati e selezionare uno o più Progetti modificabili. Per SSH, Autenticazione permette di scegliere Password o Chiave privata; il path della chiave è richiesto soltanto scegliendo Chiave privata.
- Usare Verifica per provare i dati inseriti anche prima del salvataggio.
- Salvare oppure scegliere Annulla per abbandonare l’inserimento e chiudere il pannello.
Il salvataggio e la verifica avvengono senza ricaricare la pagina. Durante la creazione sono disponibili soltanto le azioni non distruttive; disabilitazione, revoca ed eliminazione compaiono dopo il salvataggio. Se la prova non riesce, il pannello mostra un messaggio operativo: correggere i campi indicati e ripetere il test.
Non inserire informazioni riservate nel nome o nella descrizione e non copiarle in screenshot, ticket o documenti condivisi.
Catalogo Studio e associazione ai Progetti
Dopo la creazione, la connessione compare nel Catalogo Studio con il tipo Connessione di Progetto e nei Progetti ai quali è associata. Compare anche nel modal Aggiungi oggetto a progetto, quando può essere aggiunta al Progetto selezionato.
Una singola connessione può appartenere a più Progetti: non viene creata una copia e le modifiche sono condivise. Tutti gli oggetti compatibili di ciascun Progetto associato possono selezionarla.
Usarla negli oggetti del Progetto
La voce Progetto o Connessione di Progetto compare nei selettori dei consumer compatibili, tra cui:
- Task Workflow che usano connessioni database o SSH;
- sorgenti dati delle Viste Utente;
- entità dei Modelli Semantici;
- Data Resource dei Portali.
La connessione deve appartenere ad almeno un Progetto dell’oggetto che la usa. Se un oggetto è condiviso tra più Progetti, Sybot verifica che il riferimento resti valido nel suo perimetro prima del salvataggio o dell’esecuzione.
Modificare stato e perimetro
Dal pannello laterale è possibile aggiornare la descrizione, i campi consentiti, il nome, i Progetti associati e lo stato. Una connessione revocata non può essere riattivata.
Sybot impedisce di rimuovere un Progetto o eliminare la connessione quando è ancora usata da un Task, una Vista Utente, un Modello Semantico o un Portale di quel perimetro. Prima occorre sostituire o rimuovere il riferimento negli oggetti indicati.
Importazione ed esportazione
Il Project Package può includere una Connessione di Progetto come oggetto o rimappare il riferimento verso una connessione compatibile già presente nel Progetto target. Password, chiavi e altri valori protetti non vengono mai inclusi.
Una connessione creata o sovrascritta dall'import resta disabilitata. Occorre quindi configurare la credenziale nella destinazione, usare Verifica e abilitare la connessione prima dell'uso. Per i dettagli consultare Importare ed esportare un Progetto.
Risoluzione dei problemi
| Problema | Verifica |
|---|---|
| La connessione non compare | Controllare che sia attiva, compatibile e associata a un Progetto dell’oggetto. |
| Il pannello è in sola lettura | Verificare di essere Owner o Editor in tutti i Progetti associati. |
| Non è possibile rimuovere un Progetto | Cercare gli oggetti indicati come dipendenze e sostituire prima la connessione. |
| Un import richiede una mappatura | Creare o associare una Connessione di Progetto compatibile nel Progetto di destinazione. |
| Test o Preview non riescono | Usare il messaggio mostrato e comunicare soltanto nome, orario e riferimento diagnostico, senza valori riservati. |
Per il funzionamento generale del contesto consultare Designer per Progetto. Per le connessioni amministrative basate sui Ruoli consultare Connessioni.