Möglichkeiten des directfax IFS-Monitors

Mit Hilfe des IFS Monitors können IFS Verzeichnisse oder FTP Verzeichnisse überwacht und die dort gefundenen Dateien per Fax oder als E-Mail versendet werden. Unterstützte Dateitypen sind die, die auch vom Befehl FAXOBJ verarbeitet werden. (PDF, TIF, JPG)

Die Fax-Anwahl-Nr. sowie weitere Parameter können auf verschiedene Arten übergeben werden (Dateiname, CSV-Datei, Attribute der PDF-Datei).

Das Setup erfolgt ausschließlich über WOPiXX, das zwingend installiert sein muss.

Konfiguration der directfax E-Mail-Funktion

Wenn die Dateien per E-Mail versendet werden sollen, dann wird die Datei im IFS als Anhang eines E-Mails mit einem Standardtext geschickt. Dazu ist es wichtig, dass im Befehl CFGFAXMAIL einige Parameter richtig gesetzt sind. Darüber hinaus können Sie den hinterlegten Standardtext ändern.

Der Befehl CFGFAXMAIL

Stellen Sie sicher, dass die beiden Parameter so gesetzt sind:

MAILFMT(*TIFF)
GRFFMT(*PDF)

Der Standardtext für das E-Mail

Der Standardtext ist hinterlegt in einer IBM i - Quellen-Datei DIRECTFAXF/##COVER, Teildatei ##EMAILTXT.

Diesen Text können Sie nach Ihren Anforderungen anpassen.

Konfiguration des directfax IFS-Monitors in WOPiXX

Der IFS-Monitor von directfax wird im Browser über WOPiXX konfiguriert. Öffnen Sie dafür einen Webbrowser und navigieren Sie zur WOPiXX-Startseite Ihrer IBM i.

• wenn Ihre IBM i für SSL konfiguriert ist, dann ist dieses die URL https://<ibm-i-adrssse>
• wenn Ihre IBM i nicht für SSL konfiguriert ist dann ist es die URL http://<ibm-i-adresse>:8888

Dabei ist die Portnummer 8888 der Standard. Auf Ihrer IBM i könnte dieser geändert worden sein, in diesem Fall finden Sie weitere Informationen auf der Seite Web-Anmeldung bei WOPiXX.

Die Anzeige für die Konfiguration erreichen Sie über directfax → Dienste → IFS Monitor

Image Modified

IFS-Monitor - Status

Mit dem Button Erstellen können Sie einen Monitor-Job erstellen und konfigurieren.

...

Konfiguration eines IFS-Monitor-Jobs - "Rahmendaten"

Konfiguration der Fax-Parameter

• Fax-Anwahl (*FAXDIAL) oder Email Adresse (*EMLADR)
  
• Email Betreff (*EMLREF)
  
• Fax Auflösung (*RESFINE)
  
• Fax anhalten (*HOLD)
  
• Nachricht senden (*SNDMSG)
  
• Benutzer (*USER)
  
• Protokolldrucker (*OUTQ)
  
• Fax-Formular (*FORM)
  
• Uhrzeit für Versand (*SCDTIM)
  
• Nachversand (*NIGHT)
• Kostenstelle (*COST)
  
• Digtale Signatur (*DSNAME)
  
• Zusatzinformationen (*FAXINFO)
  
• Anwendungs-Schlüssel (*APPKEY1 und *APPKEY2)
  

Um einen oder mehrere Parameter für einen IFS-Monitor-Job zu konfigurieren öffnen Sie das Kontext-Menü für diesen Job mit Rechtem Mausklick und wählen Sie darin Parameter:

Herkunft - Für jeden Parameter können Sie angeben, woher das System den Wert dafür holen soll. Als Quelle können Sie eine "mitgelieferte" CSV-Datei angeben, den Dateinamen selbst oder bestimmte PDF-Attribute, die in der zu sendenden Datei gespeichert sind. Alternativ können Sie auch ein Exit-Programm angeben, das den jeweiligen Wert liefern muss.

