Zum Hauptinhalt springen

Unterbrochene Schritte

Ein Prozessschritt läuft in einer Hintergrund-Session. Bricht diese Session oder der Dienst während der Ausführung ab (z. B. nach einem Neustart des Dienstes oder einem Absturz), bleibt der Schritt auf Gestarted und der eBeleg auf Schritt gestartet. Fehler nachholen greift nur fehlerhafte Schritte auf, deshalb konnte ein solcher eBeleg bisher nicht fortgesetzt werden.

mseDoc365 bietet zwei Wege:

  • eine Bereinigung über die Aufgabenwarteschlange, die unterbrochene Schritte auf Fehlerhaft setzt, sodass sie wie gewohnt wiederholt werden können
  • die Aktion Wiederholen erzwingen auf der eBeleg-Karte für einen einzelnen eBeleg

Woran mseDoc365 einen unterbrochenen Schritt erkennt​

Jeder Schritt speichert beim Start drei Werte: Gestartet am, Session-ID und Serverinstanz-ID. Ein gestarteter Schritt gilt als noch laufend, wenn

  • sein Task noch geplant ist, oder
  • eine Session mit derselben Session-ID und Serverinstanz-ID aktiv ist, die nicht später als der Schritt gestartet wurde (eine nach einem Neustart wiederverwendete Session-ID zählt nicht).

Hat der Benutzer keine Leserechte auf die aktiven Sessions, gilt der Schritt als noch laufend.

Bereinigung einrichten​

  1. Öffnen Sie Aufgabenwarteschlangenposten und legen Sie einen neuen Posten an.
  2. Typ des auszuführenden Objekts = Codeunit, ID des auszuführenden Objekts = 5563632 (mseBC mseDoc365 Stuck Steps).
  3. Verwenden Sie eine eigene Aufgabenwarteschlangenkategorie. Verwenden Sie nicht die mseDoc365-Kategorie: Deren Posten erwarten einen mseDoc365-Jobcode in der Parameterzeichenfolge.
  4. Optional: Parameterzeichenfolge = Wartezeit in Minuten. Ein Schritt wird erst auf Fehlerhaft gesetzt, wenn er vor mehr als dieser Zeit gestartet wurde. Standard: 60 Minuten, höchstens 30 Tage.
  5. Richten Sie den Posten wiederkehrend ein (z. B. alle 15 Minuten) und setzen Sie ihn auf Bereit.

Die Bereinigung

  • setzt jeden unterbrochenen Schritt auf Fehlerhaft und schreibt einen Fehlereintrag mit der verlorenen Session,
  • startet einen Schritt nie selbst neu — wiederholen Sie den eBeleg danach wie gewohnt,
  • lässt Schritte unverändert, die In Bearbeitung sind, noch laufen, jünger als die Wartezeit sind oder gestartet wurden, bevor es diese Funktion gab (sie haben kein Gestartet am).

Wiederholen erzwingen​

Wiederholen erzwingen auf der eBeleg-Karte ist verfügbar, wenn der eBeleg den Status Schritt gestartet hat. Die Aktion wiederholt den gestarteten Schritt direkt:

  • Sie wird abgelehnt, solange der Schritt noch laufen könnte. Warten Sie, bis der Schritt beendet oder fehlgeschlagen ist.
  • Sie fragt nach, wenn der Schritt gestartet wurde, bevor seine Session gespeichert wurde, weil nicht geprüft werden kann, ob er noch läuft.
  • Sie fragt nach bei Versandschritten (SEND, DVELOP-SEND): Wurde der Schritt nach dem Versand unterbrochen, kann der Beleg ein zweites Mal versendet werden. Erweiterungen können eigene Versandschritte über das Ereignis OnAfterIsSendStep kennzeichnen.

Die Wiederholung wird mit dem Benutzer protokolliert, der sie erzwungen hat.

Cegedim-Versandschritt wiederholen​

Für die Versandart Cegedim wird der Auftrag, an den der Beleg übergeben wurde, direkt nach dem Versand im eBeleg-Feld Cegedim Versandauftrags-GUID gespeichert. Wird der SEND-Schritt wiederholt (über Fehler nachholen oder Wiederholen erzwingen), fragt mseDoc365 zuerst den Status dieses Auftrags bei Cegedim ab:

Status des Cegedim-AuftragsErgebnis der Wiederholung
FehlerDer Beleg wird erneut versendet (mit Protokolleintrag).
In BearbeitungDer vorhandene Auftrag wird weiter abgefragt; es wird nicht erneut versendet.
AbgeschlossenDer Schritt ist beendet; es wird nicht erneut versendet.

Kennt Cegedim den gespeicherten Auftrag nicht mehr (gelöscht oder Testkonto), endet die Wiederholung mit dem Fehler der Statusabfrage.