Integrieren Sie Lucid in Confluence Data Center

Für Admins: Anweisungen zur Installation und Konfiguration

Nur der Kontoinhaber oder Kontoadministrator eines Team oder Enterprise Kontos kann die Lucidchart App in Confluence Data Center oder Lucidspark App in Confluence Data Center installieren und konfigurieren.
Folgen Sie dieser Installationsanleitung:

1. Melden Sie sich als Admin bei Ihrer Confluence-Instanz an.
2. Öffnen Sie das Admin-Menü.
3. Klicken Sie in der linken Seitenleiste auf Add-ons.
4. Wählen Sie Neue Add-ons suchen aus.
5. Suchen Sie im Atlassian-Marktplatz nach „Lucidchart“ oder „Lucidspark“. 
6. Klicken Sie auf die KachelLucidchart Diagrammverbinder“ oder Lucidspark Boardverbinder“.
7. Wählen Sie oben rechts Jetzt herunterladen aus.
8. Wenn Sie die Lucidchart-App installieren, klicken Sie im Pop-up-Fenster unter „Data Center“ auf „Jetzt herunterladen“ .

Die App wird auf Ihr lokales Gerät heruntergeladen. 

Befolgen Sie diese Schritte in der heruntergeladenen App, um sie für Ihre Instanz zu konfigurieren:

1. Klicken Sie auf „Verwalten und Konfigurieren“ , um Lucid Zugriff auf Confluence zu gewähren.
2. Melden Sie sich bei Ihrem Lucid-Konto an, falls Sie noch nicht angemeldet sind.
3. Wählen Sie Konto verknüpfen aus, um Ihre Confluence-Instanz mit Ihrem Lucid-Konto zu verbinden.

Um die Lucidchart App für Confluence Data Center in Ihrer Lucidchart for Gov-Umgebung einzurichten, navigieren Sie zu <baseUrl>/Admin/plugins/Lucidchart/environmentconfig.action, wobei <baseUrl> die Basis-URL Ihrer Confluence Instanz ist, und wählen Sie lucidgov.app aus dem Dropdown-Menü aus.

Ein Dokument zu einer Confluence-Seite hinzufügen

So fügen Sie ein Lucidchart-Diagramm oder ein Lucidspark-Board zu einer Confluence-Seite hinzu:

1. Erstellen Sie eine Confluence-Seite oder öffnen Sie eine vorhandene Seite. 
2. Klicken Sie oben auf der Seite auf Bearbeiten.
3. Klicken Sie auf + im Menü oben auf der Seite. 
4. Wählen Sie „Lucidchart-Diagramm hinzufügen“ oder „Lucidspark-Board hinzufügen“. 
   • Wenn Sie diese Option nicht sehen, wenden Sie sich an den Admin Ihres Lucidchart-Kontos und bitten Sie ihn oder sie, die entsprechende Lucid-App für Ihre Confluence-Instanz zu installieren und zu konfigurieren.
   • Befindet sich das hinzuzufügende Dokument in einem Repository, müssen Sie dieses Repository öffnen, bevor Sie mit dem nächsten Schritt fortfahren. Klicken Sie dazu in der Navigation auf der linken Seite auf „Repository“ und wählen Sie anschließend das gewünschte Repository aus.
5. Bewegen Sie den Mauszeiger über das Dokument, das Sie hinzufügen möchten, und klicken Sie auf Auswählen. 
   • Sie können auch ein neues Dokument erstellen, indem Sie oben links auf + Dokument klicken.
6. Nach dem Auswählen wird das Dokument auf Ihrer Confluence-Seite geladen.
7. Klicken Sie unten rechts auf der Confluence-Seite auf Aktualisieren, um das Dokument zu veröffentlichen.

Nach der Veröffentlichung können alle Personen, die über Berechtigungen für diese Seite verfügen, das Dokument anzeigen.

Eingebettete Dokumente verwalten

Bearbeiten Sie Lucidspark-Boards direkt von der Confluence-Seite aus

Wenn Sie ein Lucidspark-Board in Confluence Data Center einbetten, können Sie aus den folgenden Zugriffseinstellungen wählen, die direkt in Confluence verfügbar sein werden:

• Nur anzeigen: Confluence-Benutzer können nur das eingebettete Lucidspark-Board anzeigen.
• Nur Kommentieren: Confluence-Benutzer können das eingebettete Lucidspark-Board anzeigen und kommentieren.
• Bearbeiten: Confluence-Benutzer können das eingebettete Lucidspark-Board bearbeiten. 

