Office 365 Outlook

En vous connectant à Office 365 Outlook, vous pouvez afficher, envoyer, supprimer des messages électroniques et y répondre, en plus des autres tâches.

Vous pouvez ajouter des contrôles, notamment des boutons et des étiquettes pour exécuter ces fonctions dans votre application. Par exemple, vous pouvez ajouter dans votre application des zones d’entrée de texte qui demandent les informations requises pour un e-mail, y compris le destinataire, l’objet et le corps du message. Ensuite, vous ajoutez également un bouton Envoyer pour permettre l’envoi de l’e-mail.

Cette rubrique vous explique comment ajouter Office 365 Outlook en tant que connexion, ajouter Office 365 Outlook à votre application comme source de données et utiliser ces données dans différents contrôles.

Important : Actuellement, les fonctions de calendrier et de contacts ne sont pas prises en charge.

 

Ce dont vous avez besoin pour commencer

Se connecter à Office 365

  1. Ajoutez une connexion de données et sélectionnez Office 365 Outlook :

    Se connecter à Office 365

  2. Sélectionnez Se connecter. Si vous êtes invité à vous connecter, entrez votre compte professionnel.

La connexion Office 365 Outlook a été créée et ajoutée à votre application. Elle est prête à être utilisée.

Utiliser la connexion Office 365 Outlook dans votre application

Afficher un e-mail

  1. Dans le menu Insert (Insertion), sélectionnez Gallery (Galerie), puis ajoutez un contrôle Text gallery (Galerie de textes).

  2. Définissez sa propriété Items sur la formule suivante :

    Office365.GetEmails({fetchOnlyUnread:false})

    Le contrôle Gallery (Galerie) est automatiquement rempli avec quelques-uns de vos e-mails.

  3. Dans la galerie, définissez la propriété Text de la première étiquette sur ThisItem.From. Définissez la deuxième étiquette sur ThisItem.Subject. Définissez la troisième étiquette sur ThisItem.Body. Vous pouvez également redimensionner les étiquettes.

    Le contrôle Gallery (Galerie) est automatiquement rempli avec les nouvelles propriétés.

  4. Plusieurs paramètres facultatifs sont disponibles pour cette fonction. Définissez la propriété Items du contrôle Gallery (Galerie) sur l’une des formules suivantes :

    Office365.GetEmails({fetchOnlyUnread:false})
    Office365.GetEmails({fetchOnlyUnread:false, top:2})
    Office365.GetEmails({folderPath:"Sent Items", fetchOnlyUnread:false, top:2})
    Office365.GetEmails({folderPath:"Sent Items", fetchOnlyUnread:false, top:2, searchQuery:"powerapps"})
    Office365.GetEmails({folderPath:"Deleted Items", fetchOnlyUnread:false, top:2, skip:3})

Envoyer un e-mail

  1. Dans le menu Insérer, sélectionnez Texte, puis Saisie de texte. Effectuez cette opération trois fois pour créer trois contrôles Text input (Entrée de texte) différents. Disposez-les en colonne :

  2. Renommez-les :

    • inputTo
    • inputSubject
    • inputBody
  3. Dans le menu Insert (Insertion), sélectionnez Controls (Contrôles), puis Button (Bouton). Définissez sa propriété OnSelect sur la formule suivante :

    Office365.SendEmail(inputTo.Text, inputSubject.Text, inputBody.Text)

  4. Déplacez le bouton afin qu’il soit affiché sous tous les autres contrôles et définissez sa propriété Text sur "Envoyer l’e-mail".

  5. Appuyez sur F5 ou sélectionnez le bouton d’aperçu ( ). Tapez une adresse e-mail valide dans inputTo, puis saisissez ce que vous voulez dans les deux autres contrôles Text input (Entrée de texte).

  6. Sélectionnez Envoyer l’e-mail pour envoyer le message. Appuyez sur Échap pour revenir à l’espace de travail par défaut.

