Dieser Tip ist nicht als Ergänzung sondern als Ersatz zu den alten Tips zum Versenden eines Dokuments via E-Mail zu verstehen. Grund dafür ist, dass der Einsatz von Perl zur Programmierung von Skripten für print2forms-Gateways nicht mehr empfehlenswert ist, weil sich einerseits die Lizenzbedingungen dahingehende verändert haben, dass kommerzieller Einsatz kostenpflichtig ist, und andererseits inzwischen immer weniger Entwickler mit Kenntnissen zu Perl verfügbar sind.

Deshalb wird in diesem Tip das alte Thema jetzt mit der Skriptsprache PHP realisiert.

Da PHP Objekte unterstützt, wurden von uns spezielle Klassen für den Einsatz zusammen mit print2forms programmiert. Diese erleichtern das Programmieren erheblich, weil sie für häufig wiederkehrende Aufgaben bereits vorgefertigte Lösungen anbieten.

Für das Senden von E-Mails werden zwei Klassen benutzt. Zum einen ist das die Klasse control-class.php, die die Analyse von Kontrolldateien unterstützt, und zum anderen ist das die Klasse email-class.php, die - nomen est omen - die Ver­bindung zu einem E-Mail-Server herstellt. Zum genauen Verständins dieses Tips ist die Kenntnis dieser beiden Klassen notwendig.

Das Skript zum Erzeugen und Versenden von E-Mails muss drei Aufgaben erledigen:

1. Auslesen der Kontrolldatei, um Informationen zur Erzeugung des Inhalts der E-Mail zu erhalten - z.B. den Namen des Adressaten oder die Rechnungsnummer. Idealerweise ist auch die E-Mail-Adresse des Adressaten in der Kontroldatei zu finden, falls nicht, muss sie eventuell aus anderen Quellen, wie z.B. aus einer Datenbank, ermittelt werden.
   
   
2. Konvertierung der Druckausgabe (die PCL-Datei) in eine PDF-Datei.
   
   
3. Erzeugung des E-Mail-Textes, Einbindung der PDF-Datei und Versand der E-Mail.

Diese Aufgaben werden im nachfolgend abgebildeten Skript nacheinander erledigt.

Unter dem Link p2fMail.zip steht ein Archiv mit einem vollständigen Projekt zum Austesten des Tips zur Verfügung. ¹⁾

Interessiert nur das Skript alleine, sollte es vorzugsweise über diesen Link mail.php geladen werden, weil beim Laden über den Reiter des Quellcodes die Unicode-BOM verlorengeht. ²⁾

mail.php

<?php
/* E-Mail sending example - call: "C:\php\php.exe" "%1/mail.php" "%1" "%2" %4 */
 
require "control-class.php";
require "email-class.php";
 
chdir (dirname(__FILE__));            /* active directory is script directory */
 
if ($argc < 4)
  control::error ("Invalid number of arguments $argc", 1);
 
$spool    = $argv [2];                            /* path to spooled document */
$document = $argv [3];                  /* name of document without extension */
 
$vars = array ();
 
$p2f = new control("Europe/Berlin", "$spool\\$document.ctl");
 
$p2f->fetch ("01012D0846", $vars, "(\d+)", "rechnum");
$p2f->fetch ("0102410846", $vars, "(\d+)", "kndnum");
$p2f->fetch ("01036C00C6", $vars, "(.*)", "kndname");
$p2f->fetch ("01050A0229", $vars, "(.*)", "kndmail");
$p2f->fetch ("0102860846", $vars, ".+ (\d+)", "auftrnum");
$p2f->fetch ("0101720846", $vars, "(\d\d\.\d\d\.\d{4})", "rechdatum");
 
/* PDF file creation with supplied meta data */
 
$pdf = $p2f->createpdf ("$spool\\$document.pcl",
                        "Lieferant GmbH",
                        "Rechnung {$vars ["rechnum"]}",
                        "{$vars ["rechnum"]}; {$vars ["rechdatum"]}; {$vars ["kndnum"]}");
 
