Integra Lucid con il data center di Confluence

Per gli amministratori: istruzioni per l'installazione e la configurazione

Solo il proprietario dell'account o gli amministratori di un account Team o aziendale possono installare e configurare l'app Lucidchart in Confluence Data Center o l'app Lucidspark in Confluence Data Center.
Seguire queste istruzioni di installazione:

1. Accedi alla tua istanza di Confluence come amministratore.
2. Apri il menu Amministrativo.
3. Clicca su Add-on nella barra laterale sinistra.
4. Seleziona Trova nuovi add-on.
5. Cerca "Lucidchart" o "Lucidspark" nel marketplace Atlassian. 
6. Clicca sulla tessera Lucidchart diagramma Connector o sulla tessera Lucidspark Tavola Connector.
7. Seleziona Prendilo ora nell'angolo in alto a destra.
8. Se installi l'app Lucidchart, clicca su Scaricala ora sotto Data Center nella finestra pop-up.

L'applicazione verrà scaricata sul tuo dispositivo locale. 

Segui questi passaggi dall'applicazione scaricata per configurarla sulla tua istanza:

1. Clicca su Gestisci e Configura per concedere a Lucid l'accesso a Confluence.
2. Accedi al tuo account Lucid se non lo hai ancora fatto.
3. Seleziona Account Link per collegare la tua istanza Confluence al tuo account Lucid.

Per configurare l'app Lucidchart per il Centro Dati Confluence per il tuo ambiente Lucidchart for Gov, naviga su <baseUrl>/admin/plugins/lucidchart/environmentconfig.action dove <baseUrl> è l'URL base della tua istanza Confluence e seleziona lucidgov.app dal menu a tendina.

Aggiungi un documento a una pagina di Confluence

Per aggiungere un diagramma Lucidchart o una tavola Lucidspark a una pagina di Confluence, segui i seguenti passaggi:

1. Crea una pagina Confluence o aprine una esistente. 
2. Clicca su Modifica in cima alla pagina.
3. Clicca su + nel menu in alto della pagina. 
4. Seleziona Aggiungi diagramma Lucidchart o Aggiungi Lucidspark Tavola. 
   • Se non vedi questa opzione, contatta l'amministratore del tuo account Lucidchart e chiedigli di installare e configurare l'app Lucid appropriata per la tua istanza Confluence.
   • Se il documento che aggiungi si trova in un repository, devi aprire quel repository prima di passare al passaggio successivo. Clicca su Repository dalla navigazione sul lato sinistro, poi seleziona il repository specifico.
5. Passa il cursore sopra il documento che vuoi aggiungere e clicca su Seleziona. 
   • Puoi anche creare un nuovo documento cliccando su + Documento nell'angolo in alto a sinistra.
6. Una volta selezionato, il documento verrà caricato sulla tua pagina Confluence.
7. Clicca su Aggiorna nell'angolo in basso a destra della pagina Confluence per pubblicare il documento.

Una volta pubblicato, tutti coloro che hanno i permessi per quella pagina potranno visualizzare il documento.

Gestisci i documenti incorporati

Modifica le schede Lucidspark direttamente dalla pagina Confluence

Quando incorpori una Lucidspark Tavola in Confluence Data Center, puoi scegliere tra le seguenti impostazioni di accesso che saranno disponibili direttamente in Confluence:

• Solo visualizzazione: gli utenti di Confluence possono visualizzare solo la scheda Lucidspark incorporata.
• Solo commento: gli utenti di Confluence possono visualizzare e commentare la scheda Lucidspark incorporata.
• Modifica: gli utenti di Confluence possono modificare la scheda Lucidspark incorporata. 

La modifica di una bacheca Lucidspark direttamente in Confluence fornirà un'ampia varietà di opzioni, come l'aggiunta di forme e linee o la partecipazione a un Visual Activity. Se non conosci Lucidspark e sei interessato a imparare a lavorare con una varietà di funzionalità a tua disposizione, dai un'occhiata al nostro articolo Benvenuto in Lucidspark .

Modifica un documento Lucidchart aprendolo in Lucid

Se disponi dell'accesso in modifica a una pagina di Confluence con documenti Lucidchart inseriti, puoi modificare i documenti in Lucid e inviare nuovamente le modifiche a Confluence.

Per modificare un documento che è già stato aggiunto a una pagina di Confluence, segui questi passaggi:

1. Nella pagina Confluence pubblicata, passa il cursore sul diagramma Lucidchart o sulla bacheca Lucidspark inserita. 
2. Clicca su Apri con Lucidchart.
   • Se sei in modalità modifica nella pagina Confluence, clicca sul documento inserito e seleziona Modifica dalla barra delle opzioni che appare sotto il diagramma.
3. Il documento si aprirà nell'editor di Lucid e ora potrai apportarvi delle modifiche.
4. Quando hai finito, clicca su Torna a Confluence nell'angolo in alto a sinistra dell'editor Lucid.
   • Le modifiche saranno sincronizzate automaticamente con il documento incorporato in Confluence.
