Problemen oplossen¶
De overzichtspagina is de eerste stop: ze toont falende projecten met de fout in woorden, de openstaande conflicten en de niet-gekoppelde personen, elk met een link naar waar het opgelost wordt.
Het OpenProject-token wordt geweigerd¶
| Symptoom | Wat het betekent | Oplossing |
|---|---|---|
| de koppelingskaart is rood, Token geweigerd | OpenProject weigerde het token: fout, ingetrokken, of de gebruiker is vergrendeld | maak een nieuw token onder Mijn account → Toegangstokens en Token vervangen; het wordt eerst getest |
| Geen OpenProject antwoordt op … | het adres is niet de root van een OpenProject-instantie | gebruik de basis-URL, zonder /api/v3 of een projectpad |
| Het adres kon niet bereikt worden | de instantie is niet via https vanaf het internet bereikbaar, of de host is een privénetwerkadres | controleer het adres; een OpenProject op een privénetwerk wordt niet ondersteund |
Een OpenProject-versie buiten het ondersteunde bereik¶
OpenProject Sync wordt ondersteund en getest op OpenProject 16.x en 17.x (de geteste releases zijn 16.6.10 en 17.9.7; zie Ondersteuning). Een oudere instantie kan nog synchroniseren, maar valt niet onder de compatibiliteitstests. Als iets faalt op een oudere versie, upgrade dan eerst OpenProject naar een ondersteunde release.
Een project faalt¶
De statuschip op de rij van het project legt de laatste fout in woorden uit; de pagina van het project herhaalt hem onder de activiteit. De gebruikelijke:
| Fout | Oorzaak | Oplossing |
|---|---|---|
| het API-token werd geweigerd | het token is ingetrokken of vervallen | vervang het token op de koppeling |
| de gebruiker mag dit niet doen | de gebruiker van het token verloor zijn rol op het project, of mist Werkpakketten bekijken / Uren registreren | geef de gebruiker de juiste projectrol |
| het project bestaat niet meer | het project werd verwijderd of gearchiveerd in OpenProject, of de gebruiker verliet het | herstel het of voeg de gebruiker opnieuw toe; verwijder anders de koppeling |
| Exact Online is niet verbonden | de Exact-verbinding van de app in het portaal werd verbroken of vraagt nieuwe authenticatie | verbind opnieuw in het portaal (de poort op de pagina's van de app linkt ernaar) |
| de administratie is niet ingeschakeld | de divisie waarnaar de koppeling wijst werd uit de ingeschakelde administraties gehaald | schakel ze weer in op de verbindingspagina, of wijs de koppeling opnieuw aan |
| begrensd door OpenProject of Exact | een gedeeld budget was bezet | niets te doen: de run wacht en probeert het bij de volgende beurt opnieuw |
Uren verschijnen niet in Exact¶
- Staat de tijdmodule van het project aan? OpenProject geeft enkel tijdregistraties terug voor projecten met de module Tijd en kosten (Projectinstellingen → Modules). Zonder die module vindt de synchronisatie niets om te boeken.
- Wie registreerde de tijd? Kijk bij Personen: de uren van een niet-gekoppelde gebruiker worden overgeslagen, niet op iemand anders geboekt. Koppel de gebruiker (of Negeer een serviceaccount) en de volgende run boekt ze. Automatisch koppelen vereist dat de projectrol van het token E-mailadressen van gebruikers bekijken heeft.
- Is er een uursoort? Zonder uursoort op de koppeling worden er geen uren gesynchroniseerd; stel er een in.
- Welke dag? De dag van een tijdregistratie wordt geteld in de tijdzone van de koppeling.
- Wanneer werd het geregistreerd? De eerste run neemt alles vanaf Geregistreerde tijd synchroniseren vanaf; oudere registraties worden niet geïmporteerd. Wijzig de datum in de instellingen van de koppeling en druk op Nu synchroniseren om ze te importeren (nieuwe regels worden als concept aangemaakt).
- Is de regel ingediend of goedgekeurd? De synchronisatie wijzigt enkel regels die Concept of Afgekeurd zijn. Een gewijzigde registratie voor zo'n regel is een conflict, geen stille overschrijving.
- Werd de regel in Exact verwijderd? Een verwijderde regel wordt nooit opnieuw aangemaakt.
De opmerkingen verschijnen niet in OpenProject¶
- de schakelaar voor statusopmerkingen staat uit op de koppeling (Instellingen), of
- de gebruiker van het token mag geen opmerkingen op werkpakketten plaatsen (voeg het recht toe aan de projectrol), of
- er veranderde niets: een opmerking wordt geplaatst wanneer de status van een werkpakket verandert, en werkpakketten met enkel concepten krijgen er geen.
De synchronisatie voelt traag¶
- een eerste run importeert het hele venster in pagina's; hij gaat verder bij latere beurten, de activiteitentabel toont het;
- Nu synchroniseren wacht zolang een run actief is; een project synchroniseert binnen een minuut na het verzoek;
- het schema staat standaard op elke 15 minuten, per project in Instellingen.
Nog vast?¶
Vermeld in je e-mail: de organisatie, het project en de administratie, het exacte bericht onder Laatste run van het project, en de datum. Zie Ondersteuning.