Lucid integreren met Confluence Data Center

Voor beheerders: installatie- en configuratie-instructies

Alleen de accounteigenaar of accountbeheerders van een Team- of Enterprise-account kunnen de Lucidchart-app installeren en configureren in Confluence Data Center, of de Lucidspark-app in Confluence Data Center.
Volg deze installatie-instructies:

1. Log als beheerder in bij je Confluence-instantie.
2. Open het Beheermenu.
3. Klik op Add-ons in de linkerzijbalk.
4. Selecteer Nieuwe add-ons zoeken.
5. Zoek naar 'Lucidchart' of 'Lucidspark' in de Atlassian-marktplaats. 
6. Klik op de Lucidchart Diagrams Connector-tegel of de Lucidspark Boards Connector-tegel.
7. Selecteer Nu downloaden in de rechterbovenhoek.
8. Als je de Lucidchart-app installeert, klik je in het pop-upvenster op Nu downloaden onder Datacenter.

De app wordt gedownload naar je lokale apparaat. 

Volg deze stappen vanuit de gedownloade app om deze voor jouw instantie te configureren:

1. Klik op Beheren en Configureren om Lucid toegang te verlenen tot Confluence.
2. Log in bij je Lucid-account als je nog niet bent ingelogd.
3. Selecteer Account koppelen om je Confluence-instantie aan je Lucid-account te koppelen.

Om de Lucidchart-app voor Confluence Data Center in te stellen voor je Lucidchart for Gov-omgeving, ga je naar <baseUrl>/admin/plugins/lucidchart/environmentconfig.action waarbij <baseUrl> de basis-URL van je Confluence-instantie is, en selecteer je lucidgov.app in het vervolgkeuzemenu.

Een document toevoegen aan een Confluence-pagina

Volg deze stappen om een Lucidchart-diagram of Lucidspark-whiteboard aan een Confluence-pagina toe te voegen:

1. Maak een Confluence-pagina aan of open een bestaande. 
2. Klik op Bewerken bovenaan de pagina.
3. Klik op + in het menu bovenaan de pagina. 
4. Selecteer Lucidchart-diagram toevoegen of Lucidspark-whiteboard toevoegen. 
   • Als je deze optie niet ziet, neem dan contact op met de beheerder van je Lucidchart-account en vraag deze de juiste Lucid-app voor je Confluence-instantie te installeren en configureren.
   • Als het document dat je toevoegt in een opslagplaats staat, moet je die opslagplaats openen voordat je doorgaat naar de volgende stap. Klik in de navigatie aan de linkerkant op Opslagplaatsen en selecteer vervolgens de specifieke opslagplaats.
5. Beweeg je cursor over het document dat je wilt toevoegen en klik op Selecteren. 
   • Je kunt ook een nieuw document maken door op + Document in de linkerbovenhoek te klikken.
6. Eenmaal geselecteerd, wordt het document zichtbaar op je Confluence-pagina.
7. Klik op Bijwerken in de rechterbenedenhoek van de Confluence-pagina om het document te publiceren.

Na publicatie kan iedereen die machtigingen heeft voor die pagina het document bekijken.

Ingesloten documenten beheren

Lucidspark-whiteboards direct vanuit een Confluence-pagina beheren

Wanneer je een Lucidspark-whiteboard in Confluence Data Center insluit, kun je kiezen uit de volgende toegangsinstellingen die direct beschikbaar zijn in Confluence:

• Alleen weergeven: Confluence-gebruikers kunnen alleen het ingesloten Lucidspark-whiteboard bekijken.
• Alleen opmerkingen: Confluence-gebruikers kunnen het ingesloten Lucidspark-whiteboard bekijken en erop reageren.
• Bewerken: Confluence-gebruikers kunnen het ingesloten Lucidspark-whiteboard bewerken. 

