FixControl/Documentatie

Gebruikershandleiding

Problemen oplossen

Wat het vaakst blijft hangen en wat het echt betekent — er komt geen mail binnen, een test wordt niet groen, een patch wordt niet toegepast, een goedkeuring die niemand kan geven, een preview die niet opent, een workspace waar je niet in kunt.

FixControl probeert bij elke weigering te zeggen wat er misging, waarom, en wat je nu doet. Deze pagina verzamelt de meldingen die mensen het vaakst zien, met de tekst op het scherm en wat er echt aan de hand is.

Vraag het eerst aan het Command Center. Het antwoordt voor jouw situatie: "Is dit project klaar?", "waarom faalde deze controle?", "waarom kan deze wijziging niet worden toegepast?", "waarom is deze release geblokkeerd?", "waar wacht men op mij?", "in welke workspaces kan ik?" en "waar komt ons werk binnen?". Het kan ook handelen: "maak dit project klaar" pakt op wat het zelf kan oplossen.

Er komt geen mail binnen in de Inbox

Wat je zietWat het betekentWat je doet
Een doorstuurmailbox staat op Ingesteld, wacht op de eerste e-mailHet doorsturen is nog niet ingesteld of nog niet bevestigd.Rond het doorsturen af bij je mailservice en stuur een testbericht. Zie E-mail koppelen.
Inloggen werkt niet meerDe toestemming bij Microsoft of Google is ingetrokken of verlopen.Opnieuw verbinden onder Instellingen → Mailboxen.
Er komt mail binnen, maar er ontstaat geen issueAutomatisch issues aanmaken staat uit voor de mailbox (de standaard), of de mailbox hangt niet aan een project.Gebruik Issue aanmaken, of laat een beheerder automatisch aanmaken aanzetten en een project koppelen. Zie Inbox.
Een antwoord kan niet worden verstuurdAntwoorden toestaan staat uit voor de mailbox (de standaard).Laat een beheerder het aanzetten onder Instellingen → Mailboxen.

De chatbot reageert niet

De bot reageert alleen op /fix, een vermelding, een direct bericht, of een reactie in een thread waar hij al in werkt. Vraagt hij je je account te koppelen, voer dan /fix link uit. Wordt een beslissing vanuit chat geweigerd, dan is je chataccount niet verhoogd of mag je rol in deze workspace niet beslissen. Zie Communicatiekanalen.

Tickets die je direct in Freshdesk, Linear, Odoo of TOPdesk aanmaakt, worden niet vanzelf een issue. FixControl maakt tickets aan vanuit issues en volgt hun status. Een Jira-ticket wordt wel een issue als Nieuwe Jira-tickets als issue binnenhalen aanstaat op de Jira-koppeling van het project en de Jira-webhook is ingesteld; komt het niet binnen, controleer dan beide, en of het ticket bij het Jira-project of de component van de koppeling hoort.

Een project zegt dat het niet klaar is

Gereedheid is samengesteld, dus het antwoord is meestal één ontbrekend stuk. De gebruikelijke oorzaken, in de volgorde waarin ze opspelen:

  1. Geen repository gekoppeld — open Verbindingen in het project en kies Repository koppelen.
  2. Geen geverifieerde omgeving — FixControl heeft nog niet bewezen hoe de applicatie gebouwd en gestart wordt. Open Omgevingen en start een verificatie.
  3. Er wacht een vraag — beantwoord die onder Wat FixControl moet weten en kies Antwoorden en opnieuw proberen.
  4. Geverifieerd, maar zonder startcommando — normaal: de tests draaiden, er werd niets gestart. De kaart zegt dat en biedt aan een startcommando te zoeken.
  5. Een verbinding is ingesteld maar niet getest — gebruik de test bij Verbindingen.

Een test wordt niet groen

Begin met waarom hij niet groen is — de drie oorzaken zijn echt verschillend.

De tests faalden. Dat gaat over je code, en het is het enige geval dat tot een nieuwe, door AI voorbereide herziening leidt. Waar je het hebt aangezet, onderzoekt de ontwikkelagent eerst de container waarin de run faalde; dat zie je op de run.

De omgeving faalde. Een image dat niet laadde, een afhankelijkheid die niet installeerde, een dienst die niet opkwam. Dit leidt nooit tot een voorgestelde wijziging aan je code.

De applicatie startte niet. Tests groen, starten mislukt. Je ziet Startte niet bij Startte de applicatie?, en de patch wordt niet opgeleverd. Klopt het startcommando zelf niet, pas het dan aan onder Omgevingen → Omgevingsinstellingen en kies Opslaan en verifiëren.

Twee uitslagen zijn geen oordeel: De tests hebben nooit gedraaid — geen uitslag (een eerdere stap stopte de run) en De teststap draaide, maar selecteerde geen enkele test. Zie Verificatie en resultaten.

"Deze controle is nooit gedraaid"

