version 6.8.1 (Modifiée)
MSG_Extract (nomFichier; décoder; cheminDocsJoints; listePiècesJointes) Entier
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 | Tab Alpha | Txt | 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.
Référence