Odoo Workflows

1Inschakelen

Werk de Blipit-module bij naar 1.15.0 of nieuwer: Apps, Blipit Error Monitoring, Bijwerken. Meer hoef je niet in te stellen. Het tellen begint bij de volgende knop die een gebruiker indrukt, en Workflows verschijnt in de zijbalk van app.blipit.io voor projecten die aan Odoo gekoppeld zijn. Tot de eerste stap binnenkomt, meldt de pagina dat hij wacht op de eerste workflow uit je database.

2Wat de pagina Workflows toont

Tegels bovenaan tellen de falende workflows, de getroffen mensen, de wachtende documenten en de getroffen bedrijven. Daaronder zijn de workflows gegroepeerd per app (Verkoop, Boekhouding, Voorraad, Kassa, Geplande taken enzovoort), elk met zijn slagingspercentage en de status Failing, Degraded of Healthy. Filter op app, op bedrijf en op de laatste 24 uur, 7 dagen of 30 dagen. Open een workflow om dit te zien:

• Pogingen, mislukkingen, getroffen mensen en bedrijven, met het verloop van het slagingspercentage over de periode.
• Waarom hij mislukt: de issues achter de mislukkingen, elk gemarkeerd als Crash of Blocked, gelinkt aan de issuepagina.
• Wachtende documenten: elke order, factuur of levering die een mislukte stap raakte, elk direct gelinkt aan het record in je Odoo.
• De issuepagina toont hetzelfde verband van de andere kant: de workflows die een fout brak en de records die hij raakte. Het Overzicht toont je drie slechtste workflows.

3Welke stappen tellen

Blipit telt de knoppen die een document verder brengen: die van Odoo zelf, zoals Offerte bevestigen, Factuur aanmaken, Factuur boeken, Betaling registreren, Creditnota, Levering valideren, Inkooporder bevestigen en Kassasessie sluiten, en de action_- en button_-methoden van je eigen modules, die onder hun app verschijnen met een naam die uit de methode is gemaakt (action_approve_order wordt Approve order). Elke run van een geplande taak telt ook, inclusief Handmatig uitvoeren, en net zo serveracties die vanuit het menu Actie worden gestart. Weergaven openen, afdrukken en andere leesaanroepen tellen niet mee, zodat de lijst kort blijft.

4Geblokkeerd, gecrasht en time-out

Elke poging eindigt op een van vier manieren. Geslaagd: de stap is afgerond. Geblokkeerd: Odoo hield de gebruiker tegen met een bericht waar hij iets mee kan (een UserError, ValidationError of AccessError, zoals een ontbrekende rekening of een ontbrekende route). Gecrasht: een onverwachte fout. Time-out: Odoo stopte een geplande taak omdat die te lang liep. Geblokkeerde stappen tellen volledig mee voor het slagingspercentage, en 1 op de 20 wordt ook bewaard als waarschuwingsevent zodat je de oorzaak kunt lezen; geblokkeerde stappen alarmeren nooit iemand. Crashes en time-outs komen binnen als foutevents, net als alle andere.

5Elke minuut geteld

Elke Odoo-worker telt zijn pogingen op in het geheugen en stuurt ze eens per minuut in één klein request naar Blipit, en stuurt niets als hij stilstaat. Bepalen of een aanroep een workflow is, is een eenvoudige opzoeking zonder databasequery, dus pagina's worden niet trager. De tellingen worden niet als events gefactureerd; alleen fouten en de steekproeven van geblokkeerde stappen tellen mee voor de events van je plan.

6De banner op het record

Als een stap op een record mislukt, zien mensen die die order, factuur of levering in Odoo openen een rode banner die zegt welke stap mislukte, wanneer en waarom. Hij verdwijnt zodra de stap de volgende keer op dat record slaagt. Alleen interne gebruikers zien hem. De banner vraagt Solo of een hoger plan en staat standaard aan; zet hem uit in Odoo onder Instellingen, Blipit, Workflows. Op dezelfde plek kun je een chatternotitie van één regel op het record inschakelen wanneer een stap mislukt. De notitie staat standaard uit, omdat hij in je records schrijft.

7Meldingen

De pagina Meldingen heeft een sectie Workflowmeldingen met twee regels die vanaf het begin aanstaan. Mislukt voor veel mensen gaat af wanneer 3 of meer mensen binnen 10 minuten op dezelfde workflow een crash krijgen. Geplande taak mislukt gaat af wanneer een geplande taak 2 runs achter elkaar mislukt of een time-out krijgt. Je kunt de drempel en de periode aanpassen of een regel uitzetten. Workflowmeldingen gaan naar dezelfde mensen en kanalen als je andere meldingen (e-mailregels, Slack, Microsoft Teams en webhooks, of de eigenaren als er geen zijn), houden rekening met snoozes en het uurbudget voor meldingen, sturen één melding per workflow en sturen een sein veilig zodra het probleem 15 minuten weg is. Geblokkeerde stappen geven nooit een melding.

8Plannen

• Elk plan: mislukkingen per workflow, de getroffen mensen, de wachtende documenten met hun Odoo-links, de oorzaken en de melding Mislukt voor veel mensen.
• Solo en hoger: slagingspercentages, pogingen en het verloop, de melding Geplande taak mislukt en de banner op het record in Odoo.
• Geschiedenis: 7 dagen op Free, 30 dagen op betaalde plannen.
• Pogingen worden op elk plan geteld, dus slagingspercentages verschijnen voor je recente geschiedenis zodra je upgradet.

9Privacy

Geslaagde stappen worden alleen als tellingen verstuurd: de workflow, het bedrijf en hoeveel. Een mislukte stap stuurt ook de record-id's van de documenten die hij raakte (maximaal 20), het Odoo-gebruikers-id en het bedrijfs-id, allemaal als gewone getallen. Workflowgegevens bevatten nooit bedragen, namen of berichten. Het bericht dat Odoo een geblokkeerde gebruiker liet zien, blijft in je eigen Odoo-database, waar de banner het leest. De steekproeven van 1 op de 20 geblokkeerde stappen zijn foutevents, en uit hun bericht worden getallen en waarden tussen aanhalingstekens verwijderd voordat het Odoo verlaat.

Goed om te weten

• Werkt met Odoo op je eigen servers en op Odoo.sh. Odoo Online staat geen modules van derden toe.
• Als Odoo een worker herstart, bijvoorbeeld nadat hij limit_request bereikt, kan tot een minuut aan tellingen van die worker verloren gaan. Slagingspercentages kunnen daar tegen.
• Als Odoo een stap opnieuw probeert na een databaseconflict, telt alleen de uiteindelijke uitkomst.
• Fouten uit oudere moduleversies tonen hun workflow nog steeds op de issuepagina als het request de knop noemt, maar slagingspercentages en wachtende documenten hebben 1.15.0 nodig.
• Recordlinks openen je Odoo op het adres dat de module bij het koppelen doorgaf, als /odoo/<model>/<id>.
• Gegevens over mislukte stappen volgen de workflowgeschiedenis van je plan; een record waarvan de stap later slaagde, wordt na 7 dagen verwijderd.