Druckservice-Einstellungen
Die zentrale Konfiguration des merchantCENTRAL Print Service: automatischer Druck, Standard- und Ersatzdrucker, Wiederholungen, Druckwarteschlange, Druckabonnements und die Poll-Anbindung. Wie bei den anderen merchantCENTRAL-Modulen ist sie als Teil Druckservice-Einstellungen in die Hub-Karte Erweiterung eingebettet. Eine eigene, über die Suche auffindbare Einrichtungsseite gibt es nicht.
Seite öffnen
- In BC nach merchantCENTRAL-Einrichtung suchen.
- Im Bereich Erweiterungen die Zeile Print Service wählen → Aktion Einrichten.
Es öffnet sich die Hub-Karte Erweiterung des Print Service:
| Bereich | Inhalt |
|---|---|
| Allgemein | U. a. der Schalter Aktiviert, der das Modul einschaltet (siehe Modul und Lizenz) |
| Erweiterungseinstellungen | Der Teil Druckservice-Einstellungen mit allen Feldern und Aktionen, die diese Seite beschreibt |
| Lizenz | Lizenzstatus des Moduls PRINTSERVICE |
Name oder Einrichten?
Ein Klick auf den Namen Print Service in der Liste öffnet das Dashboard, nicht die Einstellungen. Zu den Einstellungen führt die Aktion Einrichten.
Beim ersten Öffnen wird der Einrichtungsdatensatz mit Standardwerten angelegt.
Hülle „Druckservice Einrichtung“
Öffnet der Hub die Einrichtung des Moduls direkt (z. B. aus einer FactBox), erscheint die Seite Druckservice Einrichtung. Sie enthält denselben Teil Druckservice-Einstellungen, dazu den Teil Lizenz und die Aktion Im Hub aktivieren, die die Hub-Karte Erweiterung öffnet. Ist der Hub noch nicht eingerichtet, leitet sie zuerst zur Hub-Einrichtung.
Felder
Lokale Druckdienst-App
Hinweistext: Für den Druck ist der lokale MC.PrintService auf einem Windows-Rechner nötig, der die Drucker erreicht. Die Aktion Druckdienst herunterladen öffnet den signierten Installer (siehe Einrichtung).
Druck
| Feld | Standard | Beschreibung |
|---|---|---|
| Automatischer Druck aktiviert | aus | Versandetiketten werden nach der Erstellung automatisch gedruckt – auf den Drucker aus den Routingregeln bzw. den Standarddrucker. Aus: Etiketten werden manuell über die Liste Versandetiketten gedruckt |
| Standard-Druckercode | – | Drucker, der verwendet wird, wenn keine Routingregel greift, und für Berichte ohne eigenen Drucker |
| Routingregeln aktiviert | aus | Aktiviert die Routingregeln für Versandetiketten |
| Ersatz aktiviert | ein | Ist der ermittelte Drucker nicht verbunden oder fehlerhaft, wird ein Ersatzdrucker verwendet (siehe Drucker) |
Automatischer Druck
Bei aktiviertem automatischen Druck wird jedes neu erstellte Versandetikett sofort in die Druckwarteschlange eingereiht. Findet sich kein passender Drucker, entsteht ein fehlgeschlagener Druckauftrag mit Begründung – das Etikett geht nicht stillschweigend verloren.
Wiederholungseinstellungen
| Feld | Standard | Bereich | Beschreibung |
|---|---|---|---|
| Max. Wiederholungsversuche | 3 | 0–10 | Anzahl der Wiederholungen, bevor ein Druckauftrag als fehlgeschlagen gilt |
| Wiederholungsverzögerung (Sek.) | 5 | 1–300 | Wartezeit zwischen zwei Versuchen |
Wartung
| Feld | Standard | Bereich | Beschreibung |
|---|---|---|---|
| Log-Aufbewahrung (Tage) | 30 | 1–365 | Gedruckte und abgebrochene Druckaufträge, die älter sind, entfernt die Aktion Alte Aufträge bereinigen |
| Druckwarteschlange | – | – | Zeigt, ob der Aufgabenwarteschlangenposten eingeplant ist, der die Druckwarteschlange alle fünf Minuten ausführt: Geplant oder Nicht geplant - keine Wiederholungen. Neue Druckaufträge gehen auch ohne ihn sofort hinaus, aber er ist das Sicherheitsnetz: Er wiederholt fehlgeschlagene Sendungen und nimmt die Aufträge, die ein Sofortdruck-Task nicht erreicht hat |
Druckwarteschlange und Sofortdruck
Jeder neue Druckauftrag – aus einer Buchung, einem neuen Versandetikett, einem Druck von Hand oder einer Wiederholung – startet einen Hintergrund-Task, der ihn Sekunden nach dem Commit erzeugt und sendet (bei Poll: den Wake-Ping schickt). Das geschieht nie in der Buchung selbst; scheitert die Buchung, entfällt auch der Task.
Zusätzlich legt die App bei der Installation einen Aufgabenwarteschlangenposten (Parameter
PRINTQUEUE) an, der alle 5 Minuten läuft. Er ist das Sicherheitsnetz: Er erzeugt Berichte aus Buchungen, die
kein Task erreicht hat, stellt hängende Aufträge zurück, sendet Wiederholungen nach Ablauf der
Wartezeit und im Poll-Modus den Wake-Ping. Für eine später angelegte Company entsteht der
Posten beim ersten Öffnen der Druckservice-Einstellungen (Hub-Karte Erweiterung, Zeile
Print Service).
Berichtsdruck
| Feld | Standard | Beschreibung |
|---|---|---|
| Druckabonnements aktiviert | aus | Aktiviert die Druckabonnements (automatischer Berichtsdruck nach Buchungen) |
Poll-Anbindung (Azure)
Nur für Drucker mit Transportmodus Poll (Azure-Queue) (siehe Einrichtung, Teil B).
| Feld | Beschreibung |
|---|---|
| Poll-Function-URL | Basis-URL der Azure Function App. BC sendet dorthin nur einen kurzen Wake-Ping, die Function holt die Aufträge selbst ab. Leer: BC bleibt vollständig passiv, die Function arbeitet nur über ihren Timer |
| Poll-Function-Key | Zeigt Konfiguriert bzw. Nicht konfiguriert. Anklicken, um den Function-Key einzugeben oder zu ändern; er wird verschlüsselt gespeichert |
Wake-Ping im Echtbetrieb Pflicht
Mit hinterlegter Poll-Function-URL und Poll-Function-Key meldet BC der Function, sobald ein Auftrag bereit ist – gedruckt wird nach wenigen Sekunden. Ohne Wake-Ping holt die Function die Aufträge nur über ihren Timer, standardmäßig alle 5 Minuten. Prüfen Sie URL und Key mit der Aktion Poll-Anbindung testen.
Modul und Lizenz
Diese beiden Bereiche gehören zur Hub-Karte Erweiterung, nicht zum Teil Druckservice-Einstellungen:
| Bereich | Feld / Aktion | Beschreibung |
|---|---|---|
| Allgemein | Aktiviert | Schaltet den Print Service in merchantCENTRAL ein. Beim Einschalten prüft der Hub die Lizenz und bietet die Demo-Registrierung an. Solange das Modul aus ist, bleiben automatischer Druck und Druckabonnements still |
| Lizenz | Lizenzstatus | Lizenzstatus des Moduls PRINTSERVICE |
| Demo-Status, Demo-Ablauf | Nur bei einer Demo: wie lange sie noch läuft (bzw. dass sie abgelaufen ist) und ihr Ablaufdatum | |
| Demo registrieren, Lizenz aktualisieren | Demo-Lizenz freischalten bzw. den Lizenzserver erneut abfragen |
Aktionen
Die Aktionen liegen im Aktionsmenü des Teils Druckservice-Einstellungen (nicht in der Aktionsleiste der Hub-Karte) und sind in drei Gruppen geordnet.
Installation
| Aktion | Beschreibung |
|---|---|
| Einrichtungsassistent | Unterstützte Einrichtung: lokaler Druckdienst, erster Drucker und automatischer Druck (siehe unten) |
| Druckdienst herunterladen | Öffnet die Downloadseite des MC.PrintService, vorgefiltert auf die zu Ihrer Installation passenden Versionen |
| Lokale Konfiguration öffnen | Öffnet die Konfigurationsseite des lokalen Druckdienstes (http://localhost:5049/config): API-Schlüssel, Drucker, Agent-Modus. Funktioniert nur auf dem Rechner, auf dem der Dienst installiert ist |
| Lokalen Druckdienst prüfen | Öffnet die Statusseite des lokalen Druckdienstes (http://localhost:5050/health). Sie zeigt, dass der Dienst auf diesem Rechner installiert ist und läuft. Funktioniert nur auf dem Rechner, auf dem der Dienst installiert ist |
| Relay/Poll in Azure einrichten | Öffnet das Azure-Portal mit der Vorlage für die Relay-/Poll-Infrastruktur im eigenen Azure-Abonnement und zeigt die dort einzutragenden Parameter bcCompanyId und bcEnvironmentUrl fertig ausgefüllt an. Der Function-Code kommt mit der Vorlage |
| Poll-Anbindung testen | Sendet einen Wake-Ping mit der hinterlegten Poll-Function-URL und dem Key und zeigt die Antwort der Function. Ohne funktionierenden Wake-Ping drucken Poll-Drucker erst, wenn der Timer der Function läuft |
| Poll-Function-Key löschen | Entfernt den gespeicherten Poll-Function-Key |
Verarbeiten
| Aktion | Beschreibung |
|---|---|
| Alle Drucker testen | Testet die Verbindung zu allen aktivierten Direkt-Push-Druckern und aktualisiert deren Status |
| Warteschlange verarbeiten | Führt die Druckwarteschlange sofort aus: erzeugt die Berichte aus Buchungen, stellt hängende Direkt-Push-Aufträge zurück in die Warteschlange und sendet alle fälligen Aufträge. Derselbe Lauf wie auf dem Dashboard und in der Druckwarteschlange |
| Druckwarteschlange neu starten | Plant den Aufgabenwarteschlangenposten der Druckwarteschlange ein, auch wenn er angehalten oder fehlerhaft ist, und legt ihn an, falls er fehlt |
| Alte Aufträge bereinigen | Löscht gedruckte und abgebrochene Druckaufträge, die älter als die Log-Aufbewahrung (Tage) sind. Fehlgeschlagene Aufträge bleiben erhalten |
Navigieren
| Aktion | Beschreibung |
|---|---|
| Drucker | Öffnet die Druckerliste |
| Druckaufträge | Öffnet die Druckwarteschlange |
| Routingregeln | Öffnet die Druck-Routingregeln |
| Druckabonnements | Öffnet die Druckabonnements |
Einrichtungsassistent
Der Druckservice-Einrichtungsassistent ist auf zwei Wegen erreichbar:
- Unterstützte Einrichtung → Gruppe AD merchantCENTRAL - Einrichtung → merchantCENTRAL Druckservice einrichten
- Aktion Einrichtungsassistent im Aktionsmenü der Druckservice-Einstellungen (Gruppe Installation)
Er führt durch fünf Schritte:
- Willkommen – Überblick über die Transportmodi und Voraussetzungen.
- Druckdienst installieren – Aktionen Druckdienst herunterladen und Relay/Poll in
Azure einrichten; Hinweis, den API-Schlüssel unter
http://localhost:5049/configmit Kopieren in die Zwischenablage zu legen (angezeigt wird er nie). - Erster Drucker – Code, Beschreibung, Transportmodus, Druckmethode, Druckername oder Adresse, ggf. ZPL-Port sowie je nach Modus Service-URL und API-Schlüssel, Relay-Function-URL und -Key oder Poll-Function-URL.
- Automatischer Druck – Als Standarddrucker verwenden, Automatischer Druck aktiviert, Druckabonnements aktiviert, Routingregeln aktiviert.
- Bereit – bei Direkt-Push Verbindung testen, dann Fertigstellen.
Assistent erneut ausführen
Beim erneuten Aufruf zeigt der Schritt Erster Drucker den Standarddrucker mit seinen gespeicherten Werten; der Code eines anderen vorhandenen Druckers zeigt diesen Drucker. Fertigstellen ändert nur die Felder, die der Assistent anzeigt – alle übrigen Einstellungen des Druckers bleiben erhalten.
Hinweise
MC.PrintService erforderlich
Der Print Service benötigt eine laufende MC.PrintService-Instanz im Kundennetz. Ohne erreichbaren Dienst werden keine Aufträge gedruckt. Siehe Einrichtung.
Was gedruckt wird
Der Print Service druckt Versandetiketten, BC-Berichte und Rohdokumente (PDF/ZPL). Die Belegart jedes Druckauftrags zeigt, worum es sich handelt (Versandetikett, Bericht, Rohdokument).