Druckwarteschlange

Die Seite Druckaufträge zeigt alle Druckaufträge des Print Service mit ihrem aktuellen Status, neueste zuerst. Von hier aus lassen sich fehlgeschlagene Aufträge erneut versuchen, Aufträge abbrechen und die Warteschlange sofort verarbeiten.

Seite öffnen

Über die Suche: Druckaufträge
Über das Dashboard → Druckaufträge oder durch Klick auf eine Kachel (z. B. Offene Druckaufträge, Fehlgeschlagen – mit passendem Filter)
Über die Druckerkarte → Druckaufträge (gefiltert auf den Drucker)

Felder

Feld	Beschreibung
Lfd. Nr.	Fortlaufende Nummer des Druckauftrags
Status	Aktueller Status (siehe Status-Übersicht)
Belegart	Art des Dokuments: Versandetikett, Bericht oder Rohdokument
Dokumentname	Name des gedruckten Dokuments, bei Berichten der Berichtsname
Belegnr.	Zugehörige Belegnummer (z. B. gebuchte Lieferung)
Druckercode	Drucker, an den der Auftrag geht bzw. ging
Lagerortcode	Lagerort des Belegs; bei Versandetiketten der Lagerort des Verkaufsauftrags. Die Routingregeln gleichen ihn ab
Druckmethode	PDF oder ZPL
Anbietercode	Versanddienstleister (nur bei Versandetiketten)
Sendungsnr.	Sendungsnummer des Versandetiketts (nur bei Versandetiketten)
Kopien	Anzahl der Kopien
Erstellt am	Zeitpunkt der Erstellung
Abgeschlossen am	Zeitpunkt, zu dem der Auftrag gedruckt, fehlgeschlagen oder abgebrochen wurde
Anzahl Wiederholungen	Bisherige Wiederholungsversuche
Fehlermeldung	Letzte Fehlermeldung
Erstellt von	Benutzer, der den Auftrag ausgelöst hat

Status-Übersicht

Status	Beschreibung
Wartet auf Erzeugung	Ein Bericht aus einer Buchung wurde eingereiht. Ein Sofortdruck-Task erzeugt ihn Sekunden nach der Buchung – nie während der Buchung selbst – und setzt den Auftrag dann auf In Warteschlange. Was kein Task erreicht, erzeugt der nächste Lauf der Druckwarteschlange
In Warteschlange	Wartet auf das Senden (neue Aufträge oder Aufträge, die auf den nächsten Wiederholungsversuch warten)
Wird gesendet	Wird gerade übermittelt bzw. bei Relay/Poll von der Function oder dem Agent bearbeitet
Gedruckt	Erfolgreich gedruckt
Fehlgeschlagen	Fehler, der sich durch Wiederholen nicht beheben lässt, oder alle Wiederholungen aufgebraucht
Abgebrochen	Manuell abgebrochen

Aktionen

Aktion	Beschreibung
Wiederholung	Stellt den ausgewählten fehlgeschlagenen Auftrag zurück auf In Warteschlange; Wiederholungszähler, Fehlermeldung und Abgeschlossen am werden zurückgesetzt. Der Sofortdruck sendet ihn Sekunden später
Alle Fehlgeschlagenen erneut versuchen	Stellt alle fehlgeschlagenen Aufträge zurück auf In Warteschlange; der Sofortdruck sendet sie Sekunden später
Abbrechen	Bricht die markierten Aufträge ab (Status → Abgebrochen). Möglich bei Wartet auf Erzeugung, In Warteschlange, Wird gesendet und Fehlgeschlagen. Mehrere Zeilen markieren, um sie in einem Schritt abzubrechen: Eine Rückfrage nennt die Anzahl und wie viele davon schon gesendet sind, gedruckte und abgebrochene Aufträge werden übersprungen, eine Zusammenfassung zeigt das Ergebnis. Bei einer einzelnen Zeile fragt BC nur bei Wird gesendet nach, weil der Druckdienst den Auftrag noch drucken kann
Warteschlange verarbeiten	Führt die Druckwarteschlange sofort aus: erzeugt die Berichte aus Buchungen, stellt hängende Direkt-Push-Aufträge zurück und sendet alle fälligen Aufträge. Derselbe Lauf wie auf dem Dashboard und in den Druckservice-Einstellungen

Sofortdruck

Jeder neue Druckauftrag – aus einer Buchung, einem Versandetikett, einem Druck von Hand oder einer Wiederholung – startet einen Hintergrund-Task, der ihn Sekunden nach dem Commit erzeugt und sendet. Warteschlange verarbeiten brauchen Sie daher nur bei Bedarf – etwa wenn der Aufgabenwarteschlangenposten der Druckwarteschlange nicht eingeplant ist und Wiederholungen liegen bleiben.

Wiederholungslogik