Het bewerken van een Lucidspark-whiteboard direct in Confluence biedt een groot aantal opties, zoals het toevoegen van vormen en lijnen of het deelnemen aan een visuele activiteit. Als Lucidspark nieuw voor je is en je wilt leren werken met de verschillende beschikbare functies, bekijk dan ons Welkom bij Lucidspark artikel.

Bewerk een Lucidchart-document door het in Lucid te openen

Als je bewerkingstoegang hebt tot een Confluence-pagina met ingevoegde Lucidchart-documenten, kun je de documenten in Lucid bewerken en de wijzigingen terugzetten naar Confluence.

Volg deze stappen om een document te bewerken dat al is toegevoegd aan een Confluence-pagina:

1. Beweeg op de gepubliceerde Confluence-pagina je cursor over het ingevoegde Lucidchart-diagram of Lucidspark-whiteboard. 
2. Klik op Openen met Lucidchart.
   • Als je je in de bewerkingsmodus op de Confluence-pagina bevindt, klik je op het ingevoegde document en selecteer je Bewerken in de optiebalk die onder het diagram verschijnt.
3. Het document wordt geopend in de Lucid-editor en je kunt er nu wijzigingen in aanbrengen.
4. Als je klaar bent, klik je op Terug naar Confluence in de linkerbovenhoek van de Lucid-editor.
   • De wijzigingen worden automatisch gesynchroniseerd met het ingesloten document in Confluence.
5. Klik op Bijwerken rechtsonder op de Confluence-pagina om je wijzigingen te publiceren.

Een document verwijderen van een Confluence-pagina

Volg deze stappen om een document te verwijderen dat al aan een Confluence-pagina is toegevoegd:

1. Klik op Bewerken bovenaan de Confluence-pagina.
2. Selecteer het ingevoegde document.
3. Klik op Verwijderen in de optiebalk die onder het document verschijnt.
4. Klik op Bijwerken rechtsonder op de Confluence-pagina om je wijzigingen te publiceren.

De weergave-eigenschappen van het diagram aanpassen

Om toegang te krijgen tot de weergave-eigenschappen van een ingevoegd document:

1. Klik op Bewerken bovenaan de Confluence-pagina.
2. Selecteer het document. 
3. Klik op Eigenschappen in de optiebalk die onder het document verschijnt om het venster weergave-eigenschappen te openen.
4. Klik op Opslaan nadat je wijzigingen in de weergave-eigenschappen hebt aangebracht.

In dit venster zie je mogelijk de volgende instellingen, afhankelijk van welke Lucid-app je gebruikt:

• Pas de breedte en hoogte van het ingevoegde document aan.
• Schakel formaat automatisch wijzigen in of uit.
• Pas de uitlijning aan van de diagrammen die worden weergegeven op de Confluence-pagina.
• Bepaal voor Lucidchart-documenten welke pagina's beschikbaar zijn bij weergave van de Confluence-pagina (bijv. 3 of 2-3). 
  • Het selecteren van een pagina of paginabereik is alleen mogelijk als je de geavanceerde viewer gebruikt. 
• Schakel tussen de geavanceerde en eenvoudige viewer.
• Schakel automatisch bijwerken in wanneer documenten worden bijgewerkt in Lucid. 
  • Het inschakelen van automatisch bijwerken is alleen mogelijk als je de rich viewer gebruikt.

Eenvoudige versus geavanceerde viewer

Er zijn twee viewers beschikbaar voor het weergeven van Lucid-documenten in Confluence Data Center: de eenvoudige en de geavanceerde.

Je kunt voor een specifiek document schakelen tussen de eenvoudige en geavanceerde viewer in het macro-instellingenvenster.

Eenvoudige viewer

De eenvoudige viewer wordt gehost op Confluence-servers en biedt een statische PNG van het document. 

Wanneer je je cursor over het document beweegt, kan wie het met de eenvoudige viewer weergeeft de volgende acties uitvoeren:

• Het diagram bewerken in Lucid
• Het diagram verwijderen van de Confluence-pagina
• Overschakelen naar de geavanceerde viewer
• Vernieuwen naar de nieuwste versie van het Lucid-document
• Inzoomen of uitzoomen op het diagram