if ($pdf != "")                                    /* pdf creation successful */
  {
    $data = array
      (
        "from"     => "info@lieferant-gmbh.local",
        "fromname" => "Buchhaltung Lieferant GmbH",
        "to"       => $vars ["kndmail"]
        "toname"   => $vars ["kndname"],
    //  "cc"       => "",
    //  "ccname"   => "",
        "file"     => $pdf,
        "filename" => "Rechnung {$vars ["rechnum"]}.pdf",
        "subject"  => "Lieferant GmbH - Rechnung {$vars ["rechnum"]}",
        "body"     =>
 
        $p2f->substitute ("Sehr geehrte Damen und Herren,<br/><br/>" .
                          "vielen Dank für Ihren Auftrag @auftrnum@.<br/><br/>" .
                          "Mit dieser Mail erhalten Sie dazu unsere Rechnung @rechnum@<br/>" .
                          "mit Datum vom @rechdatum@ im Format PDF/A.<br/><br/>" .
                          "Mit freundlichen Grüßen<br/>" .
                          "Ihre Lieferant GmbH<br/><br/><br/>" .
                          "Lieferant GmbH<br/>" .
                          "Lieferweg 21<br/>" .
                          "80345 Musterstadt<br/><br/>" .
                          "Tel.: +49 1234 1234-0<br/>" .
                          "Fax:  +49 1234 1234-123<br/><br/>" .
                          "Mail: info@lieferant-gmbh.local<br/><br/>" .
                          "Geschäftsführer: A. Mustermann<br/>" .
                          "Registergericht Musterstadt: 5 HRB 12345<br/>" .
                          "USt-IdNr.: DE123456789<br/>", $vars)
      );
 
    $em = new email ("server", 465, "user", "password");
 
    if ($em->sendmail ($data, $message) == 0)
      $p2f->error ("Sending e-mail failed '$message'", 0);
  }
else
  $p2f->error ("No document available for e-mail", 0);
 
if ($p2f->errorsfound () != 0)
  exit (-1);
?>

Das Skript startet als erstes mit der Einbindung der beiden notwendigen Klassen in den Zeilen 4 und 5. Danach wird das aktuelle Arbeitsverzeichnis auf das Skriptverzeichnis gesetzt (Zeile 7), um so bei weiteren Dateinamen keine langen Pfade mit angeben zu müssen.

Nach der Prüfung der Argumente (Zeilen 9 bis 13) wird ein zunächst leeres Array zum Aufsammeln der für die E-Mail wichtigen Informationen angelegt (Zeile 15). Dieses Array wird in den Folgezeilen nach und nach mit Texten aus der Kontrolldatei gefüllt. Die regulären Ausdrücke geben für einzelne Daten schon feste Formate vor, so z.B. beim Rechnungsdatum (Zeile 24).

Mit Zeile 28 wird dann die Erzeugung der PDF-Datei initiiert. Neben dem Namen der PCL-Datei wird der Firmenname, eine Dokumentbeschreibung und eine Reihe von Schlüsselworten mitgegeben. Diese werden als Meta-Daten in die PDF-Datei mit eingebaut und erleichtern so die Nachverarbeitung der Datei beim Empfänger.

Die erzeugte E-Mail im HTML-Format und als reiner Text:

• Soll das Projekt p2fMail in Betrieb genommen werden, kann es sein, dass in der Datei launch.json der Pfad auf die PHP-Installation an die lokalen Gegebenheiten angepasst werden muss. Das Projekt selbst sollte im Skriptver­zeichnis von print2forms abgelegt werden. Was auch klar sein sollte: die E-Mail-Adressen und der Zugriff auf den Mail-Server in mail.php müssen ebenfalls angepasst werden. In der Datei launch.json ist das Spoolverzeichnis so gesetzt, dass die beiden Dateien aus dem Unterverzeichnis test verwendet werden!

• Das Projekt p2fMail kann und sollte dann, wie in den Tips Visual Studio Code für PHP installieren, Test von PHP Skripten und PHP-Skript ohne Gateway testen beschrieben, angepasst und getestet werden.

• Aus lizenzrechtlichen Gründen dürfen die Programme GhostPCL und GhostScript der Firma Artifex nicht mit print2forms zusammen ausgeliefert werden. Sie sind daher nicht Bestandteil des Projekts p2fMail.
  
  Nachdem die Programme von den hier angegebenen Web-Adressen geladen wurden, müssen für GhostPCL die beiden Dateien gpcl6win64.exe und gpcl6win64.dll (für 64-Bit Systeme, ansonsten gpcl6win32.exe und gpcl6win32.dll für 32-Bit Systeme) in den Ordner converter kopiert werden. Für GhostScript müssen die beiden Dateien gswin64.exe und gsdll64.dll (für 64-Bit Systeme, ansonsten gswin32.exe und gsdll32.dll für 32-Bit Systeme) kopiert werden.