Toolmaker Produkt-Dokumentation
Der directmail – IFS Monitor
- Robert E. Schneider
- Elisa Knapp (Unlicensed)
Inhaltsübersicht
Mit dem directmail IFS Monitor werden Verzeichnisse im IFS überwacht und Dokumente die dort eingestellt werden automatisch per Mail versendet. In der Definition des directmail IFS Monitors wird festgelegt, mit welchen Parametern das eigentliche Monitoring erfolgen soll. Definiert wird, welche Dateien wie berücksichtigt werden, die im entsprechenden Pfad im definierten Verzeichnis abgelegt sind, in welchen Zeitabständen die Verzeichnisse geprüft werden, an welche E-Mal Adresse die Dokumente versendet werden und welches Layout die E-Mails haben.
Die Konfiguration erfolgt ausschließlich über directweb. directweb wird automatisch mit directmail installiert.
Der directmail IFS Monitor kann nur dann funktionieren, wenn für diesen entsprechende Parameter definiert sind.
Einige Parameter (z.B. Email Adressen) können mehrfach, d.h. mit einer Folge-Nr. versehen werden. Viele der Parameter sind ebenfalls in den Befehlen OPNEMLAPI, WRTEMLAPI, CLSEMLAPI vorhanden.
Parametereinstellungen der directmail IFS Monitor Definition. Über diese Parameter werden u.a. die E-Mail-Parameter (z.B. E-Mail-Adresse, Betreff, Kopie etc) gesteuert. Folgende Parameter sind zulässig:
Befehl STRMAILIFS IFS Monitor starten
Mit dem Befehl STRMAILIFS wird der directmail IFS Monitor gestartet. Mit dem Befehl ENDMAILIFS kann der directmail IFS Monitor wieder beendet werden.
Monitor - Name des zu startenden directmail IFS Monitors.
Der directmail IFS Monitor startet im Subsystem QINTER.
Befehl ENDMAILIFS IFS Monitor beenden
Mit dem Befehl ENDMAILIFS wird der directmail IFS Monitor beendet. Mit dem Befehl STRMAILIFS kann der directmail IFS Monitor wieder gestartet werden.
Monitor - Name des zu beendenden directmail IFS Monitors.
Beenden - Gibt an, ob der directmail IFS Monitor sofort oder kontrolliert beendet werden soll.
Gültige Werte sind:
*CNTRLD Der directmail IFS Monitor wird kontrolliert beendet. Dadurch kann das Programm eine Bereinigung (Jobendeverarbeitung) durchführen.
*IMMED Der directmail IFS Monitor wird sofort beendet. Das System führt eine Bereinigung bei Jobende durch.
directmail IFS Monitor Kontextmenü
Wird der Cursor auf einen Listeintrag (grau) positioniert, so kann mit der rechten Maustaste ein Kontextmenü zur Verwaltung des Listeintrages (IFS Monitor) geöffnet werden.
directmail IFS Monitor erstellen oder ändern
Hinweis: Eine Änderung in der Definition ist nur im deaktivierten Zustand möglich.
Name - Name der directmail IFS Monitor Definition( max. 20 Zeichen).
Beschreibung - Eingabe einer ergänzenden Beschreibung für den directmail IFS Monitor ( max. 40 Zeichen).
Aktiviert - Hiermit wird ein der directmail IFS Monitor aktiv geschaltet.
Server Typ - Mit dem Server Typ wird festgelegt, ob es sich um ein directmail IFS Verzeichnis oder um einen FTP Server als Server Typ handelt, der mit dieser IFS Monitordefinition überwacht werden soll.
IFS Verzeichnis - Bei Aktivierung wird ein IFS Verzeichnis überwacht.
FTP Server - Bei Auswahl FTP Server muss dieser mit IP-Adresse angegeben werden.
Server - Eingabe der IP Adresse des FTP Servers.
Benutzer - Eingabe des Benutzer für die Anmeldung am FTP-Server mit Kennwort und Kennwortüberprüfung.
Pfad - Eingabe des Pfades der beim Monitoring überwacht werden soll.
Unterverzeichnisse durchsuchen - Bei Aktivierung werden darunterliegende Unterverzeichnisse ebenfalls überwacht.
Eingabe der Dateiendung (z.B. pdf) für die zu überwachende Dateriart. Es ist möglich mehrere Dateiarten anzugeben, getrennt durch Komma (z.B.pdf,tif). Maximal zwanzig Einträge zulässig.
Dateiendungen (durch "," trennen)
Dateien löschen - Bei Aktivierung werden die Dateien nach dem E-Mail Versand gelöscht.
Mindestalter der Datei - Es kann angegeben werden, wie alt eine Datei in Sekunden sein muss, bevor diese per Mail versendet wird. Dies ist hilfreich, um Sperren zu umgehen.
Zeitintervall gesteuert - Bei Aktivierung kann ein Prüfintervall und Zeitraum für das Monitoring eingegeben werden.
Prüfintervall - Eingabe eines Prüfintervalls. Gültige Werte sind Stunden, Minuten, Sekunden.
Zeitraum - Im eingetragenen Zeitraum findet das Monitoring statt. Gültige Zeiträume für das Monitoring sind eine bestimmte Uhrzeit und die einzelnen Wochentage.
Nicht Zeitintervall gesteuert - Wurde kein Zeitintervall gesteuertes Monitoring ausgewählt, so muss eine
feste Uhrzeit und auch die
Wochentage eingegeben werden.
Eigener Job - Bei Aktivierung kann ein eigener Job Name für den directmail IFS Monitor Job vergeben werden. Dies ist hilfreich für eine bessere Übersicht der Jobs.
Job Name - Eingabe eines Jobnamens unter dem das IFS Monitoing im Subsystem QINTER erfolgen soll.
Automatisch starten - Dieser Job kann automatisch gestartet werden.
Fehlermeldungen per E-Mail an - Fehlermeldungen können gleich per E-Mail an eine entsprechende Adresse weitergereicht werden.
Spaltentrennzeichen - Das Trennzeichen
Die Parameter des directmail IFS Monitor
Verfügbare E-Mail-Parameter
Um ein E-Mail versenden zu können muss mindestens die E-Mail-Adresse des Empfängers angegeben werden.
Weitere Parameter für den E-Mail-Versand können für einen IFS Monitor definiert werden:
Mailbox - aus welcher Mailbox soll das E-Mail versandt werden?
Absender Email Adresse
Absender Name
Empfänger Email Adresse (mehrfach)
Empfänger Name (mehrfach)
CC Email Adresse (mehrfach)
CC Name (mehrfach)
BCC Email Adresse (mehrfach)
BCC Name (mehrfach)
Betreff des E-Mails
Text HTML Template - Vorlage für den E-Mail-Body in Form einer HTML-Datei
Text Template - Vorlage für den E-Mail-Body in Form einer einfachen Text-Datei
Variable/Platzhalter
Lesebestätigung
Email Priorität
Email anhalten
Datei Alias Name
Datei als Email Text
Datei komprimieren
Datei signieren
zusätzlicher Dateianhang
Herkunft der Parameter
Diese E-Mailo Parameter können dem IFS-Monitor aus verschiedenen Quellen zur Verfügung gestellt werden:
fest eingegebener Text
hier kann man auch Variablen verwenden, z.B. "
Rechnung Nr. &RGNR"
CSV-Datei -Findet der IFS Monitor eine gleichnamige CSV Datei, so können die Spaltenwerte dieser Datei als Quelle verwendet werden
die Spalten sind mit einem Trennzeichen zu trennen - Das Trennzeichen wird in der Definition des IFS-Monitors festgelegt
Dateiname - der Wert wird aus dem Dateinamen extrahiert
Dokumenteigenschaften des zu versendenden PDF-Dokumentes
Titel
Autor (Verfasser)
Thema
Schlüsselwörter
Im Feld Spalte kann angeben werden, welcher Spalte innerhalb der Quelle gewählt werden soll.
D.h. auch in der Quelle „PDF Titel" können mehrere Parameter durch Trennzeichen verschlüsselt werden. - ## Das muss noch geprüft werden!
Exit Programm - Weiterhin besteht die Möglichkeit für jeden Parameter ein Exit-Programm zu definieren.
Dieses erlaubt dann z.B. die Umsetzung einer Kunden-Nr. in einen Namen oder in eine Email Adresse.
Ein Beispiel Exit Programm befindet sich in der Bibliothek DIRMAIL/QRPGLESRC mit dem Namen: IFSMONEXT.
Folge-Nr - Einige Parameter (z.B. Email Adressen) können mehrfach, deshalb muß für diese eine Folge-Nr. angegeben werden.
Die Parameter-Definitionen
MailBox - Der Name der Mailbox (wie in directmail definiert) über die die Email verschickt werden soll. Wird kein Wert angegeben, so wird versucht die Mailbox des IFS Monitor Benutzers zu verwenden.
Absender Email Adresse - Die Email Adresse des Absenders. Wird kein Wert angegeben, so wird die Adresse der Mailbox verwendet.
Absender Name - Der Name des Absenders. Wird kein Wert angegeben, so wird der Name aus der Mailbox verwendet.
Empfänger Email Adresse (mehrfach) - Email Adresse des Empfängers.
Feld Folge-Nr: Dieser Wert kann mehrfach angegeben werden falls es mehrere Empfänger gibt
Empfänger Name (mehrfach) - Name des Empfängers.
Feld Folge-Nr: Dieser Wert kann mehrfach angegeben werden. Achtung: Die Folge-Nr. muss dabei der Folge-Nr. der Email Adresse entsprechen.
CC Email Adresse (mehrfach) - Email Adresse des CC.
Dieser Wert kann mehrfach angegeben werden.
CC Name (mehrfach) - Name des CC.
Dieser Wert kann mehrfach angegeben werden. Achtung: Die Folge-Nr. muss dabei der Folge-Nr. der Email Adresse entsprechen.
BCC Email Adresse (mehrfach) - Email Adresse des BCC.
Dieser Wert kann mehrfach angegeben werden.
BCC Name (mehrfach) - Name des BCC.
Dieser Wert kann mehrfach angegeben werden. Achtung: Die Folge-Nr. muss dabei der Folge-Nr. der Email Adresse entsprechen.
Lesebestätigung - Soll eine Lesebestätigung vom Empfänger angefordert werden.
Gültige Werte sind:
*YES / Y / 1 / YES Lesebestätigung wird vom Empfänger angefordert
*NO / N / 0 / NO Lesebestätigung wird vom Empfänger nicht angefordert
Email Priorität - Es kann eine Priorität für den Email-Versand definiert werden.
Gültige Werte sind:
*HIGH / H / HIGH hohe Priorität
*LOW / L / LOW niedrige Priorität
Email anhalten - Eine Email kann im Postkorb angehalten werden.
Gültige Werte sind:
*YES / Y / 1 / YES Email wird im Postkorb gehalten
*NO / N / 0 / NO Email wird nicht angehalten
Alle Attachments komprimieren - Attachments können komprimiert werden.
Gültige Werte sind:
*YES / Y / 1 / YES Attachments werden komprimiert
*NO / N / 0 / NO Attachments werden nicht komprimiert
Betreff - Dieser Parameter definiert den Betreff der Email.
Text HTML Template - Vorlage für den Email-Bodytext als HTML-Datei
Eine Email kann mit einem HTML Text verschickt werden. HTML erlaubt es besser formatierten Text zu versenden. Im HTML können Variablen/Platzhalter verwendet werden (&VARIABLE).
Text Template - Vorlage für den Email-Bodytext als einfache Text-Datei
Eine Text-Datei im IFS der IBMi für den Text der Email. Wie beim HTML Template können auch hier Variablen/Platzhalter verwendet werden (&VARIABLE).
Datei Alias Name - Name des Attachments in der Email
Soll die Datei nicht mit dem Originalnamen verschickt werden, so kann hier ein ALIAS Dateiname angegeben werden, der dann für den Empfänger sichtbar ist.
Datei als Email Text - Handelt es sich bei der IFS Datei um eine Text- oder HTML Datei, so kann der Inhalt der Datei als Email Text verwendet werden. Bei HTML sollte *ALT gewählt werden.
Gültige Werte: *YES, *NO, *ALT, Y, N, A, YES, NO, ALT
Datei komprimieren - Gibt an, ob die IFS Datei in der Email komprimiert (ZIP) verschickt werden soll.
Gültige Werte sind:
*YES / Y / 1 Attachments werden komprimiert
*NO / N / 0 Attachments werden nicht komprimiert
Datei signieren - Gibt an, ob die IFS Datei signiert werden soll. (SmartCard Signatur)
Gültige Werte sind:
*NO / N / NO keine Dateisignierung
*IMMED / I / IMMED Dateisignierung erfolgt sofort
*DELAYED / D / DELAYED Dateisignierung erfolgt später
Dieser Parameter definiert die Signatur der Email.
Zusätzlicher Dateianhang (mehrfach) - IFS Datei als zusätzliches Attachment
Sollen weitere Dateien angehängt werden (z.B. AGBs etc.), so können hiermit mehrere IFS Dateien angegeben werden.
Variable/Platzhalter (mehrfach) - Name der Variable
Sollen Werte als Variablen Verwendung finden, so können diese als Variable/Platzhalter definiert werden. Hier muss dann ebenfalls das Feld "Variable/Platzhalter" gefüllt werden. Auf Variablen kann in Templates (HTML/TXT) aber auch in anderen Parameters mittels &VARIABLE zugegriffen werden. (z.B. "Anbei erhalten Sie Rechnung &RECHNR")