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.