Transporter Class
Description
.acceptUnsecureConnection
Historique
| Release | Modifications |
|---|---|
| 17 R4 | Ajout |
.acceptUnsecureConnection : Boolean
Description
La propriété .acceptUnsecureConnection contient True si 4D est autorisé à établir une connexion non chiffrée lorsqu'une connexion chiffrée n'est pas possible.
Elle contient False si les connexions non chiffrées ne sont pas autorisées, auquel cas une erreur est retournée lorsque la connexion chiffrée n'est pas possible.
Ports sécurisés disponibles :
-
SMTP
- 465: SMTPS
- 587 ou 25 : SMTP avec mise à niveau STARTTLS si le serveur le prend en charge.
-
IMAP
- 143 : Port IMAP non chiffré
- 993 : IMAP avec mise à niveau STARTTLS si le serveur le prend en charge
-
POP3
- 110 : Port POP3 non chiffré
- 995 : POP3 avec mise à niveau STARTTLS si le serveur le prend en charge.
.authenticationMode
Historique
| Release | Modifications |
|---|---|
| 17 R4 | Ajout |
.authenticationMode : Text
Description
La propriété .authenticationMode contient le mode d'authentification utilisé pour ouvrir la session sur le serveur de messagerie.
Par défaut, le mode le plus sécurisé pris en charge par le serveur est utilisé.
Valeurs possibles :
| Valeur | Constantes | Commentaire |
|---|---|---|
| CRAM-MD5 | IMAP authentication CRAM MD5 | Authentification à l'aide du protocole CRAM-MD5 |
| LOGIN | IMAP authentication login | Authentification à l'aide du protocole LOGIN |
| OAUTH2 | IMAP authentication OAUTH2 | Authentification à l'aide du protocole OAuth2 |
| PLAIN | IMAP authentication plain | Authentification à l'aide du protocole PLAIN |
.authenticationMode
Historique
| Release | Modifications |
|---|---|
| 17 R4 | Ajout |
.authenticationMode : Text
Description
La propriété .authenticationMode contient le mode d'authentification utilisé pour ouvrir la session sur le serveur de messagerie.
Par défaut, le mode le plus sécurisé pris en charge par le serveur est utilisé.
Valeurs possibles :
| Valeur | Constantes | Commentaire |
|---|---|---|
| APOP | POP3 authentication APOP | Authentification à l'aide du protocole APOP (POP3 uniquement) |
| CRAM-MD5 | POP3 authentication CRAM MD5 | Authentification à l'aide du protocole CRAM-MD5 |
| LOGIN | POP3 authentication login | Authentification à l'aide du protocole LOGIN |
| OAUTH2 | POP3 authentication OAUTH2 | Authentification à l'aide du protocole OAuth2 |
| PLAIN | POP3 authentication plain | Authentification à l'aide du protocole PLAIN |
.authenticationMode
Historique
| Release | Modifications |
|---|---|
| 17 R4 | Ajout |
.authenticationMode : Text
Description
La propriété .authenticationMode contient le mode d'authentification utilisé pour ouvrir la session sur le serveur de messagerie.
Par défaut, le mode le plus sécurisé pris en charge par le serveur est utilisé.
Valeurs possibles :
| Valeur | Constantes | Commentaire |
|---|---|---|
| CRAM-MD5 | SMTP authentication CRAM MD5 | Authentification à l'aide du protocole CRAM-MD5 |
| LOGIN | SMTP authentication login | Authentification à l'aide du protocole LOGIN |
| OAUTH2 | SMTP authentication OAUTH2 | Authentification à l'aide du protocole OAuth2 |
| PLAIN | SMTP authentication plain | Authentification à l'aide du protocole PLAIN |
.bodyCharset
Historique
| Release | Modifications |
|---|---|
| 18 | Prise en charge de UTF8 base64 |
| 17 R5 | Ajout |
.bodyCharset : Text
Description
La propriété .bodyCharset contient le charset et l'encodage utilisés pour la partie body de l'email.
Valeurs possibles :
| Constante | Valeur | Commentaire |
|---|---|---|
| mail mode ISO2022JP | US-ASCII_ISO-2022-JP_UTF8_QP |
|
| mail mode ISO88591 | ISO-8859-1 |
|
| mail mode UTF8 | US-ASCII_UTF8_QP | headerCharset & bodyCharset : US-ASCII si possible, sinon UTF-8 & Quoted-printable (valeur par défaut) |
| mail mode UTF8 in base64 | US-ASCII_UTF8_B64 | headerCharset &bodyCharset : US-ASCII si possible, sinon UTF-8 & base64 |
.connectionTimeOut
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.connectionTimeOut : Integer
Description
La propriété .connectionTimeOut contient le temps d'attente maximum (en secondes) autorisé pour établir une connexion avec le serveur. Par défaut, si la propriété n'a pas été définie dans l'objet server (utilisé pour créer l'objet transporteur avec SMTP New transporter, POP3 New transporter, IMAP New transporter), la valeur utilisée est 30.
.headerCharset
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.headerCharset : Text
Description
La propriété .headerCharset contient le jeu de caractères et l'encodage utilisés pour l'en-tête de l'e-mail. L'en-tête comprend les éléments suivants de l'e-mail :
- subject,
- attachment filename(s),
- email name.
Valeurs possibles :
| Constante | Valeur | Commentaire |
|---|---|---|
| mail mode ISO2022JP | US-ASCII_ISO-2022-JP_UTF8_QP |
|
| mail mode ISO88591 | ISO-8859-1 |
|
| mail mode UTF8 | US-ASCII_UTF8_QP | headerCharset & bodyCharset : US-ASCII si possible, sinon UTF-8 & Quoted-printable (valeur par défaut) |
| mail mode UTF8 in base64 | US-ASCII_UTF8_B64 | headerCharset &bodyCharset : US-ASCII si possible, sinon UTF-8 & base64 |
.host
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.host : Text
Description
La propriété .host contient le nom ou l'adresse IP du serveur hôte. Utilisée pour les échanges de courrier (SMTP, POP3, IMAP).
.logFile
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Ajout |
.logFile : Text
Description
La propriété .logFile contient le chemin du fichier journal étendu défini (le cas échéant) pour la connexion de messagerie. Le chemin peut être relatif (au dossier Logs courant) ou absolu.
Contrairement aux fichiers log habituels (activés via la commande SET DATABASE PARAMETER), les fichiers log étendus stockent le contenu MIME de tous les emails envoyés et n'ont pas de limite de taille. Pour plus d'informations sur les fichiers log étendus, reportez-vous à :
- Connexions SMTP - 4DSMTPLog.txt
- Connexions POP3 - 4DPOP3Log.txt
- Connexions IMAP - 4DIMAPLog.txt
.port
Historique
| Release | Modifications |
|---|---|
| 17 R4 | Ajout |
.port : Integer
Description
La propriété .port contient le numéro de port utilisé pour les transactions de courrier. Par défaut, si la propriété port n'a pas été définie dans l'objet server (utilisé pour créer l'objet transporteur avec SMTP New transporter, POP3 New transporter, IMAP New transporter), le port utilisé est :
- SMTP - 587
- POP3 - 995
- IMAP - 993
.sendTimeOut
Historique
| Release | Modifications |
|---|---|
| 17 R4 | Ajout |
.sendTimeOut : Integer
Description
La propriété .sendTimeOut contient le temps d'attente maximum (en secondes) d'un appel à .send() avant le timeout. Par défaut, si la propriété .sendTimeOut n'a pas été définie dans l'objet server, la valeur 100 est utilisée.
.user
Historique
| Release | Modifications |
|---|---|
| 17 R4 | Ajout |
.user : Text
Description
La propriété .user contient le nom d'utilisateur utilisé pour l'authentification sur le serveur de messagerie.
.checkConnection()
Historique
| Release | Modifications |
|---|---|
| 17 R4 | Ajout |
.checkConnection() : Object
| Paramètres | Type | Description | |
|---|---|---|---|
| Résultat | Object | <- | Statut de la connexion de l'objet transporteur |
Description
La fonction .checkConnection() vérifie la connexion en utilisant les informations stockées dans l'objet transporteur, recrée la connexion si nécessaire et renvoie le statut. Cette fonction vous permet de vérifier que les valeurs fournies par l'utilisateur sont valides et cohérentes.
Objet retourné
La fonction envoie une requête au serveur de mail et retourne un objet décrivant le statut. Cet objet peut avoir les propriétés suivantes :
| Propriété | Type | Description | |
|---|---|---|---|
| success | boolean | Vrai si la vérification a été effectuée avec succès, sinon Faux | |
| status | number | (SMTP uniquement) Code du statut retourné par le serveur de messagerie (0 en cas de problème non lié au traitement du mail) | |
| statusText | text | Message du statut retourné par le serveur de messagerie, ou dernière erreur retournée dans la pile d'erreurs 4D | |
| errors | collection | Pile d'erreurs 4D (non retournée si une réponse du serveur de messagerie est reçue) | |
| [ ].errCode | number | Code d'erreur 4D | |
| [ ].message | text | Description de l'erreur 4D | |
| [ ].componentSignature | text | Signature du composant interne qui a retourné l'erreur |