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.


ModulDienstnameOrtDialogBemerkung
VertriebDruckVKForm.exe%PRIMUSDIR%\auft1.0\binAB10es können mehrere Dienste mit gleichen oder unterschiedlichen Aufgaben installiert werden
EinkaufDruckEKForm.exe%PRIMUSDIR%\eink1.0\binABEK10es können mehrere Dienste mit gleichen oder unterschiedlichen Aufgaben installiert werden
Listen, Statistik, LabelsDruckSLTRpt.exe%PRIMUSDIR%\stam1.0\binDD10es können mehrere Dienste mit gleichen oder unterschiedlichen Aufgaben installiert werden
Fertigung PapiereDruckSltFeRpt.exe%PRIMUSDIR%\fert1.0\binDDFE10es können mehrere Dienste mit gleichen oder unterschiedlichen Aufgaben installiert werden
Fertigung Etikettendruckartetk.exe%PRIMUSDIR%\fert1.0\binFE50CMD 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

ParameterDruckdienstBeschreibung

VKD_DNAME

DruckVKFormAnzeige-Namen für den Hintergrund-Druckdienst VK, z.B. "Syslog-PPS Hintergrund-Druck VK"
VKD_SNAMEDruckVKFormDienst-Namen für den Hintergrund-Druckdienst VK, z.B. "Syslog-PPS-DruckVKForm"
EKD_DNAMEDruckEKFormAnzeige-Namen für den Hintergrund-Druckdienst EK, z.B. "Syslog-PPS Hintergrund-Druck EK"
EKD_SNAMEDruckEKFormDienst-Namen für den Hintergrund-Druckdienst EK, z.B. "Syslog-PPS-DruckEKForm"
SOD_DNAMEDruckSLTRptAnzeige-Namen für den Hintergrund-Druckdienst Sonstige, z.B. Syslog-PPS-DruckSLTRpt"
SOD_SNAMEDruckSLTRpt

Dienst-Namen für den Hintergrund-Druckdienst Sonstige, z.B. Syslog-PPS Hintergrund-Druck Sonst"

FED_DNAME
DruckSltFeRptAnzeige-Namen für den Hintergrund-Druckdienst Fertigung, z.B. Syslog-PPS-DruckSLTFeRpt"
FED_SNAME
DruckSltFeRptDienst-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
MussSachbearbeiter für die Datenbankanmeldung
Passwort
MussPasswort
lokal/global
MussBei "lokal" werden exklusiv die lokal erzeugten Druckaufträge verarbeitet, ein "global"er Dienst hat diese Einschränkung nicht. 
SyslogDir
OptionalVerzeichnis der syslog.ERP Installation, in der Regel %PRIMUSDIR%
SyslogIni
Optionalindividuelle syslog.ini des Dienstes um die Dienstnamen zu steuern
Mandant
OptionalMandantenbeschränkung (alle Mandanten wenn keiner oder 0 angegeben)
Protokolldatei
OptionalName der Protokolldatei
DruckerGruppe 
OptionalEinschränkung auf eine Druckergruppe
DMSKopie
Optional0 = 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
MussSachbearbeiter für die Datenbankanmeldung
Passwort
MussPasswort
lokal/global
Muss

Bei "lokal" werden exklusiv die lokal erzeugten Druckaufträge verarbeitet, ein "global"er Dienst hat diese Einschränkung nicht.

SyslogDir
OptionalVerzeichnis der syslog.ERP Installation, in der Regel %PRIMUSDIR%
SyslogIni
Optionalindividuelle syslog.ini des Dienstes um die Dienstnamen zu steuern
Mandant
OptionalMandantenbeschränkung (alle Mandanten wenn keiner oder 0 angegeben)
Protokolldatei
OptionalName 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
MussSachbearbeiter für die Datenbankanmeldung
Passwort
MussPasswort
lokal/global
Muss

Bei "lokal" werden exklusiv die lokal erzeugten Druckaufträge verarbeitet, ein "global"er Dienst hat diese Einschränkung nicht.

SyslogDir
OptionalVerzeichnis der syslog.ERP Installation, in der Regel %PRIMUSDIR%
SyslogIni
Optionalindividuelle syslog.ini des Dienstes um die Dienstnamen zu steuern
Mandant
OptionalMandantenbeschränkung (alle Mandanten wenn keiner oder 0 angegeben)
Protokolldatei
OptionalName der Protokolldatei


Systemschalter

FERT_FE40_DRHINTER Dieser Schalter aktiviert den Hintergrund aus syslog.ERP heraus
FERT_FE40_HINTVALWartezeit 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
MussSachbearbeiter für die Datenbankanmeldung
Passwort
Muss
Passwort

Umgebungsparameter

Parameter
Beschreibung
PRIMUSDIRMuss

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> [<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

AUFT_DRUCK_EFEHL

EINK_DRUCK_EFEHL

0/1ein fehlgeschlagener Druck wird erneut gestartet

AUFT_DRUCK_EFPAU

EINK_DRUCK_EFPAU

#Pause zwischen Druckversuchen

AUFT_DRUCK_EFANZ

EINK_DRUCK_EFANZ

#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.