Wenn etwas nicht stimmt¶
Der Connector arbeitet still: Solange alles läuft, gibt es nichts anzusehen. Kommt dagegen eine Angabe nicht an, sagt diese Seite, wie man es merkt und was man prüft, bevor man jemanden anruft.
Die erste Prüfung¶
Fast jede Meldung der Art „in Odoo fehlt etwas“ klärt sich mit drei Fragen, in dieser Reihenfolge:
- Gibt es die Angabe in AppToMe? Eine unbestätigte Schicht erzeugt keine Stunden. Eine begonnene und nicht abgeschlossene Checkliste ist keine ausgefüllte Checkliste.
- Ist die Person verknüpft? Erscheint die freiwillige Person in Odoo nicht unter den Apptome-Freiwilligen, bleibt alles, was sie betrifft, zurück.
- Läuft die Synchronisation? Ist sie stehen geblieben, fehlt nicht eine einzelne Angabe: Es fehlen alle nach dem Moment des Stillstands.
Fehlt nur eine Sache, schaut auf die Punkte 1 und 2. Fehlt alles ab einem bestimmten Datum, ist es Punkt 3.
Wo man in Odoo nachsieht¶
Das Menü Apptome → Diagnose fasst zwei Listen zusammen:
- Protokoll eingehender Ereignisse — alles, was der Connector empfangen hat, mit Ergebnis. Es beantwortet die Frage „ist es angekommen?“.
- Tote/fehlgeschlagene Ereignisse — was nicht durchkam und die Versuche eingestellt hat. Ist diese Liste leer, ist die Synchronisation gesund; ist sie es nicht, gibt es etwas zu richten.
Die liegen gebliebenen Ereignisse lassen sich über dasselbe Menü neu einreihen, nachdem die Ursache der Blockade beseitigt wurde. Ein Neueinreihen ohne Ursachenbeseitigung lässt sie erneut scheitern.
Wie die Daten reisen, und was passiert, wenn Odoo aus ist¶
Das zu wissen erspart die beiden häufigsten Fehlgriffe: auf eine Angabe zu warten, die nie kommt, und wegen zehn Minuten Verzögerung alles neu zu starten.
Jede Änderung geht für sich raus. Ändert sich in AppToMe etwas — eine Schicht bestätigt, eine Checkliste geschlossen, ein Fahrzeug aktualisiert — wird es in die Warteschlange gestellt und sofort gesendet: Unter normalen Bedingungen sieht man es in Odoo binnen weniger Augenblicke. Es gibt keinen „Abendversand“, auf den man warten müsste.
Antwortet Odoo nicht, versucht es der Connector von allein erneut. Die Versuche werden in wachsenden Abständen einige Male wiederholt; solange noch Versuche übrig sind, ist das Ereignis nur fehlgeschlagen, nicht verloren. Eine kurze Unterbrechung — ein Neustart, eine Wartung, ein wackelndes Netz — holt sich von allein auf.
Sind die Versuche erschöpft, wird das Ereignis tot und bleibt liegen. Das erscheint dann unter Tote/fehlgeschlagene Ereignisse. Ab da läuft es nicht mehr von allein an: Es muss von Hand neu eingereiht werden, nachdem die Ursache beseitigt ist. Deshalb ist eine leere Liste das verlässlichste Gesundheitssignal, das ihr habt.
Eine periodische Prüfung fischt die Liegengebliebenen heraus. Alle paar Minuten werden noch ausstehende oder fehlgeschlagene Ereignisse wieder eingereiht, nach ihrem Entstehungszeitpunkt: die ältesten zuerst. Nach einer Blockade muss man also nichts neu starten — einfach ein paar Runden abwarten und schauen, ob sich die Warteschlange leert.
Neu starten dupliziert nicht. Jedes Ereignis trägt eine Kennung, die Odoo erkennt: Kommt es zweimal an, wird das zweite ignoriert. Neu einreihen, einen einzelnen Punkt neu starten oder die vollständige Synchronisation wiederholen sind hinsichtlich Dubletten sichere Vorgänge.
Die Stunden haben ein Sicherheitsnetz. Eine Schicht kann enden, ohne dass sie noch jemand anfasst: Eine tägliche Prüfung geht die in den letzten 48 Stunden beendeten Schichten noch einmal durch und gibt deren Stunden trotzdem aus. Fehlen die Stunden einer Schicht von gestern, wartet diese Runde ab, bevor ihr es meldet; fehlen die einer Schicht von vor einem Monat, hat das eine andere Ursache, und die steht in der Tabelle weiter unten.
Häufige Situationen¶
| Symptom | Wahrscheinlichste Ursache | Was zu tun ist |
|---|---|---|
| Die Stunden einer Schicht erscheinen nicht in Odoo | die Schicht wurde nicht bestätigt | bestätige die Schicht in AppToMe |
| Die Stunden einer Person fehlen, die der anderen nicht | die Person ist zwischen beiden Systemen nicht verknüpft | starte den Stammdatenabgleich neu und verknüpfe sie |
| Ab einem bestimmten Datum kommt nichts mehr an | die Synchronisation wurde ausgesetzt oder die Zugangsdaten gelten nicht mehr | der Odoo-Partner prüft die Konfiguration und fragt beim Support, ob die Zugangsdaten neu erzeugt werden müssen |
| Dieselbe Person erscheint zweimal in Odoo | beim ersten Abgleich wurde Neu anlegen statt Verknüpfen gewählt | führe die beiden Kontakte in Odoo zusammen und behalte den mit AppToMe verknüpften |
| Die Schaltfläche Mit Apptome anmelden fehlt | die Anmeldung mit AppToMe-Konto ist in der Konfiguration nicht aktiv | der Odoo-Partner aktiviert sie in den Einstellungen |
| Die Anmeldung sagt, die Einladung sei abgelaufen | dein Odoo-Benutzer ist nicht mit deinem AppToMe-Konto verknüpft | bitte die Odoo-Verwaltung um die Verknüpfung |
| Die alten Daten fehlen, die neuen kommen an | der erste Ladevorgang wurde nie abgeschlossen | der Odoo-Partner startet die vollständige Synchronisation neu |
| Fehler nach einer Aktualisierung eines der beiden Systeme | Versionen laufen auseinander | aktualisiere auch die andere Seite |
Wann sich ein kompletter Neustart lohnt¶
Die vollständige Synchronisation neu zu starten ist sicher — sie dupliziert nicht, was schon da ist — kann aber lange dauern. Sinnvoll ist es:
- nach einem längeren Ausfall von Odoo;
- nachdem viele liegen gebliebene Stammdaten verknüpft wurden;
- nach einer Aktualisierung, die die Versionen beider Seiten in Einklang gebracht hat.
Man kann auch einen einzelnen Punkt neu starten (nur die Schichten, nur die Stunden, nur die Nachweise), wenn das Problem einen bestimmten Bereich betrifft: Das geht viel schneller.
Was dem Support zu melden ist¶
Bleibt das Problem, schreibt dem AppToMe-Support und gebt an:
- den Namen der Organisation;
- was fehlt oder falsch ist, mit einem konkreten Beispiel: eine Person, ein Datum, eine Schicht;
- seit wann es passiert;
- ob unter Apptome → Diagnose → Tote/fehlgeschlagene Ereignisse etwas steht und wie viel;
- was schon versucht wurde.
Warning
Hängt der Meldung niemals die Verbindungsschlüssel oder Zugangsdaten an und fügt sie nicht in einen Chat oder ein Ticket ein. Der Support braucht den Namen der Organisation, nicht ihre Zugangsdaten.