Pièces jointes

Joindre des fichiers à un message, depuis le disque ou depuis la mémoire. Les fichiers sont chiffrés et envoyés avec le message ; le destinataire les télécharge depuis la page du message.

Prérequis

Un envoi qui fonctionne déjà sans pièce jointe : voir Envoyer un message.

Depuis le disque

Passez la liste des chemins des fichiers.

var args = new MutliRecipientArgs(
    endPointUri: endpoint, serial: serial, user: apiUser, psw: apiPassword,
    recipients: recipients, message: message, subject: subject,
    password: null, filesList: null,
    sendMode: SendMethodEnum.onlyEmail, getBackHtml: false,
    showSubject: true, getNotify: true, cultureID: "fr-CA",
    maximumOpenTime: 5, minutesExpiration: 10080);

args.FilesPath = new List<string> { cheminContrat, cheminAnnexe };

var response = MessageHelper.MultiRecipientMessage(args);

answer = MessageHelper.multi_recipient_message(
    api_client=client, sems_client=sems_client,
    serial=serial, api_user=api_user, api_password=api_password,
    recipients=recipients, message=message, subject=subject,
    files_path=[chemin_contrat, chemin_annexe],
    get_back_html=False, culture_id="fr-CA",
)

$answer = MessageHelper::multiRecipientMessage(
    apiClient: $client, semsClient: $sems,
    serial: $serial, apiUser: $apiUser, apiPassword: $apiPassword,
    recipients: $recipients, message: $message, subject: $subject,
    filesPath: [$cheminContrat, $cheminAnnexe],
    getBackHtml: false, cultureId: 'fr-CA',
);

Depuis la mémoire

Pour un fichier produit par votre application (un rapport généré, par exemple), passez son contenu et son nom sans passer par le disque.

var fichiers = new List<FileArgs>
{
    new FileArgs(rapportPdf, "rapport.pdf", "application/pdf")
};

var args = new MutliRecipientArgs(
    endPointUri: endpoint, serial: serial, user: apiUser, psw: apiPassword,
    recipients: recipients, message: message, subject: subject,
    password: null, filesList: fichiers,
    sendMode: SendMethodEnum.onlyEmail, getBackHtml: false,
    showSubject: true, getNotify: true, cultureID: "fr-CA",
    maximumOpenTime: 5, minutesExpiration: 10080);

from secure_exchanges_sdk.models.file_args import FileArgs

answer = MessageHelper.multi_recipient_message(
    api_client=client, sems_client=sems_client,
    serial=serial, api_user=api_user, api_password=api_password,
    recipients=recipients, message=message, subject=subject,
    files_list=[FileArgs(binary=rapport_pdf, file_name="rapport.pdf", mime_type="application/pdf")],
    get_back_html=False, culture_id="fr-CA",
)

$answer = MessageHelper::multiRecipientMessage(
    apiClient: $client, semsClient: $sems,
    serial: $serial, apiUser: $apiUser, apiPassword: $apiPassword,
    recipients: $recipients, message: $message, subject: $subject,
    filesList: [
        ['binary' => $rapportPdf, 'file_name' => 'rapport.pdf'],
    ],
    getBackHtml: false, cultureId: 'fr-CA',
);

À savoir

Point	Détail
Taille	Jusqu'à 25 Go par envoi.
Nombre de fichiers	Pas de limite propre, dans la limite de taille.
Disque ou mémoire	Les deux façons s'utilisent dans le même envoi. Pour un fichier volumineux, voir Gros fichiers.
Type MIME	En .NET et en Python, `FileArgs` demande le type du fichier : voir le tableau ci-dessous.

Extension	Type MIME
`.pdf`	`application/pdf`
`.docx`	`application/vnd.openxmlformats-officedocument.wordprocessingml.document`
`.xlsx`	`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`
`.png`	`image/png`
`.jpg`	`image/jpeg`
`.zip`	`application/zip`
`.txt`	`text/plain`

Attention

Sécurité.

Chemins : n'utilisez jamais tel quel un chemin fourni par un utilisateur. Limitez les envois à un dossier connu et vérifiez le chemin final, sinon n'importe quel fichier du serveur pourrait être envoyé.
Contenu du message : si le message HTML contient des données saisies par quelqu'un (un nom, un nom de fichier), encodez-les pour le HTML avant de les insérer.

Erreurs fréquentes

Symptôme	Cause probable	Solution
Fichier introuvable	Chemin relatif au mauvais dossier, ou droits de lecture manquants	Utilisez un chemin absolu et vérifiez que le compte de service peut lire le fichier.
Statut 400	Taille totale dépassée	Réduisez la taille ou répartissez les fichiers sur plusieurs envois.
Le destinataire ne voit pas le fichier	Envoi en échec pour ce destinataire	Vérifiez son statut dans la réponse : voir Plusieurs destinataires.

Et ensuite

Gros fichiers
Signature numérique : faire signer un PDF
Télécharger les fichiers reçus

Table of Contents