Shopware 6 WorkQueue
Die WorkQueue zeigt alle ausstehenden und verarbeiteten Synchronisationsaufträge für den Shopware 6-Shop. Jeder Eintrag repräsentiert eine einzelne Aktion (z. B. Artikelaktualisierung, Versandmeldung), die an den Shop übertragen werden muss. Preise laufen nicht über die WorkQueue, sondern über die Preissynchronisation von merchantCENTRAL (siehe Preise aus merchantCENTRAL).
Die WorkQueue fungiert als asynchrone Warteschlange: Änderungen an Artikeldaten in BC werden zunächst in die Queue eingereiht und dann gebündelt über die Job Queue oder manuell verarbeitet.
Die Liste ist schreibgeschützt.
Seite öffnen
- Über die Suche: Shopware 6-Arbeitswarteschlange
- Über das Shopware 6-Dashboard → Erweitert → Arbeitswarteschlange
- Über das Dashboard per Klick auf die Zeile Arbeitswarteschlange oder Aufgegebene Einträge der Arbeitswarteschlange in der Karte Wartet auf Sie
Felder
| Feld | Beschreibung |
|---|---|
| ID | Eindeutige, automatisch vergebene ID des Queue-Eintrags. |
| Aktion | Art der durchzuführenden Aktion: Artikelaktualisierung (Artikeldaten) oder eine Aufgabe der Belegverarbeitung – Beleg-Upload (gebuchte Rechnung/Gutschrift), Auftragsrückerstattung (Erstattung), Lieferung versendet (Versandmeldung), Zahlungsmethode, Zahlungseingang, Auftragsbestätigung, Bestellabschluss und Rechnungs-/Gutschriftsmail. |
| Datensatz-PK | Artikelnummer des betroffenen BC-Artikels; beim Hochladen eines Belegs, bei der Auftragsrückerstattung und bei der Versandmeldung die Nummer der gebuchten Rechnung, Gutschrift bzw. Lieferung. |
| Shop-Code | Ab Version 1.81. Shop des gebuchten Belegs, den der Eintrag meldet. Leer bei Artikelaktualisierungen, die alle Shops betreffen, und bei einem Beleg, dessen Shop nicht ermittelt werden konnte. Nach diesem Feld filtert das Dashboard, wenn ein Shop gewählt ist. |
| Arbeitsstatus | Verarbeitungsstatus: Leerlauf (wartet) oder In Bearbeitung. |
| Letzter Versuch | Zeitstempel des letzten Verarbeitungsversuchs. |
| Abgeschlossen am | Zeitstempel der erfolgreichen Verarbeitung. Wenn leer, wurde der Eintrag noch nicht erfolgreich verarbeitet. |
| Fehleranzahl | Anzahl der fehlgeschlagenen Verarbeitungsversuche. Bei wiederholten Fehlern sollte die Ursache in Zusätzliche Informationen geprüft werden. Ab 5 Fehlversuchen ist der Eintrag aufgegeben (siehe unten). |
| Zusätzliche Informationen | Zusätzliche Informationen oder Fehlermeldungen zum Eintrag. Enthält bei Fehlern die Fehlerbeschreibung der Middleware/API. |
Aktionen
| Aktion | Beschreibung |
|---|---|
| Alle Einträge verarbeiten | Verarbeitet die ausstehenden Artikelaktualisierungen sofort und überträgt sie nacheinander an den Shopware-Shop. Die Aufgaben der Belegverarbeitung arbeitet die Job Queue ab (Aufgabe POSTSYNC). Aufgegebene Einträge bleiben liegen. |
| Aufgegebene Einträge abschließen | Ab Version 1.81. Schließt nach einer Rückfrage mit ihrer Anzahl die markierten Einträge ab, die nach 5 Fehlversuchen aufgegeben sind: Abgeschlossen am wird gesetzt, vor die letzte Fehlermeldung kommen Benutzer und Anzahl der Fehlversuche. Einträge, die noch verarbeitet werden, bleiben unverändert. An den Shop wird nichts gesendet. |
| Verarbeitete Einträge löschen | Löscht nach einer Rückfrage mit ihrer Anzahl alle erfolgreich verarbeiteten Einträge (mit gesetztem Abgeschlossen am) aus der Queue; wartende Einträge bleiben. Sofort und unabhängig vom Alter, sonst wie das automatische Aufräumen (siehe unten): Der jüngste erledigte Eintrag einer noch offenen Versandmeldung bleibt, gelöscht wird in Teilschritten. |
Automatisches Aufräumen
Ab Version 1.81 löscht die Job Queue verarbeitete Einträge selbst: Der Lauf der Arbeitswarteschlange (Aufgabe WORKQUEUE) entfernt einmal am Tag alle Einträge, die vor mehr als 7 Tagen abgeschlossen wurden, und protokolliert die Anzahl im Aktivitätsprotokoll. Wartende und aufgegebene Einträge bleiben; ebenso der jüngste erledigte Eintrag einer Versandmeldung, zu der noch ein Eintrag offen ist – an ihm erkennt die Queue, dass eine aufgegebene Versandmeldung später doch beim Shop ankam.
Ohne dieses Aufräumen wuchs die Tabelle um einen Eintrag je Bestandsänderung, bis in die Hunderttausende. Ein solcher Altbestand wird in Schritten von 20.000 Einträgen je Lauf abgebaut; solange davon etwas übrig ist, macht der nächste Lauf weiter. Jede Bereinigung steht mit der Anzahl gelöschter Einträge im Aktivitätsprotokoll (Funktion PurgeWorkQueue).
Aufgegebene Einträge
Nach 5 Fehlversuchen gibt die WorkQueue einen Eintrag auf – Artikelaktualisierungen ebenso wie Einträge der Belegverarbeitung. Kein Lauf nimmt ihn danach wieder auf, auch nicht Alle Einträge verarbeiten. Ab Version 1.81 zeigt das Dashboard solche Einträge in der Karte Wartet auf Sie als eigene Zeile Aufgegebene Einträge der Arbeitswarteschlange, getrennt von den Einträgen, die noch verarbeitet werden.
So gehen Sie vor:
- Zusätzliche Informationen lesen. Bei Mails und Versandmeldungen steht dort, was von Hand zu tun ist.
- Von Hand erledigen, was der Eintrag nicht geschafft hat. Was das ist, hängt vom Fall ab:
- Der Shop konnte eine Mail nicht senden: merchantCENTRAL hat den Beleg bereits als nicht versendet erhalten. Er wird aus Business Central versendet.
- Der Shop hat gesendet, nur merchantCENTRAL weiß es nicht: den Beleg in merchantCENTRAL als gesendet markieren, nicht erneut senden.
- Eine Versandmeldung kam nicht im Shop an: die Lieferung im Shop als versendet melden.
- Die Einträge markieren und Aufgegebene Einträge abschließen wählen.
Versandmeldungen erst nach der Meldung im Shop abschließen
Solange eine aufgegebene Versandmeldung offen ist, schließt der Connector den Shop-Auftrag nicht ab. Nach dem Abschließen gibt sie ihn frei. Eine danach gebuchte Rechnung schließt den Auftrag im Shop ab – der Käufer bekommt die Abschlussmail auch dann, wenn die Lieferung nie gemeldet wurde.
Kein erneuter Versuch
Aufgegebene Einträge lassen sich bewusst nur abschließen, nicht erneut versuchen: Ein zweiter Versand einer Mail aus dem Shop, die inzwischen aus Business Central verschickt wurde, erreichte den Käufer doppelt. Bei Artikeln kümmert sich der Connector selbst darum: Ändern sich Bestand oder Gewicht des Artikels, reiht er einen neuen Eintrag ein und schließt den aufgegebenen dabei ab (Zusätzliche Informationen nennt den neuen Eintrag). Mit unveränderten Werten versucht er es frühestens einen Tag nach dem letzten Versuch erneut – so bleibt je Artikel höchstens ein aufgegebener Eintrag offen.
Shop nicht erreichbar
Ab Version 1.81. Scheitert eine Aufgabe, weil der Shop nicht erreichbar ist – er gibt kein Token, etwa weil er nicht antwortet oder die Zugangsdaten abgelehnt werden –, zählt der Versuch nicht. Der Eintrag wartet, Zusätzliche Informationen nennt den Grund, und ein späterer Lauf erledigt ihn, sobald der Shop wieder antwortet. Weitere Einträge desselben Shops versucht derselbe Lauf gar nicht erst. So wartet ein Eintrag höchstens einen Tag ab dem ersten Versuch, der den Shop nicht erreicht hat; danach zählen die Fehlversuche wieder, und nach fünf ist er aufgegeben – bei Mails erfährt merchantCENTRAL dann, dass der Beleg nicht versendet wurde.