Se connecter à Office 365 Outlook à partir de PowerAppsConnect to Office 365 Outlook from PowerApps

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.If you connect to Office 365 Outlook, you can show, send, delete, and reply to email messages, in addition to other tasks.

Vous pouvez ajouter des contrôles pour exécuter ces fonctions dans votre application.You can add controls to perform these functions in your app. Par exemple, vous pouvez ajouter des contrôles Entrée de texte pour demander le destinataire, l’objet et le corps du courrier, puis ajouter un contrôle Bouton pour envoyer le courrier.For example, you can add Text input controls to ask for the recipient, the subject, and the body of the email, and add a Button control to send the email.

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.This topic shows you how to add Office 365 Outlook as a connection, add Office 365 Outlook as a data source to your app, and use this data in different controls.

Important : au moment de la rédaction de cet article, l’opération de calendrier ne prend pas en charge les événements périodiques.Important: As of this writing, the calendar operation doesn't support recurring events.

 

What you need to get started

Se connecter à Office 365 OutlookConnect to Office 365 Outlook

  1. Ajoutez une connexion de données et sélectionnez Office 365 Outlook :Add a data connection and select Office 365 Outlook:

    Se connecter à Office 365

  2. Sélectionnez Se connecter. Si vous êtes invité à vous connecter, entrez votre compte professionnel.Select Connect, and if prompted to sign in, enter your work account.

La connexion Office 365 Outlook a été créée et ajoutée à votre application.The Office 365 Outlook connection has been created and added to your app. Elle est prête à être utilisée.Now, it's ready to be used.

Afficher des messagesShow messages

  1. Dans le menu Insert (Insertion), sélectionnez Gallery (Galerie), puis ajoutez un contrôle Text gallery (Galerie de textes).On the Insert menu, select Gallery, and then select a Text gallery control.
  2. Définissez sa propriété Items sur la formule suivante :Set its Items property to the following formula:

    Office365.GetEmails({fetchOnlyUnread:false})

    Le contrôle Gallery (Galerie) est automatiquement rempli avec quelques-uns de vos e-mails.The gallery control is automatically populated with some of your emails.

  3. Dans la galerie, définissez la propriété Text de la première étiquette sur ThisItem.From.In the gallery, set the Text property of the first label to ThisItem.From. Définissez la deuxième étiquette sur ThisItem.Subject.Set the second label to ThisItem.Subject. Définissez la troisième étiquette sur ThisItem.Body.Set the third label to ThisItem.Body. Vous pouvez également redimensionner les étiquettes.You can also resize the labels.

    Le contrôle Gallery (Galerie) est automatiquement rempli avec les nouvelles propriétés.The gallery control is automatically populated with the new properties.

  4. Plusieurs paramètres facultatifs sont disponibles pour cette fonction.This function has several optional parameters available. Définissez la propriété Items du contrôle Gallery (Galerie) sur l’une des formules suivantes :Set the gallery's Items property to one of the following formulas:

    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 messageSend a message

  1. Dans le menu Insérer, sélectionnez Texte, puis Saisie de texte.On the Insert menu, select Text, and then select Text input.
  2. Répétez l’étape précédente encore deux fois afin que vous ayez trois zones, puis réorganisez-les dans une colonne :Repeat the previous step two more times so that you have three boxes, and then arrange them in a column:

  3. Renommez les contrôles comme suit :Rename the controls to:

    • inputToinputTo
    • inputSubjectinputSubject
    • inputBodyinputBody
  4. Dans le menu Insert (Insertion), sélectionnez Controls (Contrôles), puis Button (Bouton).On the Insert menu, select Controls, and then select Button. Définissez sa propriété OnSelect sur la formule suivante :Set its OnSelect property to the following formula:

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

  5. 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".Move the button so that it appears under all the other controls, and set its Text property to "Send email".
  6. Appuyez sur F5 ou sélectionnez le bouton d’aperçu ().Press F5, or select the Preview button (). 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).Type in a valid email address in inputTo, and type whatever you want in the other two Text input controls.
  7. Sélectionnez Envoyer l’e-mail pour envoyer le message.Select Send email to send the message. Appuyez sur Échap pour revenir à l’espace de travail par défaut.Press Esc to return to the default workspace.

Envoyer un message avec une pièce jointeSend a message with an attachment

