Hintergrund Druckdienst
Allgemeines
Beim Druck eines Formulars werden die dazugehörigen Daten in Drucktabellen mit den Rahmenbedingungen (Anzahl Kopien, Archivkopien, Druckerwarteschlange, Priorität ...) abgelegt. Um den syslog.ERP Client beim Drucken zu entlasten, gibt es die Möglichkeit, diese Drucke von einem Druckdienst ausführen zu lassen. Dadurch wird am Client nur der Druckauftrag generiert, die zeitaufwendigere Druckaufbereitung erfolgt dann über den Dienst.
Der Hintergrunddruckdienst kann sowohl lokal - nur für den auf diesem Rechner generierten Druckaufträge, als auch global -als Serverdienst, agieren. Bei globalen Diensten ist darauf zu achten, dass die angesprochenen Drucker dem Dienst bekannt sind.
Die Druckdienste können als echte Win32-Dienste installiert oder in der CMD-Box gestartet werden.
Für die einzelnen Module gibt es dediziert Druckdienste und Dialoge in denen die Druckafträge beauskunftet werden können.
| Modul | Dienstname | Ort | Dialog | Bemerkung |
|---|---|---|---|---|
| Vertrieb | DruckVKForm.exe | %PRIMUSDIR%\auft1.0\bin | AB10 | es können mehrere Dienste mit gleichen oder unterschiedlichen Aufgaben installiert werden |
| Einkauf | DruckEKForm.exe | %PRIMUSDIR%\eink1.0\bin | ABEK10 | es können mehrere Dienste mit gleichen oder unterschiedlichen Aufgaben installiert werden |
| Listen, Statistik, Labels | DruckSLTRpt.exe | %PRIMUSDIR%\stam1.0\bin | DD10 | es können mehrere Dienste mit gleichen oder unterschiedlichen Aufgaben installiert werden |
| Fertigung Papiere | DruckSltFeRpt.exe | %PRIMUSDIR%\fert1.0\bin | DDFE10 | es können mehrere Dienste mit gleichen oder unterschiedlichen Aufgaben installiert werden |
| Fertigung Etiketten | druckartetk.exe | %PRIMUSDIR%\fert1.0\bin | FE50 | CMD Dienst |
Druckverteilung
Bei hohem Druckaufkommen kann es notwendig sein, dass zur Lastverteilung weitere Druckdienste eines Typs installiert werden. Die Aufteilung des Druckaufkommens kann dabei vorgangsbezogen und / oder gerätebezogen sein.
Paralleler Druckdienst
Es werden weitere Druckdienste mit gleicher Aufgabe aber unterschiedlichen Namen installiert. Hierzu bekommt jeder Druckdienst über den Aufrufparameter [SyslogIni] eine eigene syslog.ini in der der Dienstname und Anzeigename hinerlegt wird.
syslog.ini Parameter
| Parameter | Druckdienst | Beschreibung |
|---|---|---|
VKD_DNAME | DruckVKForm | Anzeige-Namen für den Hintergrund-Druckdienst VK, z.B. "Syslog-PPS Hintergrund-Druck VK" |
| VKD_SNAME | DruckVKForm | Dienst-Namen für den Hintergrund-Druckdienst VK, z.B. "Syslog-PPS-DruckVKForm" |
| EKD_DNAME | DruckEKForm | Anzeige-Namen für den Hintergrund-Druckdienst EK, z.B. "Syslog-PPS Hintergrund-Druck EK" |
| EKD_SNAME | DruckEKForm | Dienst-Namen für den Hintergrund-Druckdienst EK, z.B. "Syslog-PPS-DruckEKForm" |
| SOD_DNAME | DruckSLTRpt | Anzeige-Namen für den Hintergrund-Druckdienst Sonstige, z.B. Syslog-PPS-DruckSLTRpt" |
| SOD_SNAME | DruckSLTRpt | Dienst-Namen für den Hintergrund-Druckdienst Sonstige, z.B. Syslog-PPS Hintergrund-Druck Sonst" |
FED_DNAME | DruckSltFeRpt | Anzeige-Namen für den Hintergrund-Druckdienst Fertigung, z.B. Syslog-PPS-DruckSLTFeRpt" |
FED_SNAME | DruckSltFeRpt | Dienst-Namen für den Hintergrund-Druckdienst Fertigung, z.B. Syslog-PPS Hintergrund-Druck Fert" |
Geteilter Druckdienst
Bei dieser Art reagiert der Dienst auf den Parameter "Druckergruppe" der beim Drucker in DR11 hinterlegt werden kann. Der Dienst verarbeitet innerhalb der Druckaufträge ausschließlich Kopien für diese Gruppe. Aufrufparameter [DruckerGruppe]
Neben der Druckergruppe kann ein Druckdienst so eingestellt werden, dass dieser nur die Schnittstellen-Kopien (z.B. DMS-Kopie) verarbeitet. Aufrufparameter [DMSKopie]
Wenn DMS Kopien separat verarbeitet werden sollen, muss dies im Druckaufruf (KDRPT10) hinterlegt werden.
Dienstbeschreibung DruckVKForm und DruckEKForm
Diese Dienste sind für die Vertriebsformulare (DruckVKForm) und die Einkaufsformulare (DruckEKForm) zuständig und entsprechen sich in ihrer Funktionalität.
Aufruf
DruckVKForm.exe <Sachbearbeiter> <Passwort> <lokal / global> [<SyslogDir> [<SyslogIni> [<Mandant> [<Protokolldatei> [DruckerGruppe [DMSKopie]]]]]]
Aufrufparameter
| Parameter | Beschreibung | |
|---|---|---|
Sachbearbeiter | Muss | Sachbearbeiter für die Datenbankanmeldung |
Passwort | Muss | Passwort |
lokal/global | Muss | Bei "lokal" werden exklusiv die lokal erzeugten Druckaufträge verarbeitet, ein "global"er Dienst hat diese Einschränkung nicht. |
SyslogDir | Optional | Verzeichnis der syslog.ERP Installation, in der Regel %PRIMUSDIR% |
SyslogIni | Optional | individuelle syslog.ini des Dienstes um die Dienstnamen zu steuern |
Mandant | Optional | Mandantenbeschränkung (alle Mandanten wenn keiner oder 0 angegeben) |
Protokolldatei | Optional | Name der Protokolldatei |
DruckerGruppe | Optional | Einschränkung auf eine Druckergruppe |
DMSKopie | Optional | 0 = alle Kopien, 1 = nur die <= 9000, 2 = nur die > 9000 |
Installation als Dienst
Zur Installation als Dienst muss die Windows Eingabeaufforderung cmd.exe als Administrator geöffnet werden. Die installation erfolgt durch den eingeschobenen Aufrufparameter " /install". Enfernt wird der Dienst mit dem Parameter " /uninstall".
DruckVKForm.exe /install <Sachbearbeiter> <Passwort> <lokal / global> [<SyslogDir> [<SyslogIni> [<Mandant> [<Protokolldatei> [DruckerGruppe [DMSKopie]]]]]]
Dienstbeschreibung DruckSltRpt
Dieser Dienst ist modulübergreifend für Buchungsbelege, Behälteretiketten, Listenabrufe und Statistiken zuständig. Eine Kaskadierung zur Druckverteilung ist nicht möglich.
Aufruf
DruckSltRpt.exe <Sachbearbeiter> <Passwort> <lokal / global> [<SyslogDir> [<SyslogIni> [<Mandant> [<Protokolldatei>]]]]
Aufrufparameter
| Parameter | Beschreibung | |
|---|---|---|
Sachbearbeiter | Muss | Sachbearbeiter für die Datenbankanmeldung |
Passwort | Muss | Passwort |
lokal/global | Muss | Bei "lokal" werden exklusiv die lokal erzeugten Druckaufträge verarbeitet, ein "global"er Dienst hat diese Einschränkung nicht. |
SyslogDir | Optional | Verzeichnis der syslog.ERP Installation, in der Regel %PRIMUSDIR% |
SyslogIni | Optional | individuelle syslog.ini des Dienstes um die Dienstnamen zu steuern |
Mandant | Optional | Mandantenbeschränkung (alle Mandanten wenn keiner oder 0 angegeben) |
Protokolldatei | Optional | Name der Protokolldatei |
Dienstbeschreibung DruckSltFeRpt
Dieser Dienst ist besonders bei Sammelabrufen von Fertigungspapieren sinnvoll, da durch die große Anzahl von Papieren der abrufende Client blockiert wäre. Anders als beim Vertriebs- und Einkaufsdruck kann die Druckart (Druck direkt/Druck im Hintergrund) eines Papiers nicht interaktiv gesteuert werden, dies erfolgt über Systemschalter .
Der Hintergrunddruck druckt alle Fertigungspapiere einschließlich die über "Dokumente" angehängten Fertigungsdokumente. Da Fremddokumente über ihre entsprechende Applikation gedruckt werden, git es einen weiteren Systemschalter für eine Wartezeit zwischen 2 Fertigungsaufträgen.
Aufruf
DruckSltFeRpt.exe <Sachbearbeiter> <Passwort> <lokal / global> [<SyslogDir> [<SyslogIni> [<Mandant> [<Protokolldatei>]]]]
Aufrufparameter
| Parameter | Beschreibung | |
|---|---|---|
Sachbearbeiter | Muss | Sachbearbeiter für die Datenbankanmeldung |
Passwort | Muss | Passwort |
lokal/global | Muss | Bei "lokal" werden exklusiv die lokal erzeugten Druckaufträge verarbeitet, ein "global"er Dienst hat diese Einschränkung nicht. |
SyslogDir | Optional | Verzeichnis der syslog.ERP Installation, in der Regel %PRIMUSDIR% |
SyslogIni | Optional | individuelle syslog.ini des Dienstes um die Dienstnamen zu steuern |
Mandant | Optional | Mandantenbeschränkung (alle Mandanten wenn keiner oder 0 angegeben) |
Protokolldatei | Optional | Name der Protokolldatei |
Systemschalter
| FERT_FE40_DRHINTER | Dieser Schalter aktiviert den Hintergrund aus syslog.ERP heraus |
| FERT_FE40_HINTVAL | Wartezeit zwischen zwei Fertigungsaufträgen |
Dienstbeschreibung druckartetk
In der Fertigung kann es, insbesondere bei Geräten mit zu registrierenden Seriennummern, zu einem grossen Druckaufkommen bei Etiketten kommen.
Deshalb können in FE50 die Etiketten auch im Hintergrund abgerufen werden. Die generierten Etikettenwerden von diesem Druckdienst abgearbeitet.
Druckartk kann über die Eingabeaufforderung gestartet oder als Dienst installiert werden.
Aufruf über Eingabeaufforderung
druckartetk.exe <Sachbearbeiter> <Passwort>
Aufrufparameter
| Parameter | Beschreibung | |
|---|---|---|
Sachbearbeiter | Muss | Sachbearbeiter für die Datenbankanmeldung |
Passwort | Muss | Passwort |
Umgebungsparameter
| Parameter | Beschreibung | |
|---|---|---|
| PRIMUSDIR | Muss | PRIMUSDIR muss in der Umgebung auf das Installationsverzeichnis gesetzt werden |
| Optional | %PRIMUSDIR%\syslog.ini kann hiermit übersteuert werden |
Installation als Dienst
Zur Installation als Dienst muss die Windows Eingabeaufforderung cmd.exe als Administrator geöffnet werden. Die installation erfolgt durch den eingeschobenen Aufrufparameter " /install". Enfernt wird der Dienst mit dem Parameter " /uninstall".
druckartetk.exe /install <Sachbearbeiter> <Passwort> <lokal / global> [<SyslogDir> [<SyslogIni> [<Mandant> [<Protokolldatei> [DruckerGruppe [DMSKopie]]]]]]
Dienstbeschreibung DruckSltRpt
erweitertes Fehlerhandling
In einer dynamischen Umgebung kommt es immer wieder zu Störungen was zu Fehlern führen kann. Ist zum Beispiel der Drucker für den Druckdienst nicht erreichbar muss der Druckauftrag als "gefehlt" markiert werden. Fehler die ihre Ursache in einer vorübergehenden Störung (Netzwerkprobleme, instabiler Dienst, Datenzugriffsprobleme) haben, können über einen Fehlereskalationslogik eliminiert werden.
Das erweiterte Fehlerhandling ist über die Systemsteuerung SI10 einzustellen.
Druckversuche
| 0/1 | ein fehlgeschlagener Druck wird erneut gestartet | |
| # | Pause zwischen Druckversuchen | |
| # | Anzahl wie oft ein fehlgeschlagener Druck wiederholt werden soll bevor er endgültig als gefehlt markiert wird. Waren alle Versuche erfolglos, wird in %PRIMUSDIR%\tmp die Datei DruckVKForm.restart erzeugt. Dadurch kann mit dem Tool sysevt(ta) eine weitere Aktion wie zum Beispiel Neustart des Druckdienstes ausgelöst werden. |
Druckfehler
Wenn es zu einem Fehler kommt mit einem Lua-Skript beim Drucken, kann es sein das auf dem Server die Variablen der Syslog Pfade fehlen.
Unter den Systemumgebungsvariablen unter PATH dann hinzufügen:
- %PRIMUSDIR%
- %PRIMUSDIR%\admin
- %PRIMUSDIR%\stam1.0\bin
Danach den Dienst Neustarten und den Druck nochmal versuchen.