POP3 New transporter

Home

4D v20 R7

Mail


POP3 New transporter ( server ) -> Funktionsergebnis

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

Beschreibung

Der Befehl POP3 New transporter konfiguriert eine neue POP3 Verbindung gemäß dem Parameter server und gibt ein neues Objekt transporter zurück. Dieses Objekt wird dann in der Regel zum Empfangen von E-Mails verwendet.

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

Eigenschaft

Typ

Beschreibung

host

Text

Name oder IP Adresse des Host Server für POP3 Transaktionen

port

Zahl

(optional) Port für POP3 Transaktionen. Standardwert=995

authenticationMode

Text

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

Konstante	Wert	Kommentar
4D Client SOAP license	808465465
4D Client Web license	808465209
4D for OCI license	808465208
4D ODBC Pro license	808464946
POP3 authentication OAUTH2	OAUTH2	POP3 Authentifizierung mit OAuth 2 Protokoll

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 für 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=Falsch

connectionTimeOut

Zahl

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

logFile

Text

(optional) Dateipfad für das Logbuch, kann relativ (zum aktuellen Ordner Logs sein) oder absolut

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

(**) Es gibt folgende gesicherte POP3 Ports:

110: POP3 unverschlüsselter Port
995: POP3 mit STARTTLS Upgrade, falls vom Server unterstützt

Zurückgegebenes Objekt

Das zurückgegebene Objekt transporter enthält die folgenden Eigenschaften und Methoden (nur lesbar):

Eigenschaft	Typ	Beschreibung
transporter.host	Text	Name oder IP Adresse des Host Server für Mail Transaktionen
transporter.port	Zahl	Port für Mail Transaktionen
transporter.connectionTimeOut	Zahl	Maximale Wartezeit (in Sekunden) zum Herstellen einer Verbindung mit dem Server
transporter.acceptUnsecureConnection	Boolean	Wahr, um 4D eine unverschlüsselte Verbindung zu erlauben, wenn keine verschlüsselte Verbindung möglich ist, sonst falsch
transporter.authenticationMode	Text	Aktuell genutzter Authentifizierungsmodus zum Öffnen der Sitzung auf dem Mail Server
transporter.user	Text	Benutzername zur Authentifizierung auf dem Server
transporter.logFile	Text	Voller Pfad des Logbuchs (falls vorhanden)

Methode	Beschreibung
POP3_transporter.checkConnection()	Prüft die Authentifizierung
POP3_transporter.delete()	Setzt für eine bestimmte E-Mail Flagge zum Löschen
POP3_transporter.getBoxInfo()	Gibt Information über die E-Mail Inbox zurück
POP3_transporter.getMail()	Gibt eine spezifische E-Mail zurück
POP3_transporter.getMailInfoList( )	Gibt eine Collection mit Angaben zum E-Mail zurück
POP3_transporter.undeleteAll()	Entfernt von allen E-Mails Flagge zum Löschen
POP3_transporter.getMIMEAsBlob()	Gibt den MIME Inhalt einer spezifischen E-Mail in einem BLOB zurück

Hinweis: Die POP3 Verbindung wird automatisch geschlossen, wenn das Objekt transporter gelöscht wird.