Das Bearbeiten eines Lucidspark Boards direkt in Confluence bietet eine Vielzahl von Optionen, wie z. B. das Hinzufügen von Formen und Linien oder die Teilnahme an einer Visual Activity. Wenn Sie neu bei Lucidspark sind und lernen möchten, wie Sie mit einer Vielzahl der Ihnen zur Verfügung stehenden Funktionen arbeiten können, lesen Sie unseren Artikel Willkommen bei Lucidspark .

Bearbeiten Sie ein Lucidchart-Dokument, indem Sie es in Lucid öffnen

Wenn Sie Bearbeitungszugriff auf eine Confluence-Seite mit eingefügten Lucidchart-Dokumenten haben, können Sie die Dokumente in Lucid bearbeiten und die Änderungen zurück an Confluence übertragen.

So bearbeiten Sie ein Dokument, das bereits zu einer Confluence-Seite hinzugefügt wurde:

1. Bewegen Sie auf der veröffentlichten Confluence-Seite den Cursor über das eingefügte Lucidchart-Diagramm oder Lucidspark-Board. 
2. Klicken Sie auf „Mit Lucidchart öffnen“.
   • Wenn Sie sich auf der Confluence-Seite im Bearbeitungsmodus befinden, klicken Sie auf das eingefügte Dokument und wählen Sie Bearbeiten aus der Optionsleiste, die unterhalb des Diagramms angezeigt wird.
3. Das Dokument wird im Lucid-Editor geöffnet und Sie können jetzt Änderungen daran vornehmen.
4. Wenn Sie fertig sind, klicken Sie oben links im Lucid-Editor auf Zurück zu Confluence.
   • Die Änderungen werden automatisch mit dem eingebetteten Dokument in Confluence synchronisiert.
5. Klicken Sie unten rechts auf der Confluence-Seite auf„Aktualisieren “, um Ihre Änderungen zu veröffentlichen.

Ein Dokument von einer Confluence-Seite löschen

So löschen Sie ein Dokument, das bereits zu einer Confluence-Seite hinzugefügt wurde:

1. Klicken Sie oben auf der Confluence-Seite auf Bearbeiten.
2. Wählen Sie das eingefügte Dokument aus.
3. Klicken Sie in der Optionsleiste, die unter dem Dokument angezeigt wird, auf Entfernen.
4. Klicken Sie unten rechts auf der Confluence-Seite auf„Aktualisieren “, um Ihre Änderungen zu veröffentlichen.

Anzeigeeigenschaften eines Diagramms anpassen

So erhalten Sie Zugriff auf die Anzeigeeigenschaften eines eingefügten Dokuments:

1. Klicken Sie oben auf der Confluence-Seite auf Bearbeiten.
2. Wählen Sie das Dokument aus. 
3. Klicken Sie in der Optionsleiste, die unter dem Dokument erscheint, auf Eigenschaften, um das Fenster mit den Anzeigeeigenschaften zu öffnen.
4. Klicken Sie auf Speichern, nachdem Sie Änderungen an den Anzeigeeigenschaften vorgenommen haben.

In diesem Fenster sehen Sie möglicherweise die folgenden Einstellungen, je nachdem, welche Lucid-App Sie verwenden:

• Passen Sie die Breite und Höhe des eingefügten Dokuments an.
• Schalten Sie die automatische Größenanpassung ein oder aus.
• Passen Sie die Ausrichtung der auf der Confluence-Seite angezeigten Diagramme an.
• Legen Sie für Lucidchart-Dokumente fest, welche Seiten den Betrachtenden der Confluence-Seite zur Verfügung stehen (z. B. 3 oder 2–3). 
  • Die Auswahl einer Seite oder eines Seitenbereichs ist nur möglich, wenn Sie den Rich-Viewer verwenden. 
• Wechseln Sie zwischen dem Rich-Viewer und dem einfachen Viewer.
• Aktivieren Sie die automatische Aktualisierung, wenn Dokumente in Lucid aktualisiert werden. 
  • Die Aktivierung der automatischen Aktualisierung ist nur möglich, wenn Sie den Rich-Viewer verwenden.

Der einfache Viewer und der Rich-Viewer im Vergleich

Für die Anzeige Lucid Dokument in Confluence Data Center stehen zwei Viewer zur Verfügung: einfach und umfangreich.

Sie können im Fenster der Makroeinstellungen zwischen dem einfachen Viewer und dem Rich-Viewer für ein bestimmtes Dokument wechseln.

Einfacher Viewer

Der einfache Viewer wird auf Confluence-Servern gehostet und stellt ein statisches PNG des Dokuments bereit. 

Wenn Sie mit der Maus über das Dokument fahren, können Betrachtende mit dem einfachen Viewer die folgenden Aktionen ausführen:

• Das Diagramm in Lucid bearbeiten
• Das Diagramm von der Confluence-Seite entfernen
• Zum Rich-Viewer wechseln
• Auf die neueste Version des Lucid-Dokuments aktualisieren
• Das Diagramm vergrößern und verkleinern