Schlägt das Senden fehl (keine Verbindung, Zeitüberschreitung, Serverfehler), wird die Anzahl Wiederholungen erhöht und der Auftrag nach der Wiederholungsverzögerung (Sek.) erneut gesendet. Sind die Max. Wiederholungsversuche aus den Druckservice-Einstellungen überschritten, wird er Fehlgeschlagen.
Antwortet der Druckdienst oder die Function mit einem Fehler, den eine Wiederholung nicht behebt (HTTP 4xx außer 408 und 429, z. B. falscher API-Schlüssel oder unbekannter Drucker), wird der Auftrag sofort Fehlgeschlagen; bei HTTP 401 geht der Drucker zusätzlich auf Fehler.
Kann ein Bericht nicht erzeugt werden, versucht es die Druckwarteschlange bis zu fünfmal, danach wird der Auftrag Fehlgeschlagen.
Ein Direkt-Push-Auftrag, der länger als 10 Minuten ohne Antwort in Wird gesendet steht, wird nach den normalen Wiederholungsregeln zurück in die Warteschlange gestellt.
Eine manuelle Wiederholung ist jederzeit möglich.

Relay und Poll

Bei Relay und Poll bleibt ein Auftrag nach der Übergabe an die Queue auf Wird gesendet, bis der Agent das Ergebnis meldet – auch über Nacht, wenn der Rechner ausgeschaltet ist. Ohne jede Rückmeldung wird er nach 25 Stunden auf Fehlgeschlagen gesetzt.

Etiketten manuell drucken

Ist der automatische Druck ausgeschaltet oder soll ein Etikett erneut gedruckt werden:

Die Liste Versandetiketten öffnen und die Etiketten markieren.
Etikett drucken (mehrere Etiketten) bzw. Etikett erneut drucken (erneuter Druck des ausgewählten Etiketts) wählen.
Im Dialog Drucker auswählen den Drucker und die Anzahl Kopien wählen.

Die Aufträge erscheinen anschließend in der Druckwarteschlange.

Typische Fehler und Lösungen

Keine Verbindung zum Druckdienst

Ursache: MC.PrintService nicht erreichbar. Lösung: Prüfen Sie, ob der Dienst läuft und die Service-URL auf der Druckerkarte stimmt. Danach Verbindung testen.

HTTP 401

Ursache: API-Schlüssel fehlt oder stimmt nicht mit dem Druckdienst überein (bei Relay: falscher Relay-Function-Key). Lösung: Auf dem Rechner des Dienstes in der Konfigurationsoberfläche http://localhost:5049/config (in BC: Lokale Konfiguration öffnen) den API-Schlüssel mit Kopieren in die Zwischenablage legen – angezeigt wird er nie – und auf der Druckerkarte im Feld API-Schlüssel neu einfügen.

Drucker nicht gefunden

Ursache: Der Druckername existiert nicht auf dem Rechner, der den Auftrag bekam. Die Meldung „Printer … is not installed on the print service machine " nennt diesen Rechner. Lösung: Die Konfigurationsoberfläche http://localhost:5049/config listet alle installierten Windows-Drucker. Tragen Sie den Namen exakt so ein. Drucken mehrere Rechner über Relay/Poll, prüfen Sie das Feld Agent auf der Druckerkarte: Es muss den Rechner nennen, an dem der Drucker installiert ist.

No queue for print agent …

Ursache: Der Drucker nennt im Feld Agent einen Rechner, für den das Azure-Deployment keine Queue hat. Der Auftrag schlägt sofort fehl. Lösung: Den Namen im Parameter agentNames ergänzen und die Vorlage erneut deployen (siehe Einrichtung – Mehrere Rechner), dann Wiederholung. Druckt ein einziger Rechner alles, das Feld Agent leeren.

ZPL-Drucker nicht erreichbar oder nicht erlaubt

Ursache: Der Zebra-Drucker antwortet nicht per TCP/IP, oder seine Adresse bzw. sein Port liegt außerhalb der erlaubten Druckziele (private Netze, Ports 9100–9103 und 6101). Lösung: Netzwerkverbindung, IP-Adresse und Port prüfen und den ZPL-Test der Konfigurationsoberfläche nutzen. Abweichende Netze oder Ports: MC.PrintService – Referenz.

Auftrag hängt in „Wird gesendet" (Relay/Poll)

Ursache: Agent offline, falsche Listen-Verbindungszeichenfolge oder ausgehende Verbindung gesperrt. Bei mehreren Rechnern: Kein Dienst liest die Queue des Agents, weil Relay:QueueName des Rechners nicht zum Feld Agent des Druckers passt. Lösung: Dienst auf dem Rechner prüfen, Relay:Enabled und die Verbindungszeichenfolge kontrollieren, ausgehend Port 443 zu *.servicebus.windows.net freigeben. Bei mehreren Rechnern Relay:QueueName = print-jobs-<agent> mit der Listen-Verbindungszeichenfolge dieser Queue einrichten.

Hinweise

Bereinigung

Gedruckte und abgebrochene Aufträge, die älter als die Log-Aufbewahrung (Tage) sind, entfernt die Aktion Alte Aufträge bereinigen in den Druckservice-Einstellungen. Fehlgeschlagene Aufträge bleiben stehen, bis sie wiederholt oder abgebrochen werden.