4D Doc Center : MSG

4D Internet Commands v14

MSG_Extract


MSG_Extract ( nomFichier ; décoder ; cheminDocsJoints ; listePiècesJointes ) -> Résultat

Paramètre	Type	Description
nomFichier	Texte	Nom de fichier
décoder	Entier	0 = Pas de décodage, 1 = Décoder si possible
cheminDocsJoints	Texte	Chemin du dossier (chemin par défaut dans le dossier DocsJoints)
listePiècesJointes	Tableau chaîne	Noms des fichiers joints (sans chemins d'accès)
Résultat	Entier	Code d'erreur

Description

La commande MSG_Extract extrait tous les documents joints et les place dans le dossier des documents joints.

nomFichier désigne le nom ou le chemin d'accès complet du fichier duquel extraire les documents joints. Si vous passez un nom de fichier seul, le chemin d'accès par défaut sera celui du dossier défini par POP3_SetPrefs ou MSG_SetPrefs (voir Note de compatibilité). En l'absence de dossier spécifié, le chemin par défaut sera celui du dossier contenant le fichier de structure de la base de données (avec 4D monoposte) ou du dossier de 4D Client (avec 4D Server).

Le paramètre décoder spécifie si une tentative de décodage du ou des documents joints doit être effectuée. Si vous passez 0 (zéro), aucune tentative ne sera effectuée. Si vous passez 1, la commande décodera les fichiers, s'ils ont été encodés au moyen de l'une des méthodes suivantes : Binhex, AppleSingle, AppleDouble ou Base64.

Le paramètre cheminDocsJoints indique le chemin d'accès du dossier dans lequel enregistrer le document joint. Si vous passez une chaîne vide, le fichier est enregistré dans le dossier des documents joints spécifié par POP3_SetPrefs ou MSG_SetPrefs (voir Note de compatibilité). En l'absence de dossier spécifié, le fichier est enregistré dans le même dossier que celui du fichier de structure de la base de données.

Note de compatibilité (version 6.8.1) : Si la commande MSG_SetPrefs n’est pas utilisée, ce sont les paramètres dossierMsg et dossierDocsJoints de la commande POP3_SetPrefs qui seront pris en compte — si cette dernière a été préalablement exécutée. Si la commande MSG_SetPrefs est utilisée, les paramètres dossierMsg et dossierDocsJoints de la commande POP3_SetPrefs seront ignorés.

Le tableau alphanumérique/texte listePiècesJointes retourne les noms de tous les documents joints. Seul le nom du document est renvoyé dans l'élément du tableau, sans le chemin d'accès.