Wenn das eingefügte Dokument mehrere Seiten enthält, können Sie zwischen diesen wechseln, indem Sie auf den entsprechenden Pfeil klicken, der an der Seite des Viewers erscheint, wenn Sie mit der Maus über das Dokument fahren.

Rich-Viewer

Der Rich-Viewer wird auf Lucid-Servern gehostet und benötigt zum Ausführen einen Internetzugang. Er bietet vollständige Interaktivität mit Lucid-Dokumenten. 

Wenn Sie mit der Maus über Dokumente fahren, die im Rich-Viewer angezeigt werden, wird ein Rahmen angezeigt. 

Vom oberen Rand des Rahmens aus können Nutzende die folgenden Aktionen durchführen:

• Das Lucid-Dokument in einem neuen Browser-Tab öffnen
• Dokumenttitel anzeigen
• Alle im Dokument erstellten Folien präsentieren
• In den Vollbildmodus wechseln
• Das Fenster „Viewer-Optionen“ öffnen
  • Dieses Fenster für die Lucidchart-App bietet die Möglichkeit, Hinweise und Hotspots anzuzeigen, WebGL zu aktivieren und auf die neueste Version des Diagramms zu aktualisieren

Am unteren Rand des Rahmens können Nutzende die folgenden Aktionen durchführen: 

• Verschiedene Seitenregisterkarten für die Anzeige im Lucidchart-Dokument auswählen
• Verschiedene Ebenen im Diagramm im Lucidchart-Dokument anzeigen
• Das Diagramm vergrößern und verkleinern

Draw.io-Diagramme in Lucidchart-Dokumente umwandeln

Gehen Sie folgendermaßen vor, um Ihr Draw.io Diagramm in Lucidchart Dokument in Confluence Data Center zu konvertieren:

1. Navigieren Sie zu der Seite, die die Dokumente enthält, die Sie umwandeln möchten.
2. Öffnen Sie die Datei in Draw.io und laden Sie sie als XML-Datei herunter.
3. Gehen Sie auf Ihrer Confluence-Seite in den Bearbeitungsmodus.
4. Über das Plus-Zeichen in der Symbolleiste oben im Editor können Sie mit der Lucidchart-Auswahl im entsprechenden Drop-down-Menü ein neues Lucidchart-Diagramm einfügen.
5. Sobald der Lucidchart-Editor geöffnet ist, können Sie das Diagramm über das Importmenü importieren.
6. Nachdem das Diagramm importiert ist, wählen Sie es aus der Dokumentenliste aus, und es wird zu Ihrer Confluence-Seite hinzugefügt. An dieser Stelle werden Sie zurück zu Confluence geleitet.
7. Die Konvertierung ist nun abgeschlossen und Sie können Ihr ursprüngliches Draw.io-Diagramm von Ihrer Confluence-Seite löschen.

Migration von Confluence Data Center zu Confluence Cloud

Beachten Sie Folgendes vor der Migration von Confluence Data Center zu Confluence Cloud: 

• Dokumente werden anhand von Leerzeichen und nicht seitenweise konvertiert.
• Diese Migration kann nicht im Ganzen rückgängig gemacht werden, ohne vorher eine Sicherung der Confluence-Instanz wiederherzustellen.
• Die Konvertierung kann für jedes Dokument einzeln rückgängig gemacht werden, indem man zum entsprechenden Dokument navigiert und die Seite aus dem Seitenverlauf wiederherstellt.

Wenn Sie Ihre Lucidchart App von Confluence Data Center zu Confluence Cloud migrieren, befolgen Sie die folgenden Schritte, um Ihre Dokumente zurückzusetzen, damit sie wieder angezeigt werden:

1. Navigieren Sie zum Konfigurationsbereich des Lucidchart-Add-ons.
2. Wählen Sie die Option „ Confluence -Konvertierung“ aus.
3. Klicken Sie auf „Suchen“ , um das zu konvertierende Diagramm zu finden.
4. Wählen Sie Konvertieren.

Sobald Sie Ihr Dokument migriert haben, finden Sie in unserem Artikel Lucid mit Confluence Cloud integrieren“ Anweisungen zur Verwendung dieser Integration.

FAQ

Wer kann Ansichten und Lucid Dokumente bearbeiten, die in eine Confluence -Seite eingebettet wurden?
Die Anzeigeberechtigungen für Lucid Dokumente im Confluence Data Center werden von der Confluence -Seite übernommen. Das bedeutet: Wenn Sie eine Confluence -Seite anzeigen können, können Sie auch das Dokument auf Confluence Seite anzeigen, unabhängig davon, ob Sie ein Lucid -Konto besitzen oder nicht. 