5. Clicca su Aggiorna in basso a destra nella pagina Confluence per pubblicare le tue modifiche.

Elimina un documento da una pagina di Confluence

Per eliminare un documento già aggiunto a una pagina di Confluence, segui questi passaggi:

1. Clicca su Modifica in cima alla pagina Confluence.
2. Seleziona il documento inserito.
3. Clicca su Remove dalla barra delle opzioni che appare sotto il documento.
4. Clicca su Aggiorna in basso a destra nella pagina Confluence per pubblicare le tue modifiche.

Regola le proprietà di visualizzazione del diagramma

Per accedere alle proprietà di visualizzazione di un documento inserito:

1. Clicca su Modifica in cima alla pagina Confluence.
2. Seleziona il documento. 
3. Clicca su Proprietà dalla barra delle opzioni che appare sotto il documento per aprire il modale delle proprietà di visualizzazione.
4. Clicca su Salva dopo aver apportato modifiche alle proprietà del display.

In questa finestra di dialogo potrai vedere le seguenti impostazioni, a seconda dell'applicazione Lucid che stai utilizzando:

• Regola la larghezza e l'altezza del documento inserito.
• Attiva o disattiva il dimensionamento automatico.
• Regola l'allineamento dei diagrammi visualizzati nella pagina di Confluence.
• Per i documenti Lucidchart, stabilisci quali pagine sono disponibili per i visualizzatori della pagina Confluence (es. 3 o 2-3). 
  • La selezione di una pagina o di un intervallo di pagine è possibile solo se si utilizza il rich viewer. 
• Passa dalla visualizzazione ricca a quella semplice.
• Abilita l'aggiornamento automatico quando i documenti vengono aggiornati in Lucid. 
  • L'abilitazione dell'aggiornamento automatico è possibile solo se si utilizza il rich viewer.

Visualizzatore semplice o ricco

Sono disponibili due visualizzatori per la visualizzazione dei documenti Lucid nel Data Center di Confluence: semplice e ricco.

Puoi passare dalla visualizzazione semplice a quella ricca per un documento specifico nella maschera delle impostazioni macro.

Visualizzatore semplice

Il semplice visualizzatore è ospitato sui server di Confluence e fornisce un PNG statico del documento. 

Quando si passa il cursore sul documento, simple viewer permette di eseguire le seguenti azioni:

• Modifica il diagramma in Lucid
• Rimuovi il diagramma dalla pagina Confluence
• Passa al visualizzatore ricco
• Aggiornare all'ultima versione del documento Lucid
• Ingrandisci e rimpicciolisci il diagramma

Se il documento inserito contiene più pagine, puoi passare da una all'altra cliccando sulla freccia corrispondente che appare sul lato del visualizzatore quando passi il cursore sul documento.

Visualizzatore avanzato

Il rich viewer è ospitato sui server Lucid e richiede un accesso a Internet per funzionare. Offre un'interattività completa con i documenti Lucid. 

Quando si passa il cursore sui documenti visualizzati con il rich viewer, appare un riquadro. 

Dalla parte superiore della cornice, gli utenti possono:

• Apri il documento Lucid in una nuova scheda del browser
• Visualizza il titolo del documento
• Presenta tutte le diapositive che sono state create nel documento.
• Entra in modalità a schermo intero
• Apri la maschera Opzioni del visualizzatore
  • Questo modale per l'applicazione Lucidchart contiene la possibilità di mostrare note, hotspot, di abilitare WebGL e di aggiornare all'ultima versione del diagramma.

Dalla parte inferiore della cornice, gli utenti possono: 

• Seleziona diverse schede di pagina da visualizzare nel documento Lucidchart
• Visualizza i diversi livelli del diagramma nel documento Lucidchart
• Ingrandisci e rimpicciolisci il diagramma

Converti i tuoi diagrammi di Draw.io in documenti Lucidchart

Per convertire il diagramma Draw.io in documenti Lucidchart in Confluence Data Center, procedi nel seguente modo:

1. Vai alla pagina che contiene i documenti che vuoi convertire.
2. Apri il file in Draw.io e scaricalo come file XML.
3. Entra in modalità di modifica nella tua pagina Confluence.
4. Utilizzando l'icona più sulla barra degli strumenti nella parte superiore dell'editor, inserisci un nuovo documento Lucidchart tramite la selezione Lucidchart nel menu a tendina.
5. Una volta aperto l'editor di Lucidchart, puoi importare il diagramma tramite il menu di importazione.
6. Una volta importato il diagramma, selezionalo dall'elenco dei documenti e verrà aggiunto alla tua pagina Confluence. A questo punto verrai reindirizzato a Confluence.
7. La conversione è terminata e puoi eliminare il diagramma originale di Draw.io dalla tua pagina Confluence.

Migrazione dal Confluence Data Center a Confluence Cloud

