Ga naar inhoud

Aan de slag

Van een nieuwe organisatie tot een draaiende synchronisatie duurt een paar minuten. De overzichtspagina van de app toont een checklist en houdt die bij tot elke stap klaar is.

Probeer het 14 dagen gratis

Elke organisatie kan een gratis proefperiode van 14 dagen van OpenProject Sync starten: geen betaalmiddel nodig, één proefperiode per organisatie en app. Start ze met de knop Nu proberen van de app in het Exact App Center (je meldt je aan met Exact Online en het portaal maakt je account en organisatie aan), of in het portaal onder Organisatie → Abonnementen. Wanneer de proefperiode afloopt, stopt de toegang; abonneren tijdens de proefperiode behoudt alles en het abonnement start wanneer de proefperiode eindigt.

Een abonnement kan op elk moment worden opgewaardeerd onder Organisatie → Abonnementen: het nieuwe abonnement wordt volledig aangerekend en de ongebruikte dagen van het oude worden terugbetaald via een creditnota.

Vereisten

  • Een account in het Exact Gateway portaal (https://apps.mvdw-software.com/exact/portal/) en een organisatie met een actief OpenProject Sync-abonnement (afgesloten in het portaal onder Organisatie → Abonnementen).
  • Een Exact Online-verbinding voor deze app: kies in het portaal onder Organisatie → Exact Online-verbinding de app OpenProject Sync en meld je aan met het Exact-account dat de tijd, projecten en medewerkers van de te synchroniseren administraties mag lezen. Dezelfde pagina toont de administraties (divisies) die voor deze app zijn ingeschakeld.
  • Een OpenProject-instantie, cloud of self-hosted, bereikbaar vanaf het internet via https, en een gebruiker die lid is van de te synchroniseren projecten.
  • Wijzigingen (een OpenProject-koppeling, een gekoppeld project, personen) worden gemaakt door organisatiebeheerders, en beheeracties vereisen tweestapsverificatie in het portaal. Pagina's bekijken kan elk lid.

Vereisten in OpenProject

  • De gebruiker van het token heeft een projectrol nodig met Werkpakketten bekijken, Tijdregistraties bekijken en Uren registreren op elk project dat je koppelt. De rol Projectbeheerder heeft ze allemaal.
  • Schakel de module Tijd en kosten in voor het project (Projectinstellingen → Modules). De tijdregistratiemodule alleen is niet genoeg: OpenProject toont tijdregistraties enkel via zijn API wanneer het project de kostenmodule heeft.
  • Om personen automatisch te koppelen moet de gebruiker van het token de e-mailadressen van de andere leden kunnen zien: een beheerder kan dat altijd; voeg voor een projectrol het recht E-mailadressen van gebruikers bekijken toe. Zonder dat recht staan de personen onder Personen en kies je zelf hun Exact-medewerker.

Ondersteunde OpenProject-versies

OpenProject Sync werkt met OpenProject cloud en self-hosted OpenProject. De compatibiliteitstests draaien tegen één release van elke ondersteunde hoofdversie:

OpenProject Geteste release CI
16.x 16.6.10 unit, contract en e2e
17.x 17.9.7 unit, contract en e2e

De unit- en contracttests oefenen de OpenProject API-client tegen elke release, en een volledige synchronisatie is uitgevoerd tegen echte instanties van beide. Het API-oppervlak dat de app gebruikt is stabiel over deze hoofdversies. De geteste releases zijn OpenProject Community Edition; de Enterprise-editie biedt dezelfde API. Oudere versies kunnen werken, maar worden niet ondersteund en niet getest. Weet je niet welke versie je draait? OpenProject toont ze onder Administratie → Informatie.

De vier stappen, in volgorde:

  1. Exact Online verbinden (één keer, in het portaal);
  2. Een OpenProject-koppeling toevoegen;
  3. Je eerste project koppelen;
  4. De personen koppelen die na de eerste synchronisatie verschijnen.

Exact Online verbinden

Open in het portaal Organisatie → Exact Online-verbinding en kies de app OpenProject Sync (elke app heeft zijn eigen verbinding). Meld je aan bij Exact Online en kies de in te schakelen administraties.

Per app, per organisatie

Het portaal bewaart één Exact-verbinding per organisatie en per app. Data Bridge, GitLab Sync en OpenProject Sync verbinden afzonderlijk, dus een organisatie die er meerdere gebruikt verbindt voor elk één keer.

Een OpenProject-koppeling toevoegen

Open in OpenProject Sync OpenProject-koppelingen en druk op OpenProject-koppeling toevoegen.

Het dialoogvenster voor een nieuwe koppeling: naam, adres en toegangstoken, met het hulpvak en de link om een token in OpenProject aan te maken

  • Naam: alles waaraan je de instantie herkent, bv. OpenProject cloud of onze-openproject.
  • Adres: de basis-URL van de instantie, bv. https://voorbeeld.openproject.com, zonder /api/v3 of een projectpad. Een slash op het einde wordt voor je verwijderd; enkel https wordt aanvaard.
  • Toegangstoken: een API-token aangemaakt in OpenProject, zie hieronder.

De knop Testen en opslaan controleert het token bij OpenProject voordat er iets wordt bewaard; een geweigerd token wordt niet bewaard.

Welk token aanmaken

Open in OpenProject Mijn account → Toegangstokens en maak een API-token aan (het hulpvak in het dialoogvenster linkt rechtstreeks naar die pagina). Een OpenProject API-token heeft geen scopes: het werkt als de gebruiker die het aanmaakte, dus wat de synchronisatie kan zien en doen is precies wat die gebruiker mag.

  • Maak het token aan met een gebruiker die de projectrol heeft die onder Vereisten in OpenProject staat, op de te synchroniseren projecten. Een specifieke servicegebruiker, toegevoegd als lid van die projecten, houdt de synchronisatie onafhankelijk van het account van één persoon.
  • Om de app statusopmerkingen op werkpakketten te laten plaatsen, heeft de gebruiker ook het recht nodig om opmerkingen toe te voegen. Zonder dat recht worden de uren nog steeds gesynchroniseerd; enkel de opmerkingen worden overgeslagen.
  • Een token kan op elk moment in OpenProject worden ingetrokken; de koppeling toont dan Token geweigerd.

De koppelingskaarten

Elke instantie is een kaart met zijn status, de laatste vier tekens van het token (het token zelf wordt nooit meer getoond) en het aantal gekoppelde projecten:

De pagina OpenProject-koppelingen: een kaart met status, token en gekoppelde projecten, met Testen, Token vervangen en Ontkoppelen

Actie Wat het doet
Testen controleert het token opnieuw en toont het resultaat op de kaart (bv. De koppeling werkt als @speeters)
Token vervangen je typt het nieuwe token in een afgeschermd venster, het wordt getest en vervangt het oude als het geldig is
Ontkoppelen verwijdert de instantie; de bevestiging somt elk gekoppeld project op dat stopt met synchroniseren

Je eerste project koppelen

Met een koppeling op zijn plaats open je Projecten → Project synchroniseren en volg je de vier stappen, dat is het hele verhaal, met een schermafbeelding per stap.

De personen koppelen

Na de eerste synchronisatie verschijnen de OpenProject-gebruikers die tijd registreerden onder Personen. De meeste worden automatisch gekoppeld aan een Exact-medewerker op hun e-mailadres; de rest wordt gemarkeerd tot je een medewerker kiest (of Negeren). Zie Personen.

Wanneer de checklist op de overzichtspagina volledig is afgevinkt, verdwijnt ze en toont de pagina de synchronisatiegezondheid:

De overzichtspagina na de instelling: de gezondheidstegels (gesynchroniseerd in de laatste 24 u, falend, conflicten, niet gekoppeld)