IMAP New transporter
Historique
| Release | Modifications |
|---|---|
| 18 R4 | Ajout |
IMAP New transporter( server : Object ) : 4D.IMAPTransporter
| Paramètres | Type | Description | |
|---|---|---|---|
| server | Object | → | Informations sur le serveur IMAP |
| Résultat | 4D.IMAPTransporter | ← | IMAP transporter object |
Description
La commande IMAP New transporterconfigure une nouvelle connexion IMAP en fonction du paramètre server et retourne un nouvel objet transporter. L'objet transporteur retourné sera alors utilisé pour la réception d'emails.
Dans le paramètre server, passez un objet contenant les propriétés suivantes :
| server | Valeur par défaut (si omise) |
|---|---|
| .acceptUnsecureConnection : Boolean True si 4D est autorisé à établir une connexion non chiffrée | False |
| .accessTokenOAuth2 : Text .accessTokenOAuth2 : Object Chaîne ou objet token représentant les informations d'autorisation OAuth2. Utilisé uniquement avec OAUTH2 authenticationMode. Si accessTokenOAuth2 est utilisé mais que authenticationMode est omis, le protocole OAuth 2 est utilisé (si le serveur l'autorise). Not returned in IMAP transporter object. | aucun |
| .authenticationMode : Text le mode d'authentification utilisé pour ouvrir la session sur le serveur de messagerie | le mode d'authentification le plus sûr pris en charge par le serveur est utilisé |
| .checkConnectionDelay : Integer la durée maximale (en secondes) autorisée avant vérification de la connexion au serveur | 300 |
| .connectionTimeOut : Integer le temps d'attente maximum (en secondes) autorisé pour établir une connexion avec le serveur | 30 |
| .host : Text le nom ou l'adresse IP du serveur hôte | obligatoire |
| .logFile : Text le chemin du fichier journal étendu défini (le cas échéant) pour la connexion de messagerie | aucun |
| .password : Text Mot de passe utilisateur pour l'authentification sur le serveur. Non retourné en objet IMAP transporter. | aucun |
| .port : Integer le numéro de port utilisé pour les transactions de courrier | 993 |
| .user : Text le nom d'utilisateur utilisé pour l'authentification sur le serveur de messagerie | aucun |
Attention : Assurez-vous que le timeout défini est inférieur au timeout du serveur, sinon le timeout du client sera inutile.
Résultat
The function returns an IMAP transporter object. Toutes les propriétés retournées sont en lecture seule.
La connexion IMAP est automatiquement fermée lorsque l'objet transporteur est détruit.
Exemple
$server:=New object
$server.host:="imap.gmail.com" //Obligatoire
$server.port:=993
$server.user:="4d@gmail.com"
$server.password:="XXXXXXXX"
$server.logFile:="LogTest.txt" //log à sauvegarder dans le dossier Logs
var $transporter : 4D.IMAPTransporter
$transporter:=IMAP New transporter($server)
$status:=$transporter.checkConnection()
If(Not($status.success))
ALERT("An error occurred: "+$status.statusText)
End if