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.
Über das Kontextmenü gelangt man in die 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:
Mailbox, 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), Lesebestätigung, Email Priorität, Email anhalten, Betreff, Text HTML Template, Text Template, Datei Alias Name, Datei als Email Text, Datei komprimieren, Datei signieren, zusätzlicher Dateianhang, Variable/Platzhalter
0463 – directmail IFS Monitor Definitionen
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.
0468 – Befehl STRMAILIFS
Monitor
Name des zu startenden directmail IFS Monitors.
0471 – Befehl STRMAILIFS - Hinweismeldung
Der directmail IFS Monitor startet im Subsystem QINTER.
0470 – directmail IFS Monitor gestartet
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.
0469 – Befehl ENDMAILIFS
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.
0472 - Befehl ENDMAILIFS - Hinweismeldung
Über den Parameter 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.
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.
0464 – directmail IFS Monitor Kontextmenü
directmail IFS Monitor erstellen
0465 – directmail IFS Monitor erstellen
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.
Hinweis: Eine Änderung in der Definition ist nur im deaktivierten Zustand möglich.
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.
0466 – FTP Server
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.
Dateiendungen (durch "," trennen)
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.
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.
0467 – Zeitintervall gesteuert
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.
0473 – nicht Zeitintervall gesteuert
Feste Uhrzeit
Hier kann eine feste Uhrzeit für das Monitoring eingetragen werden. Ist keine Uhrzeit eingetragen, erfolgt eine Hinweismeldung.
0474 – Hinweismeldung bei fehlender Uhrzeit
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.
0475 – directmail IFS Monitor – eigener Job
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
0480 – erstellte Parameter für directmail IFS Monitor
Parameter directmail IFS Monitor
0481 – Parameter erstellen
Parameter
Der directmail IFS Monitor erfordert entsprechende Parameter, die definiert werden müssen.
Gültige Werte sind:
0476 – directmail IFS Monitor gültige Parameter
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.
0488 – Beispiel Parameter Mailbox
Absender Email Adresse
Die Email Adresse des Absenders. Wird kein Wert angegeben, so wird die Adresse der Mailbox verwendet.
0484 – Beispiel Parameter Absender Email Adresse
Absender Name
Der Name des Absenders. Wird kein Wert angegeben, so wird der Name aus der Mailbox verwendet.
0485 – Beispiel Parameter Absender Name
Empfänger Email Adresse (mehrfach)
Email Adresse des Empfängers. Dieser Wert kann mehrfach angegeben werden falls es mehrere Empfänger gibt.
0489 – Beispiel Parameter Empfänger Email Adresse
Empfänger Name (mehrfach)
Name des Empfängers. Dieser Wert kann mehrfach angegeben werden. Achtung: Die Folge-Nr. muss dabei der Folge-Nr. der Email Adresse entsprechen.
0490 – Beispiel Parameter Empfänger Name
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 (*YES, *NO, Y, N, 1, 0, YES, NO)
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
0491 – Beispiel Lesebestätigung
Email Priorität (*HIGH, *LOW, H, L, HIGH, LOW)
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
0492 – Beispiel Email Priorität
Email anhalten (*YES, *NO, Y, N, 1, 0, YES, NO)
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.
0487 – Beispiel Parameter Betreff
Text HTML Template (IFS Pfad des HTML Templates für den Email Text)
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).
0494 - Beispiel Parameter HTML Template
Text Template (IFS Pfad des TEXT Templates für den Email Text)
Eine Text-Datei für den Text der Email. Wie beim HTML Template können auch hier Variablen/Platzhalter verwendet werden (&VARIABLE).
0495 - Beispiel Parameter Text Template
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 (*YES, *NO, *ALT, Y, N, A, YES, NO, ALT)
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.
Datei komprimieren (*YES, *NO, Y, N, 1, 0)
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 (*NO, *IMMED, *DELAYED, N, I, D, NO, IMMED, DELAYED)
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.
0499 – Beispiel Parameter Datei signieren
0500 – Beispiel Parameter Datei signieren
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.
0493 - Beispiel Parameter Zusätzlicher Dateianhang
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")
Folge-Nr
Einige Parameter (z.B. Email Adressen) können mehrfach, deshalb muß für diese eine Folge-Nr. angegeben werden.
Herkunft
Sämtliche Parameter können auf unterschiedlichste Weise mit Werten gefüllt werden. Jeder der u.a. Werte-Quellen erlaubt es, die Werte durch Trennzeichen von einander zu trennen (z.B. Dateiname: rechnung_4711_20101201.pdf). Durch die Angabe der Spalte kann dann definiert werden, welcher Wert extrahiert werden soll.
Gültige Werte sind:
0477 – Parameter Herkunft
CSV-Datei
Findet der IFS Monitor eine gleichnamige CSV Datei, so können die Spaltenwerte dieser Datei als Quelle verwendet werden.
Dateiname
Der Wert wird aus dem Dateinamen extrahiert.
PDF Titel
Der Wert wird aus dem Titel der PDF-Datei extrahiert.
0478 – PDF Titel
PDF Verfasser
Der Wert wird aus dem Verfasser der PDF-Datei extrahiert.
0479 – PDF Verfasser
PDF Thema
Der Wert wird aus dem Thema der PDF-Datei extrahiert. Es ist darauf zu achten, dass dort auch ein Wert eingetragen sein muß.
0482 – PDF Thema
PDF Schlüsselwörter
Der Wert wird aus den Schlüsselwörtern der PDF-Datei extrahiert.
0483 – PDF Stichwörter
Fester Wert
Der Wert wird als fester Wert angegeben.
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.