Supprimer un e-mail

  1. Dans le menu Insert (Insertion), sélectionnez Gallery (Galerie), puis ajoutez un contrôle Text gallery (Galerie de textes).

  2. Définissez sa propriété Items sur la formule suivante :

    Office365.GetEmails({fetchOnlyUnread:false})

    Le contrôle Gallery (Galerie) est automatiquement rempli avec quelques-uns de vos e-mails.

  3. Dans la galerie, définissez la propriété Text de la première étiquette sur ThisItem.Id. Définissez la deuxième étiquette sur ThisItem.Subject. Définissez la troisième étiquette sur ThisItem.Body.

  4. Sélectionnez la première étiquette dans la galerie et renommez-la EmailID :

    Fermer le volet Options

  5. Sélectionnez la troisième étiquette dans la galerie, puis ajoutez un contrôle Button (menu Insérer). Définissez la propriété OnSelect du bouton sur la formule suivante :

    Office365.DeleteEmail(EmailID.Text)

  6. Appuyez sur F5 ou sélectionnez le bouton d’aperçu ( ). Dans la galerie, sélectionnez un e-mail, puis cliquez sur le bouton.

    REMARQUE Cette opération entraîne la suppression de l’e-mail sélectionné de votre boîte de réception. Faites donc bien attention lors de la sélection.

  7. Appuyez sur Échap pour revenir à l’espace de travail par défaut.

Marquer un e-mail comme lu

Cette section utilise les mêmes contrôles que l’opération Supprimer un e-mail.

  1. Définissez la propriété OnSelect du bouton sur la formule suivante :

    Office365.MarkAsRead(EmailID.Text)

  2. Appuyez sur F5 ou sélectionnez le bouton d’aperçu ( ). Sélectionnez un des e-mails non lus, puis cliquez sur le bouton.

  3. Appuyez sur Échap pour revenir à l’espace de travail par défaut.

Afficher les fonctions disponibles

Cette connexion comprend les fonctions suivantes :

Nom de la fonction Description
GetEmails Récupère des e-mails dans un dossier
SendEmail Envoie un message électronique
DeleteEmail Supprime un message électronique d’après l’ID du message
MarkAsRead Marque un message électronique comme ayant été lu
ReplyTo Permet de répondre à un message électronique
GetAttachment Récupère une pièce jointe d’un message d’après son ID
OnNewEmail Déclenche un flux lorsqu’un nouvel e-mail arrive
SendMailWithOptions Envoyer un e-mail avec plusieurs options et attendre que le destinataire réponde avec l’une des options.
SendApprovalMail Envoyer un e-mail d’approbation et attendre une réponse de la part du destinataire.

GetEmails

Obtenir des e-mails : récupère des e-mails dans un dossier

Propriétés d’entrée

Nom Type de données Obligatoire Description
folderPath chaîne non Chemin d’accès du dossier dans lequel récupérer des messages (valeur par défaut : Inbox)
top entier non Nombre d’e-mails à récupérer (valeur par défaut : 10)
fetchOnlyUnread valeur booléenne non Récupérer uniquement les messages non lus ? (valeur par défaut : true)
includeAttachments valeur booléenne non Si cette propriété est définie sur true, les pièces jointes seront récupérées en même temps que les messages électroniques. (valeur par défaut : false)
searchQuery chaîne non Requête de recherche pour filtrer les e-mails
skip entier non Nombre d’e-mails à ignorer (valeur par défaut : 0)
skipToken chaîne non Jeton d’évitement pour récupérer une nouvelle page

Propriétés de sortie

Nom de la propriété Type de données Obligatoire Description
value tableau oui Recevoir des messages électroniques pouvant inclure les propriétés suivantes :
  • From (facultatif)
  • To (requis)
  • Subject (requis)
  • Body (requis)
  • Importance (facultatif) : "Low", "Normal" ou "High"
  • HasAttachment (facultatif)
  • Id (facultatif)
  • IsRead (facultatif)
  • DateTimeReceived (facultatif)
  • Attachments (facultatifs) : recevoir une pièce jointe. Les propriétés des pièces jointes incluent Id (requis), ContentType (requis), Name (requis), ContentBytes (requis).
  • Cc (facultatif)
  • Bcc (facultatif)
  • IsHtml (facultatif)

