Drucker
Verwaltung aller Drucker, die über den merchantCENTRAL Print Service angesteuert werden. Jeder Drucker hat einen eigenen Transportmodus und eine eigene Anbindung an einen MC.PrintService.
Seite öffnen
- Über die Suche: Drucker (Liste des Druckservice)
- Über das Dashboard → Drucker
- Über die Druckservice-Einstellungen (Aktionsmenü des Teils → Navigieren) → Drucker
Druckerliste
Felder (Listenansicht)
| Feld | Beschreibung |
|---|---|
| Code | Eindeutiger Kurzcode des Druckers (z. B. LABEL-01, ZPL-LAGER). Referenz in Routingregeln, Druckabonnements und Druckaufträgen |
| Beschreibung | Beschreibender Name (z. B. „Zebra ZD421 Lager 1") |
| Druckmethode | PDF (Windows-Druckertreiber) oder ZPL (Direktdruck auf Zebra-Thermodrucker) |
| Status | Letzter bekannter Status: Noch nicht geprüft, Online, Nicht verbunden oder Fehler |
| Aktiviert | Ob der Drucker für Druckaufträge verwendet werden darf |
| Service-URL | Adresse des MC.PrintService (nur bei Direkt-Push) |
| Ausstehende Aufträge | Anzahl der Aufträge In Warteschlange oder Wird gesendet für diesen Drucker |
Aktionen (Liste)
| Aktion | Beschreibung |
|---|---|
| Verbindung testen | Testet die Verbindung zum ausgewählten Drucker (siehe unten) |
| Alle testen | Testet alle aktivierten Direkt-Push-Drucker und aktualisiert deren Status |
Neue Drucker legen Sie mit Neu an; die Druckerkarte öffnet sich.
Druckerkarte
Allgemein
| Feld | Beschreibung |
|---|---|
| Code | Eindeutiger Kurzcode (Pflichtfeld) |
| Beschreibung | Beschreibung des Druckers |
| Aktiviert | Aktiviert oder deaktiviert den Drucker. Neue Drucker sind aktiviert |
| Ist Standard | Zeigt, ob dieser Drucker der Standarddrucker in den Druckservice-Einstellungen ist (nur lesbar; ändern mit Als Standarddrucker festlegen) |
Verbindung
| Feld | Beschreibung |
|---|---|
| Transportmodus | Wie Druckaufträge diesen Drucker erreichen: Direkt-Push (direkt an die Service-URL, feste öffentliche IP nötig), Relay (Azure-Queue) (BC stellt den Auftrag in eine Queue im Azure des Kunden) oder Poll (Azure-Queue) (die Function holt die Aufträge bei BC ab). Steuert, welche Felder sichtbar sind. Ein Wechsel setzt Status, Letzte Statusprüfung und Letzte Fehlermeldung zurück (Noch nicht geprüft) |
| Service-URL | (nur Direkt-Push) Adresse der MC.PrintService-Instanz, z. B. https://print.kunde.de. http:// nur für localhost/127.0.0.1 |
| API-Schlüssel | (nur Direkt-Push) Zeigt Konfiguriert bzw. Nicht konfiguriert. Anklicken, um den API-Schlüssel einzufügen, den Sie in der Konfigurationsoberfläche des Dienstes mit Kopieren in die Zwischenablage gelegt haben – angezeigt wird er dort nie. BC sendet ihn als Header X-Api-Key |
| Druckername | Bei PDF der exakte Windows-Druckername auf dem Rechner des Dienstes, bei ZPL die IP-Adresse des Zebra-Druckers |
| Druckmethode | PDF: Das Dokument wird über den Windows-Druckertreiber gedruckt. ZPL: Das Etikett geht als ZPL-Code per TCP/IP direkt an den Zebra-Drucker |
| ZPL-Port | (nur bei ZPL) TCP-Port des Zebra-Druckers (Standard 9100) |
Relay (Azure-Queue)
Nur bei Transportmodus Relay (Azure-Queue) sichtbar.
| Feld | Beschreibung |
|---|---|
| Relay-Function-URL | Basis-URL der Azure Function App im Azure des Kunden (z. B. https://mcpsrelay-func-….azurewebsites.net). Muss https:// verwenden |
| Agent | Nur wenn mehrere Rechner über Relay/Poll drucken: Name des Rechners, der für diesen Drucker druckt, z. B. LAGER. Sein Dienst liest die Queue print-jobs-<agent> (in Kleinbuchstaben), die das Azure-Deployment für jeden Namen im Parameter agentNames anlegt. Erlaubt sind Buchstaben, Ziffern und - _ .. Leer = ein Rechner druckt alles |
| Relay-Function-Key | Zeigt Konfiguriert bzw. Nicht konfiguriert. Anklicken, um den Function-Key einzugeben; BC sendet ihn als X-Functions-Key beim Einstellen eines Auftrags |
Poll (Azure-Queue)
Nur bei Transportmodus Poll (Azure-Queue) sichtbar. Hinweis: Die Azure-Anbindung für Poll-Drucker wird zentral in den Druckservice-Einstellungen hinterlegt. Der Drucker braucht nur Druckername und Druckmethode – und bei mehreren druckenden Rechnern das Feld Agent:
| Feld | Beschreibung |
|---|---|
| Agent | Wie bei Relay: Name des Rechners, der für diesen Drucker druckt (Queue print-jobs-<agent>). Leer = ein Rechner druckt alles |
PDF oder ZPL?
PDF: für alle Drucker mit Windows-Treiber (Laser, Tintenstrahl, Thermodrucker). Der Dienst rendert jede Seite mit 300 DPI, behält das Seitenverhältnis bei und wählt passendes Papierformat und Ausrichtung, sofern der Drucker sie anbietet. ZPL: für Zebra-Thermodrucker im lokalen Netz. Kein Treiber nötig, höchste Geschwindigkeit. Der Dienst verbindet sich nur mit Druckern in privaten Netzen auf den Druckerports 9100–9103 und 6101 (anpassbar, siehe MC.PrintService – Referenz).
Mehrere Standorte
Jeder Drucker kann eine eigene Anbindung haben. Bei Direkt-Push lassen sich Drucker an
verschiedenen Standorten (z. B. Lager 1 und Lager 2) so über je eine eigene
MC.PrintService-Installation ansteuern. Bei Relay/Poll genügt oft ein Rechner: ZPL-Drucker
spricht der Dienst über ihre IP-Adresse im Netz an, nur PDF-Drucker müssen auf dem Rechner
installiert sein. Drucken trotzdem mehrere Rechner mit verschiedenen Druckern, nennt das Feld
Agent den Rechner, und das Azure-Deployment bekommt dessen Namen im Parameter
agentNames (siehe Einrichtung – Mehrere Rechner).
Ersatz
| Feld | Beschreibung |
|---|---|
| Ersatzdrucker-Code | Drucker, der verwendet wird, wenn dieser Drucker Nicht verbunden oder Fehler meldet. Angeboten werden nur Drucker mit derselben Druckmethode; ein Drucker kann nicht sein eigener Ersatz sein. Leer = kein fester Ersatzdrucker |
Ist in den Druckservice-Einstellungen Ersatz aktiviert gesetzt und der ermittelte Drucker nicht erreichbar, wird zuerst der hier eingetragene Ersatzdrucker verwendet – sofern er aktiviert und Online ist. Andernfalls nimmt der Print Service einen anderen aktivierten Drucker mit Status Online und derselben Druckmethode. Ein Ersatzdrucker wird nicht weiter verkettet.
Status
| Feld | Beschreibung |
|---|---|
| Status | Verbindungsstatus (nur lesbar). Wird durch Verbindung testen und durch die Ergebnisse der Druckaufträge aktualisiert. Ein neuer oder im Transportmodus geänderter Drucker steht auf Noch nicht geprüft |
| Letzte Statusprüfung | Zeitpunkt der letzten Statusprüfung |
| Letzte Fehlermeldung | Letzte Fehlermeldung dieses Druckers |
Statistik
| Feld | Beschreibung |
|---|---|
| Gesamt gedruckte Aufträge | Anzahl der erfolgreich gedruckten Aufträge |
| Ausstehende Aufträge | Aufträge In Warteschlange oder Wird gesendet |
| Fehlgeschlagene Aufträge | Fehlgeschlagene Aufträge dieses Druckers |
Aktionen (Karte)
| Aktion | Beschreibung |
|---|---|
| Druckdienst herunterladen | Öffnet die Downloadseite des MC.PrintService |
| Lokale Konfiguration öffnen | Öffnet die Konfigurationsseite des lokalen Druckdienstes (http://localhost:5049/config): API-Schlüssel, Drucker, Agent-Modus |
| 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 |
| Verbindung testen | Bei Direkt-Push: ruft den Dienst unter der Service-URL mit dem API-Schlüssel auf und setzt den Status auf Online, Nicht verbunden oder Fehler. Relay- und Poll-Drucker sind aus BC nicht direkt erreichbar; ihr Status folgt den Ergebnissen, die der Agent meldet |
| Als Standarddrucker festlegen | Macht diesen Drucker zum Standarddrucker in den Druckservice-Einstellungen. Er erhält Etiketten, auf die keine Routingregel passt, und Berichte ohne eigenen Drucker |
| API-Schlüssel entfernen | Entfernt den gespeicherten API-Schlüssel |
| Relay-Function-Key löschen | Entfernt den gespeicherten Relay-Function-Key |
| Druckaufträge | Zeigt die Druckaufträge dieses Druckers |
Druckdienst herunterladen, Lokale Konfiguration öffnen und Lokalen Druckdienst prüfen
stehen in der Gruppe Installation. Die beiden lokalen Aktionen öffnen localhost und
funktionieren deshalb nur auf dem Rechner, auf dem der Druckdienst installiert ist.
Einrichtung eines neuen Druckers
- MC.PrintService installieren: Auf einem Rechner, der den Drucker erreicht (siehe Einrichtung).
- Drucker anlegen: In der Druckerliste → Neu → Code und Beschreibung eingeben.
- Verbindung konfigurieren: Transportmodus wählen und je nach Modus eintragen: Service-URL und API-Schlüssel (Direkt-Push) bzw. Relay-Function-URL und -Key (Relay). Bei Poll entfällt das – die Anbindung liegt zentral in den Druckservice-Einstellungen. Dann Druckername und Druckmethode. Drucken mehrere Rechner über Relay/Poll, zusätzlich das Feld Agent.
- Verbindung testen (Direkt-Push): Status muss Online anzeigen.
- Optional: Als Standarddrucker festlegen.
Einrichtungsassistent
Den ersten Drucker legt auch der Einrichtungsassistent an (siehe Druckservice-Einstellungen).