De run stopte voordat hij draaide, en de melding noemt wat er ontbreekt. Veelvoorkomend:

  • Een .NET Framework- of WinDev-project. FixControl herkent het en plant de echte build- en testcommando's, maar voert ze vandaag niet uit: de Windows-omgeving voor .NET Framework is gebouwd, maar staat nog niet aan en is nog niet bewezen, en WinDev vraagt een gelicentieerde installatie van PC SOFT die FixControl niet levert. De melding noemt precies wat er nodig zou zijn. Dit is een weigering, geen stille pas.
  • Deze run had geen project. Het issue hangt niet aan een project, dus er was geen testomgeving. Koppel het issue aan een project en start de verificatie opnieuw.

Een patch wordt niet toegepast

Op volgorde van hoe vaak het voorkomt:

  • Er staat nog een goedkeuring open. Kijk bij Goedkeuringen — de kaart noemt op wie hij wacht.
  • De test is niet geslaagd, of hoort bij een oudere versie. Bewijs is gekoppeld aan de patch, de images, de configuratie en het plan. Verandert er één, dan geldt de oude groene run niet meer; start de verificatie opnieuw.
  • Het bewijs dat de applicatie start ontbreekt. De omgeving weet hoe de applicatie start, maar geen run heeft dat laten zien. De kaart zegt (in het Engels): The tests passed but nothing proved the application still starts; rerun the verification so its start target is exercised. Voor een project dat alleen in je eigen omgeving wordt gevalideerd: zie Change-validatie.
  • Een vereiste testomgeving heeft niet gedraaid. Bij Eerst Docker, dan je eigen omgeving moeten beide slagen. Een lokale pas vervangt nooit de andere.

Zie Wijzigingen opleveren.

Een goedkeuring wacht en niemand kan hem geven

Standaard beslist één actieve admin of manager. Staat goedkeuring in fasen aan, dan beslist per fase wie die rol heeft, één persoon per fase; een route met drie fasen vraagt dus drie verschillende mensen. Heeft niemand een rol, dan valt de fase terug op een willekeurige admin of manager. Heeft je organisatie helemaal geen actieve admin of manager, dan blijft de poort wachten. Zie Goedkeuringen.

Een preview opent niet

Previews staan standaard aan, maar een workspace kan ze uitzetten, en ze hebben een geverifieerde omgeving met een startcommando nodig.

  • voorbeelden staan uit voor deze workspace — een admin of manager zet ze aan onder Instellingen → Overzicht & voortgang.
  • Startte niet met een reden — de applicatie kwam niet op. De faseregel laat zien hoe ver het kwam.
  • Dit project moet op je eigen runner worden gevalideerd… — een project dat validatie in je eigen omgeving vereist, krijgt geen preview.
  • De pagina laadt, maar zonder opmaak. De applicatie gebruikt absolute paden voor haar bestanden en je FixControl-omgeving heeft nog geen eigen hostnaam per preview. Dat richt FixControl in, niet het project.

Een preview stopt altijd vanzelf, en stoppen kost niets — het bewijs staat bij de run.

Ik kan niet naar een workspace wisselen

Wat je zietWat het betekentWat je doet
Wordt verwijderdVerwijdering is ingepland; de gegevens zijn er nog tijdens de hersteltermijn.FixControl-platformbeheerders kunnen hem binnen de termijn herstellen.
GeblokkeerdDe workspace is opgeschort.Vraag je FixControl-contactpersoon.
Staat er helemaal niet bijJe bent er geen lid van.FixControl-platformbeheerders geven toegang tot een tweede workspace.
Wisselen van workspace is niet gelukt met een melding over tweestapsverificatieDe andere workspace vereist tweestapsverificatie.Stel tweestapsverificatie in of bevestig die, en wissel opnieuw.
Wisselen van workspace is niet gelukt en opnieuw inloggen helptJe sessie is ingetrokken, meestal omdat je rol veranderde.Log opnieuw in.

Wisselen verandert de workspace voor elk open tabblad. Zie Wisselen van workspace.

Een verbinding meldt een probleem

De status staat per functie, nooit als één algemeen "verbonden". Een mailbox die kan ontvangen maar niet versturen, toont precies dat. Mislukt er iets, kijk dan naar de status van de verbinding onder Instellingen → Kanalen, de leverstatus op het issue of de goedkeuring die erop wachtte, en de auditlog. Een schrijfactie naar een extern systeem wordt in een wachtrij gezet, opnieuw geprobeerd en bij blijvend falen gemeld.

Er gebeurde iets wat ik niet verwachtte

Beslissingen onder governance worden vastgelegd: wie besliste, wanneer, op basis van welk bewijs en via welk kanaal. Admins en managers bekijken ze onder Instellingen → Audit (zichtbaar met Geavanceerde instellingen tonen). Op de plannen Pro en Enterprise kun je de log exporteren als ondertekende CSV die aantoont dat het bestand na export niet is gewijzigd. Een genomen beslissing kan achteraf niet worden aangepast, en het verwijderen van een project, issue of koppeling verwijdert de vastlegging van wat erover besloten is niet.

Kom je er niet uit?

Geef je FixControl-contactpersoon drie dingen: de workspace, de exacte tekst op het scherm, en de id van de run, patch of het issue. Meldingen zijn bewust zo geschreven dat je ze kunt citeren.

Zie ook: Aan de slag · Goedkeuringen · Verificatie en resultaten · Wijzigingen opleveren

Iets onduidelijk of fout?Laat het ons weten →

FixControl is een handelsnaam van FixControl B.V.