Als het ingevoegde document meerdere pagina's bevat, kun je tussen deze pagina's schakelen door op de overeenkomstige pijl te klikken die aan de zijkant van de viewer verschijnt wanneer je met je cursor over het document beweegt.

Geavanceerde viewer

De geavanceerde viewer wordt gehost op Lucid-servers en vereist internettoegang om te kunnen werken. Hij biedt volledige interactiviteit met Lucid-documenten. 

Er verschijnt een frame wanneer je je cursor over documenten beweegt die worden weergegeven met de geavanceerde viewer. 

Vanaf de bovenkant van het frame kunnen gebruikers:

• Het Lucid-document in een nieuw browsertabblad openen
• De documenttitel bekijken
• Eventuele dia's die in het document zijn gemaakt presenteren
• Naar de modus Volledig scherm gaan
• Het venster Viewer-opties bekijken
  • Dit venster voor de Lucidchart-app bevat de mogelijkheid om notities en hotspots weer te geven, WebGL in te schakelen en bij te werken naar de nieuwste versie van het diagram

Vanaf de onderkant van het frame kunnen gebruikers: 

• Verschillende paginatabbladen in het Lucidchart-document selecteren om te bekijken
• Verschillende lagen in het diagram in het Lucidchart-document bekijken
• Inzoomen of uitzoomen op het diagram

Je Draw.io-diagrammen naar Lucidchart-documenten converteren

Volg deze stappen om je Draw.io-diagrammen te converteren naar Lucidchart-documenten in Confluence Data Center:

1. Ga naar de pagina met de documenten die je wilt converteren.
2. Open het bestand in Draw.io en download het als een XML-bestand.
3. Ga op je Confluence-pagina naar de bewerkingsmodus.
4. Gebruik het pluspictogram op de werkbalk bovenaan de editor om een nieuw Lucidchart-document in te voegen via de Lucidchart-selectie in de vervolgkeuzelijst.
5. Zodra de Lucidchart-editor is geopend, kun je het diagram importeren via het importmenu.
6. Nadat het diagram is geïmporteerd, selecteer je het in de documentenlijst en wordt het toegevoegd aan je Confluence-pagina. Op dit punt wordt je teruggeleid naar Confluence.
7. De conversie is nu voltooid en je kunt je oorspronkelijke Draw.io-diagram verwijderen van je Confluence-pagina.

Migreren van Confluence Data Center naar Confluence Cloud

Houd rekening met het volgende voordat je migreert van Confluence Data Center naar Confluence Cloud: 

• Documenten worden per ruimte geconverteerd, niet per pagina.
• Deze migratie kan niet in bulk ongedaan worden gemaakt zonder een eerdere back-up van de Confluence-instantie te herstellen.
• De conversie kan per document ongedaan worden gemaakt door naar het document te navigeren en de pagina vanuit de paginageschiedenis te herstellen.

Als je migreert van Confluence Data Center naar Confluence Cloud voor je Lucidchart-app, volg dan de onderstaande stappen om je documenten opnieuw in te stellen zodat ze weer worden weergegeven:

1. Ga naar het configuratiegedeelte van de Lucidchart-toevoeging.
2. Selecteer het tabblad “Confluence-conversie”.
3. Klik op Zoeken om diagrammen te vinden die moeten worden geconverteerd.
4. Selecteer Converteren.

Nadat je je documenten hebt gemigreerd, bekijk je ons artikel Lucid integreren met Confluence Cloud voor instructies over het gebruik van die integratie.

Veelgestelde vragen

Wie kan Lucid-documenten bekijken en bewerken die zijn ingesloten op een Confluence-pagina?
Weergavemachtigingen voor Lucid-documenten in Confluence Data Center worden overgenomen van de Confluence-pagina. Dit betekent dat als je een Confluence-pagina kunt bekijken, je de documenten op de Confluence-pagina kunt bekijken, ongeacht of je een Lucid-account hebt of niet. 

