SMTP New transporter

Home

4D v20 R7

Mail


SMTP New transporter ( server ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
server	Objekt	Mail server information
Funktionsergebnis	Objekt	SMTP transporter object

Beschreibung

Der Befehl SMTP New transporter konfiguriert eine neue SMTP Verbindung gemäß dem Parameter server und gibt ein neues Objekt transporter zurück. Das zurückgegebene Objekt transporter wird dann normalerweise zum Senden von Mails verwendet.

Im Parameter server übergeben Sie ein Objekt mit folgenden Eigenschaften:

Eigenschaft

Typ

Beschreibung

host

Text

Name oder IP Adresse des Host Servers für SMTP Transaktionen.

port

Zahl

(optional) Port für SMTP Transaktionen. Standardwert=587

keepAlive

Boolean

(optional) Wahr, um die Verbindung bis zum Zerstören des Objekts transporter live zu halten. Standardwert=True

connectionTimeOut

Zahl

(optional) Maximale Wartezeit (in Sekunden) zum Herstellen einer Verbindung mit dem Server. Standardwert=30

sendTimeOut

Zahl

(optional) Maximale Wartezeit (in Sekunden) des Aufrufs sendMail bis zum Timeout. Standardwert=100

authenticationMode

Text

Authentifizierungsmodus zum Öffnen der Sitzung auf dem SMTP Server(*). Mögliche Werte:

Konstante	Wert	Kommentar
SMTP authentication CRAM MD5	CRAM-MD5	SMTP Authentifizierung mit CRAM-MD5 Protokoll
SMTP authentication login	LOGIN	SMTP Authentifizierung mit LOGIN Protokoll
SMTP authentication OAUTH2	OAUTH2	SMTP Authentifizierung mit OAuth 2 Protokoll
SMTP authentication plain	PLAIN	SMTP Authentifizierung mit PLAIN Protokoll

user

Text

Benutzername zur Authentifizierung auf dem Server

accessTokenOAuth2

Text

Textstring mit Eckdaten der OAuth 2 Authorisierung. Wird nur mit OAUTH2 authenticationMode verwendet. Wird accessTokenOAuth2 ohne authenticationMode eingesetzt, wird das OAuth 2 Protokoll verwendet (wenn vom Server zugelassen).

Hinweis: Ein Zugriffs-Token hat begrenzte Lebensdauer und läuft in der Regel nach einer Stunde ab. Nach Ablauf ist keine automatische erneute Verbindung möglich (z.B. bei Abmelden vom Server).

user

Text

Benutzername zur Authentifizierung auf dem Server

password

Text

Benutzerkennwort zur Authentifizierung auf dem Server

acceptUnsecureConnection

Boolean

Wahr, um 4D eine unverschlüsselte Verbindung zu erlauben, wenn keine verschlüsselte Verbindung möglich ist (**). Bei Falsch wird ein Fehler zurückgegeben, wenn keine verschlüsselte Verbindung möglich ist. Standardwert=False

logFile

Text

(optional) Dateipfad für erweitertes Logbuch(***). Kann absolut sein oder relativ zum aktuellen Ordner Logs

headerCharset

Text

(optional) Zeichensatz und Codierung für folgende Teile des E-Mail: Betreff, Anhang Dateinamen und E-Mail Name Attribut(e). Mögliche Werte:

Konstante	Wert	Kommentar
mail mode ISO2022JP	US-ASCII_ISO-2022-JP_UTF8_QP	headerCharset: US-ASCII wenn möglich, Japanese (ISO-2022-JP) & Quoted-printable wenn möglich, sonst UTF-8 & Quoted-printable bodyCharset: US-ASCII wenn möglich, Japanese (ISO-2022-JP) & 7-bit wenn möglich, sonst UTF-8 & Quoted-printable
mail mode ISO88591	ISO-8859-1	headerCharset: ISO-8859-1 & Quoted-printable bodyCharset: ISO-8859-1 & 8-bit
mail mode UTF8	US-ASCII_UTF8_QP	headerCharset & bodyCharset: US-ASCII wenn möglich, sonst UTF-8 & Quoted-printable (Standardwert)
mail mode UTF8 in base64	US-ASCII_UTF8_B64	headerCharset & bodyCharset: US-ASCII wenn möglich, sonst UTF-8 & base64

bodyCharset

Text

(optional) Zeichensatz und Codierung für den html und Text Hauptteil des E-Mails. Mögliche Werte: Genauso wie für headerCharset (siehe oben)

(*) Ist authenticationMode null oder undefiniert, wird der sicherste Authentifizierungsmodus verwendet, den der Server unterstützt.

(**) Es gibt folgende gesicherte SMTP Ports:

465: SMTPS
587 oder 25: SMTP mit STARTTLS Upgrade, wenn vom Server unterstützt

(***) Erweiterte Logbücher speichern im Gegensatz zu gängigen Logbüchern (aktiviert über den Befehl SET DATABASE PARAMETER) MIME Inhalt aller gesendeten Mails und haben keine Größenbeschränkung. Weitere Informationen dazu finden Sie im Abschnitt 4DSMTPLog.txt.

Zurückgegebenes Objekt

Das zurückgegebene Objekt transporter enthält folgende read-only Eigenschaften:

Eigenschaft	Typ	Beschreibung
transporter.host	Text	Name oder IP Adresse des Host Servers für SMTP Transaktionen
transporter.port	Zahl	Port für SMTP Transaktionen.
transporter.keepAlive	Boolean	Wahr, wenn die Verbindung bis zum Zerstören des Objekts transporter live gehalten wird.
transporter.connectionTimeOut	Zahl	Maximale Wartezeit (in Sekunden) zum zum Herstellen einer Verbindung mit dem Server.
transporter.sendTimeOut	Zahl	Maximale Wartezeit (in Sekunden) des Aufrufs sendMail vor Timeout.
transporter.acceptUnsecureConnection	Boolean	Wahr, wenn 4D eine unverschlüsselte Verbindung herstellen darf, wenn keine verschlüsselte Verbindung möglich ist. Falsch, wenn nicht erlaubt.
transporter.authenticationMode	Text	Aktuell genutzter Authentifizierungsmodus zum Öffnen der Sitzung auf dem SMTP Server.
transporter.user	Text	Benutzername zur Authentifizierung auf dem Server.
transporter.logFile	Text	Vollständiger Pfad des Logbuchs (wenn vorhanden)

Methode	Beschreibung
transporter.send( )	Sendet Meldungen
SMTP_transporter.checkConnection( )	Prüft die Authentifizierung

Beachten Sie, dass dieser Befehl keine Verbindung auf dem SMTP Server öffnet. Die SMTP Verbindung wird beim Ausführen der Methode transporter.send( ) geöffnet.

Die SMTP Verbindung wird automatisch geschlossen:

bei Zerstören des Objekts transporter, wenn die Eigenschaft keepAlive auf wahr gesetzt ist (Standard),
nach jedem Ausführen der Methode transporter.send( ), wenn die Eigenschaft keepAlive auf falsch gesetzt ist.