Vous pouvez, par exemple, créer une application dans laquelle l’utilisateur prend des images à l’aide de l’appareil photo de l’appareil et les envoie en tant que pièces jointes.You can, for example, create an app in which the user takes pictures by using the device's camera and then sends them as attachments. Les utilisateurs peuvent également joindre de nombreux autres types de fichier à une application de courrier.Users can also attach many other kinds of files to an email app.

Pour ajouter une pièce jointe à un message, suivez les étapes décrites dans la section précédente, mais en ajoutant un paramètre pour spécifier une pièce jointe (lorsque vous définissez la propriété OnSelect (À la sélection) du bouton).To add an attachment to a message, follow the steps in the previous section, but add a parameter to specify an attachment (when you set the OnSelect property of the button). Ce paramètre est structuré en tant que table dans laquelle vous spécifiez jusqu’à trois propriétés pour chaque pièce jointe :This parameter is structured as a table in which you specify up to three properties for each attachment:

  • NomName
  • ContentBytesContentBytes
  • @odata.type

Remarque : vous pouvez spécifier la propriété @odata.type pour une seule pièce jointe et vous pouvez la définir sur une chaîne vide.Note: You can specify the @odata.type property for only one attachment, and you can set it to an empty string.

Dans cet exemple, une photo est envoyée en tant que file1.jpg :In this example, a photo will be sent as file1.jpg:

Office365.SendEmail(inputTo.Text, inputSubject.Text, inputBody.Text, {Attachments:Table({Name:"file1.jpg", ContentBytes:Camera1.Photo, '@odata.type':""})})

Dans cet exemple, un fichier audio est également envoyé en plus de la photo :In this example, an audio file will be sent in addition to the photo:

Office365.SendEmail(inputTo.Text, inputSubject.Text, inputBody.Text, {Attachments:Table({Name:"file1.jpg", ContentBytes:Camera1.Photo, '@odata.type':""}, {Name:"AudioFile", ContentBytes:microphone1.audio })})

Supprimer un messageDelete a message

  1. Dans le menu Insert (Insertion), sélectionnez Gallery (Galerie), puis ajoutez un contrôle Text gallery (Galerie de textes).On the Insert menu, select Gallery, and then select a Text gallery control.
  2. Définissez sa propriété Items sur la formule suivante :Set its Items property to the following formula:

    Office365.GetEmails({fetchOnlyUnread:false})

    Le contrôle Gallery (Galerie) est automatiquement rempli avec quelques-uns de vos e-mails.The gallery control is automatically populated with some of your emails.

  3. Dans la galerie, définissez la propriété Text de la première étiquette sur ThisItem.Id.In the gallery, set the Text property of the first label to ThisItem.Id. Définissez la deuxième étiquette sur ThisItem.Subject.Set the second label to ThisItem.Subject. Définissez la troisième étiquette sur ThisItem.Body.Set the third label to ThisItem.Body.
  4. Sélectionnez la première étiquette dans la galerie et renommez-la EmailID :Select the first label in the gallery, and rename it to EmailID:

    Fermer le volet Options

  5. Sélectionnez la troisième étiquette dans la galerie, puis ajoutez un contrôle Button (menu Insérer).Select the third label in the gallery, and add a Button (Insert menu). Définissez la propriété OnSelect du bouton sur la formule suivante :Set the button's OnSelect property to the following formula:

    Office365.DeleteEmail(EmailID.Text)

  6. Appuyez sur F5 ou sélectionnez le bouton d’aperçu ().Press F5, or select the Preview button (). Dans la galerie, sélectionnez un e-mail, puis cliquez sur le bouton.Select one of the emails in your gallery, and click the button.

    REMARQUE Cette opération entraîne la suppression de l’e-mail sélectionné de votre boîte de réception.NOTE This deletes the selected email from your inbox. Faites donc bien attention lors de la sélection.So, choose wisely.
  7. Appuyez sur Échap pour revenir à l’espace de travail par défaut.Press Esc to return to the default workspace.

Marquer un message comme luMark a message as read

Cette section utilise les mêmes contrôles que l’opération Supprimer un e-mail.This section uses the same controls as Delete email.

  1. Définissez la propriété OnSelect du bouton sur la formule suivante :Set the button's OnSelect property to the following formula:

    Office365.MarkAsRead(EmailID.Text)

  2. Appuyez sur F5 ou cliquez sur le bouton d’aperçu ().Press F5, or select the Preview button (). Sélectionnez un des messages non lus, puis cliquez sur le bouton.Select one of the unread emails, and then click the button.
  3. Appuyez sur Échap pour revenir à l’espace de travail par défaut.Press Esc to return to the default workspace.