De Lucidchart-app in Confluence haalt ook toestemmingen voor bewerking op van de Confluence-pagina. Dit betekent dat als je een Confluence-pagina kunt bekijken en bewerken en een gelicentieerde Lucid-gebruiker bent, je de diagrammen in de Lucid-app kunt bekijken en bewerken door bij elk document op de knop Openen in Lucidchart te klikken.

De Lucidspark-app in Confluence vereist dat je zowel bewerkingsrechten in Confluence als bewerkingsrechten voor het ingesloten Lucidspark-whiteboard hebt om het document in Confluence te kunnen bewerken.

Waarom zit ik vast in een inloglus wanneer ik toegang probeer te krijgen tot de integratie?
Als je een inloglus ervaart waarbij je voortdurend wordt gevraagd om in te loggen bij Lucid wanneer je deze integratie gebruikt, komt dit hoogstwaarschijnlijk doordat cookies van derden door je browser worden geblokkeerd. Raadpleeg ons artikel Probleemoplossing: cookies van derden inschakelen voor meer informatie over hoe je die instelling kunt wijzigen, zodat ze niet langer worden geblokkeerd. 

Waarom zie ik witte marges rond mijn ingesloten Lucid-diagrammen in Confluence?
Enige witruimte rond je document kan normaal zijn bij het invoegen van diagrammen in Confluence. Raadpleeg het communitybericht Witruimte bij ingevoegde diagrammen (in het Engels) voor instructies over hoe je het uiterlijk van je ingesloten documenten kunt optimaliseren.

Waarom zie ik een OAuth-tijdstempelfout wanneer ik een Lucidchart-app voor Confluence Data Center probeer te installeren?
Als je de volgende OAuth-tijdstempelfout ziet wanneer je de Lucidchart Confluence Data Center-connector probeert te installeren en configureren,

'org.scribe.exceptions.OAuthException: Antwoordtekst is onjuist. Kan token en geheim hier niet uit ophalen: "oauth_problem=expired_timestamp,_yours_1359614629,_ours_1359585813"'

betekent dit waarschijnlijk dat de tijdstempel op je server die Confluence host niet helemaal nauwkeurig is. Zelfs als je servertijd in orde lijkt, kan een verschil van 15-30 seconden ertoe leiden dat twee servers niet met elkaar willen praten. Het is niet mogelijk om de servertijd handmatig met voldoende precisie aan te passen, dus je moet in dit geval je tijdstempel synchroniseren met een NTP-server.

Waarom krijg ik de foutmelding 'Je zit niet in een team dat aan deze instantie is gekoppeld'?
Deze fout betekent dat de gebruiker waarschijnlijk is gekoppeld aan een verkeerd Lucid-account. Volg deze stappen om dit op te lossen:

1. Log in bij je Lucid-account dat momenteel onjuist is gekoppeld aan Confluence. 
2. Klik op je profielafbeelding of initialen in de rechterbovenhoek van je Lucid-account.
3. Selecteer Accountinstellingen.
4. Selecteer Apps en integraties in het menu aan de linkerkant.
5. Vink het vakje naast 'Confluence' aan.
6. Klik op de knop Verwijderen. Hiermee wordt het account ontkoppeld.
7. Log uit bij Lucid om de juiste verbinding te herstellen. 
8. Voeg een Lucid-document in een Confluence-pagina in. 
9. Wanneer je wordt gevraagd om in te loggen bij Lucid, zorg er dan voor dat je inlogt met het e-mailadres dat is gekoppeld aan het Lucid-account van je organisatie.

Wat gebeurt er met de accountbrede Confluence-koppeling als de beheerder die deze oorspronkelijk heeft ingesteld vertrekt?
Als je beheerder vertrekt, blijft de koppeling actief, omdat deze op accountniveau tot stand is gebracht. Beheerdersrechten zijn alleen vereist tijdens het eerste installatieproces om de koppeling te maken.
 

Feedback geven over dit artikel