SendEmail

Envoyer un e-mail : envoie un message électronique

Propriétés d’entrée

Nom Type de données Obligatoire Description
emailMessage oui Instance de message électronique pouvant inclure les propriétés suivantes :
  • Attachment (facultatif) : envoyer une pièce jointe. Les propriétés des pièces jointes incluent Name (requis) et ContentBytes (requis).
  • From (facultatif)
  • Cc (facultatif)
  • Bcc (facultatif)
  • Subject (requis)
  • Body (requis)
  • Importance (facultatif) : "Low", "Normal" ou "High"
  • IsHtml (facultatif) : entrer la valeur true ou false.
  • To (requis) : séparer les adresses e-mail par une virgule.

Propriétés de sortie

Aucune.

DeleteEmail

Supprimer un e-mail : supprime un message électronique d’après son ID

Propriétés d’entrée

Nom Type de données Obligatoire Description
messageId chaîne oui ID du message à supprimer.

Propriétés de sortie

Aucune.

MarkAsRead

Marquer comme lu : marque un message électronique comme ayant été lu

Propriétés d’entrée

Nom Type de données Obligatoire Description
messageId chaîne oui ID du message à marquer comme lu

Propriétés de sortie

Aucune.

ReplyTo

Répondre au message : permet de répondre à un message électronique

Propriétés d’entrée

Nom Type de données Obligatoire Description
messageId chaîne oui ID du message auquel répondre
comment chaîne oui Commentaire de réponse
replyAll valeur booléenne non Répondre à tous les destinataires

Propriétés de sortie

Aucune.

GetAttachment

Obtenir une pièce jointe : récupère une pièce jointe d’un message d’après son ID

Propriétés d’entrée

Nom Type de données Obligatoire Description
messageId chaîne oui ID du message
attachmentId chaîne oui ID de la pièce jointe à télécharger

Propriétés de sortie

Aucune.

OnNewEmail

À l’arrivée d’un nouvel e-mail : déclenche un flux lorsqu’un nouvel e-mail arrive

Propriétés d’entrée

Nom Type de données Obligatoire Description
folderPath chaîne non Dossier d’e-mails à récupérer (valeur par défaut : Inbox, Inbox\ToMe, etc.)
De à chaîne non Adresses e-mail des destinataires
from chaîne non Adresse de l’expéditeur
importance chaîne non Importance de l’e-mail (High, Normal, Low) (valeur par défaut : Normal)
fetchOnlyWithAttachment valeur booléenne non Récupérer uniquement les e-mails qui contiennent une pièce jointe
includeAttachments valeur booléenne non Inclure des pièces jointes
subjectFilter chaîne non Chaîne à rechercher dans l’objet.

Propriétés de sortie

Nom de la propriété Type de données Obligatoire Description
value tableau Non

SendMailWithOptions

Envoyer un e-mail avec des options : envoyer un e-mail avec plusieurs options et attendre que le destinataire réponde avec l’une des options.

Propriétés d’entrée

Nom Type de données Obligatoire Description
optionsEmailSubscription oui Demande d’abonnement pour les options de l’e-mail, notamment :
  • NotificationUrl (facultatif)
  • Message (facultatif)

Propriétés de sortie

Nom de la propriété Type de données Obligatoire Description
id chaîne Non
resource chaîne Non
notificationType chaîne Non
notificationUrl chaîne Non

SendApprovalMail

Envoyer un e-mail d’approbation : envoyer un e-mail d’approbation et attendre une réponse de la part du destinataire.

Propriétés d’entrée

Nom Type de données Obligatoire Description
approvalEmailSubscription oui Demande d’abonnement pour l’e-mail d’approbation, notamment :
  • NotificationUrl (facultatif)
  • Message (facultatif)

Propriétés de sortie

Nom de la propriété Type de données Obligatoire Description
id chaîne Non
resource chaîne Non
notificationType chaîne Non
notificationUrl chaîne Non

Liens utiles