Probleemoplossing¶

De Overview-pagina is de eerste stop: hij toont mislukte projecten met de fout in woorden, de open conflicten en de ongekoppelde gebruikers, elk met een link naar waar het opgelost wordt.

Het GitLab-token wordt geweigerd of is verlopen¶

Symptoom	Betekenis	Oplossing
de verbindingskaart is rood, Ongeldig	het token werd geweigerd door GitLab	Token vervangen met een geldig token; de vervanging wordt getest voordat het opgeslagen wordt
de kaart is amber, Verloopt over n dagen	het token heeft een vervaldatum binnen 14 dagen	vervang het (of laat het verlopen: de kaart wordt rood en de gekoppelde projecten falen met een duidelijke fout)
Het GitLab-adres kon niet worden bereikt	het instance is niet bereikbaar via https (verkeerd adres, of een instance op een privaat netwerk, self-hosted instances moeten bereikbaar zijn vanaf internet)	controleer het adres in de kaart; een GitLab op een privaat netwerk wordt niet ondersteund

Een GitLab-versie buiten het ondersteunde bereik¶

GitLab Sync wordt ondersteund en getest op GitLab 17.x, 18.x en 19.x (de geteste releases zijn 17.11.7, 18.11.14 en 19.5.3; zie Ondersteuning). Een ouder instance kan nog steeds syncen, maar het wordt niet gedekt door de compatibiliteitssuite. Als er iets mislukt op een oudere versie, upgrade dan eerst GitLab naar een ondersteunde release; de fix zit dan in de versie die we kunnen testen.

Een project faalt¶

De statusbadge op de rij van het project verklaart de laatste fout in woorden; de projectpagina herhaalt dit onder de activiteit. De meest voorkomende:

Fout	Oorzaak	Oplossing
het token werd geweigerd	het token is verlopen, of het heeft toegang tot het project verloren	vervang het token op de verbinding, of voeg het project opnieuw toe aan de scope van het token
Exact Online is niet verbonden	de Exact-verbinding van de app in het portaal was disconnected of vereist her-authenticatie	maak opnieuw verbinding in het portaal (het poortje op de pagina's van de app linkt daarheen)
de administratie is niet ingeschakeld	de divisie waarnaar de koppeling verwijst werd verwijderd uit de ingeschakelde administraties van de verbinding	schakel het opnieuw in op de verbindingpagina, of wijs de koppeling opnieuw aan
rate limited door Exact	het gedeelde Exact-budget was bezig	niets om op te lossen: de run trekt zich terug en probeert opnieuw bij de volgende beurt

Uren verschijnen niet in Exact¶

Wie heeft de tijd gelogd? Controleer Personen: de uren van een ongekoppelde gebruiker worden overgeslagen, niet geboekt op iemand anders. Koppel de gebruiker (of Neger een bot) en de volgende run boekt het.
Welke dag? Een tijdslage's dag wordt geteld in de tijdzone van de koppeling. Een log rond middernacht kan aan de andere kant van de dag belanden dan verwacht; controleer de tijdzone van de koppeling als het er een dag naast zit.
Wanneer is het gelogd? De eerste run pakt alles vanaf Sync tijdsgelogd vanaf; oudere logs worden niet geïmporteerd. Verander de datum in de instellingen van de koppeling en druk op Sync nu om ze te importeren (nieuwe regels worden aangemaakt als concept).
Is de regel goedgekeurd? De sync wijzigt alleen regels die Concept of Geweigerd zijn. Een goedgekeurde regel is een conflict, geen stilzwijgende overschrijving.
Is de regel verwijderd in Exact? Een verwijderde regel wordt nooit opnieuw aangemaakt.

De labels komen niet terug naar GitLab¶

de back-sync-schakelaar staat uit op de koppeling (Instellingen), of
het token van de verbinding is alleen-lezen (read_api): labels hebben de api scope nodig, vervang het token, zet daarna de schakelaar aan, of
de gebruiker van het token kan geen labels schrijven op het project (GitLab-recht).

De sync voelt traag aan¶

een eerste run importeert het hele venster in pagina's van 100 issues; hij gaat verder bij latere beurten, de activiteitenlijst toont dit;
een webhook (het bliksemsymbool) zorgt ervoor dat wijzigingen binnen enkele seconden aankomen in plaats van bij de volgende 15-minuten beurt;
Sync nu wacht terwijl een run actief is; de spinner op de rij betekent dat het in de wachtrij zit voor de volgende vrije beurt.

Nog steeds vastgelopen?¶

Voeg in je e-mail toe: de organisatie, het project en de administratie, het exacte bericht onder de Laatste run van het project, en de datum. Zie Ondersteuning.