Die Lucidspark App in Confluence bezieht auch Bearbeitungsberechtigungen von der Confluence-Seite. Das heißt, wenn Sie eine Confluence -Seite ansehen und bearbeiten können und ein lizenzierter Lucid Benutzer sind, können Sie das Diagramm in der Lucid App ansehen und bearbeiten, indem Sie in jedem Dokument auf die Schaltfläche „In Lucidchartöffnen“ klicken.

Die Lucidspark-App in Confluence verlangt, dass Sie sowohl Bearbeitungszugriff in Confluence als auch Bearbeitungszugriff auf das eingebettete Lucidspark-Board haben, um das Dokument in Confluence bearbeiten zu können.

Warum hänge ich in einer Anmeldeschleife fest, wenn ich versuche, auf die Integration zuzugreifen?
Wenn Sie bei der Verwendung dieser Integration in einer Anmeldeschleife landen und ständig aufgefordert werden, sich bei Lucid anzumelden, liegt das höchstwahrscheinlich daran, dass Cookies von Drittanbietern in Ihrem Browser blockiert sind.Lesen Sie unseren Artikel Fehlerbehebung: Cookies von Drittanbietern aktivieren, um zu erfahren, wie Sie diese Einstellung ändern können, damit die Cookies nicht mehr blockiert werden. 

Warum werden weiße Ränder um meine eingebetteten Lucid-Diagramme in Confluence angezeigt?
Etwas Leerraum um Ihr Dokument herum kann beim Einfügen von Diagrammen in Confluence normal sein. Anweisungen dazu, wie Sie das Erscheinungsbild Ihrer eingebetteten Dokumente optimieren können, finden Sie im Community-Beitrag White space on inserted diagrams (Beitrag auf Englisch).

Warum erhalte ich eine OAuth-Zeitüberschreitungsfehlermeldung, wenn ich versuche, eine Lucidchart-App für Confluence Data Center zu installieren?
Wenn beim Installieren und Konfigurieren des Lucidchart Confluence Data Center Connectors der folgende OAuth-Zeitstempelfehler angezeigt wird,

„org.scribe.exceptions.OAuthException: Response body is incorrect. Can't extract token and secret from this: 'oauth_problem=expired_timestamp,_yours_1359614629,_ours_1359585813'“

dann bedeutet dies höchstwahrscheinlich, dass der Zeitstempel auf dem Server, auf dem Sie Confluence hosten, nicht die richtige Zeit angibt. Auch wenn Ihre Serverzeit in Ordnung zu sein scheint, kann bereits eine Abweichung von 15 bis 30 Sekunden zu Kommunikationsschwierigkeiten zwischen zwei Servern führen. Die Serverzeit kann manuell nicht präzise genug eingestellt werden. Sie müssen daher Ihren Zeitstempel mit einem NTP-Server synchronisieren.

Warum erhalte ich die Fehlermeldung „Sie gehören zu keinem Team, das mit dieser Instanz in Verbindung steht“?
Dieser Fehler bedeutet, dass die Nutzende wahrscheinlich mit einem falschen Lucid Konto verbunden ist. Um dieses Problem zu beheben, führen Sie die folgenden Schritte aus:

1. Melden Sie sich bei Ihrem Lucid-Konto an, das aktuell nicht korrekt mit Confluence verbunden ist.  
2. Klicken Sie oben rechts in Ihrem Lucid-Konto auf Ihr Profilbild oder Ihre Initialen.
3. Wählen Sie Kontoeinstellungen aus.
4. Wählen Sie im Menü auf der linken Seite Apps & Integrationen aus.
5. Aktivieren Sie das Kontrollkästchen neben „Confluence“.
6. Klicken Sie auf die Schaltfläche „Entfernen “. Dadurch wird die Verbindung zu dem Konto getrennt.
7. Um die korrekte Verbindung wiederherzustellen, melden Sie sich von Lucid ab. 
8. Fügen Sie ein beliebiges Lucid-Dokument in eine Confluence-Seite ein. 
9. Wenn Sie aufgefordert werden, sich bei Lucid anzumelden, achten Sie darauf, dass Sie sich mit der E-Mail-Adresse anmelden, die mit dem Lucid-Konto Ihrer Organisation verknüpft ist.

Was geschieht mit der kontoweiten Confluence -Verbindung, wenn der Administrator, der sie ursprünglich eingerichtet hat, das Unternehmen verlässt?
Wenn Ihr Administrator das Unternehmen verlässt, bleibt die Verbindung aktiv, da sie auf der Kontoebene eingerichtet wurde. Admin sind nur während der Ersteinrichtung erforderlich, um die Verbindung herzustellen.
 

Geben Sie Feedback zu diesem Artikel