Image Modified

Für die Herkunft haben sie die Wahl zwischen den folgenden Angaben aus dem Drop-Down-Menü:

CSV-Datei - zur Laufzeit muss immer eine CSV-Datei gemeinsam mit dem zu sendenden Dokument im überwachten Verzeichnis erstellt werden. Die CSV-Datei muss den gleichen Namen haben.Sie kann mehrere Parameter enthalten und zwar pro Spalte einen. Über die Angabe der Spalten-Nummer können Sie dann den Parameter der entsprechenden Spalte in der CSV-Datei zuordnen.

Zum Beispiel:

StatistikMonat.pdf
StatistikMonat.xls

Dateiname, Attribute der PDF-Datei: Verfasser, Titel, Thema - Bei Auswahl einer dieser Optionen ist es möglich, mehrere Parameter aus der angegebenen Quelle zu holen. Durch Angeben der Spalten-Nummer definieren Sie, welche der geholten Werte zugeordnet werden soll. (Das Trennzeichen zwischen den einzelnen Werten (Punkt, Komma, Semikolon, etc.) wird in der Rahmendefinition des IFS-Monitorjobs festgelegt.

Beispiele:

04035709106.pdf

Parameter Fax-Anwahl, Herkunft=Dateiname → Die PDF-Datei wird gefaxt an die Nummer 04035709106

Monatsstatistik;max.maus@acme-gmbh.de.pdf;441777.pdf

Parameter Email-Betreff, Herkunft=Dateiname,Spalte 1 → "Monatstatistik"
Parameter Email-Adresse, Herkunft=Dateiname,Spalte 2 → "max.maus@acme-gmbh.de"
Parameter Kostenstelle Herkunft=Dateiname,Spalte 3 → "441777"

Diese Auswahl funktioniert genauso auch für die PDF-Datei-Attribute Verfasser, Titel, Thema als Herkunft.

fester Wert - Angabe eines festen Wertes für den Parameter ohne Wenn und Aber.

Exit-Programm

Angeben mit: <bibliothek> / <programm>

Die Angabe eines Exit-Programmes ersetzt die Option zur Herkunft in dieser Anzeige. Der Wert für den gewählten Parameter (Fax-Anwahl, E-Mail-Adresse, usw.) wird in diesem Fall von einem selbstgeschriebenen Programm zurück gegeben. Die Angaben zu Herkunft und Spalte werden ignoriert.

Wenn man ein Exit-Programm zum Ermitteln von Werten einsetzen möchte, dann darf als "Herkunft" nicht "Dateiname" gewählt werden.

Eingabe: die Definition des IFS-Monitor-Parameters für den das Programm gerufen wird
   Monitor-Name   *CHAR  20    Name des IFS-Monitors                                     z.B. "DFXIFSMON"
   IFS-Dateiname  *CHAR  50    kompletter Pfad- und Dateiname der zu versendenden Datei. z.B. "/DFXIFSMON/Ausgang/Monatsstatistik;max.maus@acme-gmbh.de.pdf;441777.pdf"
   Parameter-Typ  *CHAR  20    zu ermittelnder Parameter                                 mögliche Werte: die Sonderwerte der verschiedenen Fax-Parameter (z.B. *FAXADR, *EMLADR, usw. - siehe oben)
   Herkunft       *CHAR  20    gewählte Herkunft                                         z.B. *FILNAM=Dateiname
Rückgabe:
   RtnVal         *CHAR 256    Wert, der vom Exit-Programm zurückgegeben wird 

Der IFS-Monitor - Job

Mit dem Befehl STRFAXIFS wird der Monitor gestartet.

0151 – Befehl STRFAXIFS

Über den Befehl ENDFAXIFS wird dieser beendet.

0307 – Befehl ENDFAXIFS

Der IFS Monitor startet im Subsystem QINTER.

0313 – directfax IFS Monitor gestartet

0094 – directfax - IFS Monitor

Der Befehl SNDTELSPLF

308 – Befehl SNDTELSPLF