Tieni presente quanto segue prima di migrare dal Confluence Data Center al Confluence Cloud: 

• I documenti vengono convertiti per spazio, non per pagina.
• Questa migrazione non può essere annullata in massa senza ripristinare un backup precedente dell'istanza Confluence.
• La conversione può essere annullata su base per documento navigando sul documento e ripristinando la pagina dalla cronologia della pagina.

Se stai migrando da Confluence Data Center a Confluence Cloud per la tua app Lucidchart, segui i passaggi seguenti per resettare i tuoi documenti in modo che vengano visualizzati di nuovo:

1. Naviga alla sezione configurazione dell'add-on Lucidchart.
2. Seleziona la scheda "Conversione Confluence".
3. Clicca su Cerca per trovare diagramma che devono essere convertiti.
4. Seleziona Converti.

Una volta migrati i tuoi documenti, consulta il nostro articoloIntegra Lucid con Confluence Cloud per le istruzioni su come utilizzare quell'integrazione.

FAQ

Chi può visualizzare e modificare i documenti Lucid che sono stati incorporati in una pagina Confluence?
I permessi di visualizzazione per i documenti Lucid nel Centro Dati Confluence saranno ereditati dalla pagina Confluence. Questo significa che se puoi visualizzare una pagina Confluence, potrai visualizzare i documenti presenti nella pagina Confluence, indipendentemente dal fatto che tu abbia o meno un account Lucid. 

L'app Lucidchart in Confluence estrae anche i permessi di modifica dalla pagina Confluence. Questo significa che se puoi visualizzare e modificare una pagina Confluence e sei un utente autorizzato di Lucid, potrai visualizzare e modificare il diagramma nell'app Lucid cliccando sul pulsante Apri in Lucidchart in ogni documento.

L'applicazione Lucidspark in Confluence richiede che tu abbia sia l'accesso alla modifica in Confluence che l'accesso alla modifica sulla scheda Lucidspark incorporata per poter modificare il documento in Confluence.

Perché sono bloccato in un loop di login quando cerco di accedere all'integrazione?
Se sperimenti un ciclo di accesso in cui ti viene continuamente chiesto di accedere a Lucid quando usi questa integrazione, molto probabilmente è dovuto al blocco dei cookie di terze parti sul tuo browser. Consulta il nostro articoloTroubleshooting: Abilita cookie di terze parti per dettagli su come modificare quell'impostazione in modo che non vengano più bloccati.

Perché vedo margini bianchi intorno al mio diagramma lucido incorporato in Confluence?
Alcuni spazi bianchi intorno al documento possono essere normali quando si inserisce diagramma in Confluence. Consulta questo postdella comunità White spazio on inserted diagramma (in inglese) per istruzioni su come ottimizzare l'aspetto dei tuoi documenti incorporati.

Perché vedo un errore di timetake OAuth quando cerco di installare un'app Lucidchart per il Confluence Data Center?
Se vedi il seguente errore di timestamp OAuth quando provi a installare e configurare il connettore Lucidchart Confluence Data Center,

"org.scribe.exceptions.OAuthException: Il corpo della risposta non è corretto. Non è possibile estrarre token e segreto da questo: 'oauth_problem=expired_timestamp,_yours_1359614629,_ours_1359585813'”

probabilmente significa che il timestamp del server che ospita Confluence non è particolarmente preciso. Anche se l'orario del server sembra corretto, una discrepanza di 15-30 secondi può far sì che due server non vogliano parlare tra loro. Non è possibile regolare manualmente l'orario del server con sufficiente precisione, quindi dovrai sincronizzare il timestamp con un server NTP.

Perché ricevo un errore "Non fai parte di un Team associato a questa istanza"?
Questo errore significa che l'utente è probabilmente collegato a un account Lucid errato. Per risolvere questo problema, segui questi passaggi:

1. Accedi al tuo account Lucid che attualmente è collegato in modo errato a Confluence. 
2. Clicca sull'immagine del tuo profilo o sulle iniziali nell'angolo in alto a destra del tuo account Lucid.
3. Seleziona Impostazioni account.
4. Seleziona Applicazioni e Integrazioni nel menu sinistro.
5. Seleziona la casella accanto a "Confluence".
6. Clicca sul pulsante Rimuovi . Questo disconnetterà l'account.
7. Per ristabilire la connessione corretta, esci da Lucid. 
8. Inserisci qualsiasi documento Lucid in una pagina Confluence. 
9. Quando ti viene richiesto di accedere a Lucid, assicurati di accedere con l'e-mail associata all'account Lucid della tua organizzazione.

Cosa succede alla connessione Confluence a livello di account se l'amministratore che l'ha configurata inizialmente se ne va?
Se il tuo amministratore se ne va, la connessione rimarrà attiva, così come è stata stabilita a livello di account. I permessi amministrativi sono necessari solo durante il processo iniziale di configurazione per creare la connessione.
 

Lascia un feedback su questo articolo