Office 365 Outlook

Wenn Sie eine Verbindung mit Office 365 Outlook herstellen, können Sie E-Mail-Nachrichten anzeigen, senden, löschen und beantworten sowie weitere Aufgaben ausführen.

Sie können Steuerelemente wie Schaltflächen und Bezeichnungen für diese Funktionen in Ihrer App hinzufügen. So können Sie z.B. Eingabefelder in Ihre App einbinden, um E-Mail-Informationen abzufragen, u.a. Empfänger, Betreff und Text der E-Mail. Fügen Sie dann die Schaltfläche „Senden“ hinzu, um die E-Mail zu senden.

In diesem Thema wird gezeigt, wie Sie Office 365 als Verbindung hinzufügen, Office 365 Ihrer App als Datenquelle hinzufügen und wie Sie die Daten in verschiedenen Steuerelementen verwenden.

Wichtig: Zum Zeitpunkt der Veröffentlichung dieses Artikels werden die Funktionen für Kalender und Kontakte nicht unterstützt.

 

Das benötigen Sie, um anzufangen

Herstellen einer Verbindung mit Office 365

  1. Fügen Sie eine Datenverbindung hinzu, und wählen Sie Office 365 Outlook aus:

    Herstellen einer Verbindung mit Office 365

  2. Wählen Sie Verbinden aus, und wenn Sie aufgefordert werden, sich anzumelden, geben Sie Ihr Geschäftskonto ein.

Die Verbindung mit Office 365 Outlook wurde erstellt und Ihrer App hinzugefügt. Sie kann jetzt verwendet werden.

Verwenden der Office 365 Outlook-Verbindung in Ihrer App

Anzeigen von E-Mails

  1. Wählen Sie im Menü Einfügen die Option Katalog aus, und fügen Sie einen der Textkataloge hinzu.

  2. Legen Sie die Items-Eigenschaft auf den folgenden Ausdruck fest:

    Office365.GetEmails({fetchOnlyUnread:false})

    Das Katalog-Steuerelement wird automatisch mit einigen Ihrer E-Mails aufgefüllt.

  3. Legen Sie im Katalog die Text-Eigenschaft der ersten Bezeichnung auf ThisItem.From fest. Legen Sie die zweite Bezeichnung auf ThisItem.Subject fest. Legen Sie die dritte Bezeichnung auf ThisItem.Body fest. Sie können auch die Größe der Bezeichnungen ändern.

    Das Katalog-Steuerelement wird automatisch mit den neuen Eigenschaften aktualisiert.

  4. Für diese Funktion sind verschiedene optionale Parameter verfügbar. Legen Sie die Items-Eigenschaft des Katalogs auf eine der folgenden Formeln fest:

    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})

Senden von E-Mails

  1. Klicken Sie im Menü Insert (Einfügen) auf Text, und wählen Sie dann Texteingabe (Texteingabe) aus. Wiederholen Sie dies dreimal, um drei verschiedene Texteingabe-Steuerelemente zu erstellen. Ordnen Sie sie in einer Spalte an:

  2. Benennen Sie sie wie folgt um:

    • inputTo
    • inputSubject
    • inputBody
  3. Wählen Sie im Menü Einfügen die Option Steuerelemente und anschließend Schaltfläche aus. Legen Sie die OnSelect-Eigenschaft auf die folgende Formel fest:

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

  4. Verschieben Sie die Schaltfläche, sodass sie unter den anderen Steuerelementen angezeigt wird, und legen Sie ihre Text-Eigenschaft auf "Send email" fest.

  5. Drücken Sie F5, oder wählen Sie die Vorschauschaltfläche aus ( ). Geben Sie eine gültige E-Mail-Adresse in inputTo ein, und geben Sie in den anderen beiden Texteingabe-Steuerelementen beliebigen Text ein.

  6. Wählen Sie end email aus, um die Nachricht zu senden. Drücken Sie ESC, um zum Standardarbeitsbereich zurückzukehren.

Löschen von E-Mails

  1. Wählen Sie im Menü Einfügen die Option Katalog aus, und fügen Sie einen der Textkataloge hinzu.

  2. Legen Sie die Items-Eigenschaft auf den folgenden Ausdruck fest:

    Office365.GetEmails({fetchOnlyUnread:false})

    Das Katalog-Steuerelement wird automatisch mit einigen Ihrer E-Mails aufgefüllt.

  3. Legen Sie im Katalog die Text-Eigenschaft der ersten Bezeichnung auf ThisItem.Id fest. Legen Sie die zweite Bezeichnung auf ThisItem.Subject fest. Legen Sie die dritte Bezeichnung auf ThisItem.Body fest.

  4. Wählen Sie die erste Bezeichnung im Katalog aus, und benennen Sie sie in EmailID um:

    Schließen Sie den Bereich „Optionen“.

  5. Wählen Sie die dritte Bezeichnung im Katalog aus, und fügen Sie eine Schaltfläche hinzu (Menü Einfügen). Legen Sie die OnSelect-Eigenschaft der Schaltfläche auf die folgende Formel fest:

    Office365.DeleteEmail(EmailID.Text)

  6. Drücken Sie F5, oder wählen Sie die Vorschauschaltfläche aus ( ). Wählen Sie eine der E-Mails in Ihrem Katalog aus, und klicken Sie auf die Schaltfläche.

    HINWEIS Hierdurch werden die ausgewählten E-Mails aus dem Posteingang gelöscht. Vergewissern Sie sich daher, dass Sie die richtigen E-Mails auswählen.

  7. Drücken Sie ESC, um zum Standardarbeitsbereich zurückzukehren.

Markieren von E-Mails als gelesen

In diesem Abschnitt werden die gleichen Steuerelemente verwendet wie unter Löschen von E-Mails.

  1. Legen Sie die OnSelect-Eigenschaft der Schaltfläche auf die folgende Formel fest:

    Office365.MarkAsRead(EmailID.Text)

  2. Drücken Sie F5, oder wählen Sie die Vorschauschaltfläche aus ( ). Wählen Sie eine der ungelesenen E-Mails aus, und klicken Sie auf die Schaltfläche.

  3. Drücken Sie ESC, um zum Standardarbeitsbereich zurückzukehren.

Anzeigen der verfügbaren Funktionen

Diese Verbindung umfasst die folgenden Funktionen:

Funktionsname Beschreibung
GetEmails Ruft E-Mail-Nachrichten aus einem Ordner ab
SendEmail Sendet eine E-Mail-Nachricht
DeleteEmail Löscht eine E-Mail-Nachricht anhand der Nachrichten-ID
MarkAsRead Markiert eine E-Mail-Nachricht als gelesen
ReplyTo-Element Beantwortet eine E-Mail-Nachricht
GetAttachment Ruft den Nachrichtenanhang nach ID ab
OnNewEmail Löst einen Flow aus, wenn eine neue E-Mail eingeht
SendMailWithOptions Sendet eine E-Mail mit mehreren Optionen und wartet, bis der Empfänger mit einer der Optionen antwortet.
SendApprovalMail Sendet eine Genehmigungs-E-Mail und wartet auf eine Antwort vom Empfänger.

GetEmails

E-Mails abrufen: Ruft E-Mail-Nachrichten aus einem Ordner ab

Eingabeeigenschaften

Name Datentyp Erforderlich Beschreibung
folderPath Zeichenfolge Nein Pfad des Ordners zum Abrufen von Nachrichten (Standard: Posteingang)
top Ganze Zahl Nein Anzahl der abzurufenden E-Mails (Standard: 10)
fetchOnlyUnread Boolesch Nein Nur ungelesene Nachrichten abrufen? (Standard: true)
includeAttachments Boolesch Nein Bei „true“ werden mit der E-Mail-Nachricht auch Anhänge abgerufen. (Standard: false)
searchQuery Zeichenfolge Nein Suchabfrage zum Filtern von E-Mails
skip Ganze Zahl Nein Anzahl der zu überspringenden E-Mails (Standard: 0)
skipToken Zeichenfolge Nein Token zum Überspringen, um die neue Seite abzurufen

Ausgabeeigenschaften

Eigenschaftsname Datentyp Erforderlich Beschreibung
value Array ja Empfangen von E-Mail-Nachrichten, die die folgenden Eigenschaften enthalten können:
  • From (optional)
  • To (erforderlich)
  • Subject (erforderlich)
  • Body (erforderlich)
  • Importance (optional): „Low“, „Normal“ oder „High“
  • HasAttachment (optional)
  • Id (optional)
  • IsRead (optional)
  • DateTimeReceived (optional)
  • Attachments (optional): Anhänge empfangen. Eigenschaften für Anhänge sind u.a. Id (erforderlich), ContentType (erforderlich), Name (erforderlich), ContentBytes (erforderlich).
  • Cc (optional)
  • Bcc (optional)
  • IsHtml (optional)

SendEmail

E-Mail senden: Sendet eine E-Mail-Nachricht

Eingabeeigenschaften

Name Datentyp Erforderlich Beschreibung
emailMessage ja E-Mail-Nachrichteninstanz, die die folgenden Eigenschaften enthalten kann:
  • Attachment (optional): Anhang senden. Eigenschaften von Attachment sind u.a. Name (erforderlich) sowie ContentBytes (erforderlich).
  • From (optional)
  • Cc (optional)
  • Bcc (optional)
  • Subject (erforderlich)
  • Body (erforderlich)
  • Importance (optional): „Low“, „Normal“ oder „High“
  • IsHtml (optional): „true“ oder „false“ eingeben
  • To (erforderlich): Trennen Sie E-Mail-Adressen durch Komma.

Ausgabeeigenschaften

Keine

DeleteEmail

E-Mail löschen: Löscht eine E-Mail-Nachricht nach ID

Eingabeeigenschaften

Name Datentyp Erforderlich Beschreibung
messageId Zeichenfolge ja ID der zu löschenden Nachricht.

Ausgabeeigenschaften

Keine

MarkAsRead

Als gelesen markieren: Markiert eine E-Mail-Nachricht als gelesen

Eingabeeigenschaften

Name Datentyp Erforderlich Beschreibung
messageId Zeichenfolge ja ID der Nachricht, die als gelesen markiert wird

Ausgabeeigenschaften

Keine

ReplyTo

Nachricht beantworten: Beantwortet eine E-Mail-Nachricht

Eingabeeigenschaften

Name Datentyp Erforderlich Beschreibung
messageId Zeichenfolge ja ID der zu beantwortenden Nachricht
comment Zeichenfolge ja Antwortkommentar
replyAll Boolesch Nein Antwort an alle Empfänger

Ausgabeeigenschaften

Keine

GetAttachment

Anhang abrufen: Ruft den Nachrichtenanhang nach ID ab

Eingabeeigenschaften

Name Datentyp Erforderlich Beschreibung
messageId Zeichenfolge ja ID der Nachricht
attachmentId Zeichenfolge ja ID der herunterzuladenden Anlage

Ausgabeeigenschaften

Keine

OnNewEmail

Bei neuer E-Mail: Löst einen Flow aus, wenn eine neue E-Mail eingeht

Eingabeeigenschaften

Name Datentyp Erforderlich Beschreibung
folderPath Zeichenfolge Nein Der abzurufende E-Mail-Ordner (Standard: Inbox, Inbox\ToMe usw.)
bis Zeichenfolge Nein E-Mail-Adressen der Empfänger
from Zeichenfolge Nein Absenderadresse
importance Zeichenfolge Nein Die Wichtigkeit der E-Mail (High, Normal, Low) (Standard: Normal)
fetchOnlyWithAttachment Boolesch Nein Nur E-Mail-Nachrichten mit Anhang abrufen
includeAttachments Boolesch Nein Anhänge einschließen
subjectFilter Zeichenfolge Nein Zeichenfolge, die in der Betreffzeile gesucht werden soll.

Ausgabeeigenschaften

Eigenschaftsname Datentyp Erforderlich Beschreibung
value Array Nein

SendMailWithOptions

E-Mail mit Optionen senden: Sendet eine E-Mail mit mehreren Optionen und wartet, dass der Empfänger mit einer der Optionen antwortet.

Eingabeeigenschaften

Name Datentyp Erforderlich Beschreibung
optionsEmailSubscription ja Abonnementanforderung für E-Mail-Optionen, u.a.:
  • NotificationUrl (optional)
  • Message (optional)

Ausgabeeigenschaften

Eigenschaftsname Datentyp Erforderlich Beschreibung
id Zeichenfolge Nein
resource Zeichenfolge Nein
notificationType Zeichenfolge Nein
notificationUrl Zeichenfolge Nein

SendApprovalMail

Genehmigungs-E-Mail senden: Sendet eine Genehmigungs-E-Mail und wartet auf eine Antwort vom Empfänger.

Eingabeeigenschaften

Name Datentyp Erforderlich Beschreibung
approvalEmailSubscription ja Abonnementanforderung für Genehmigungs-E-Mail, u.a.:
  • NotificationUrl (optional)
  • Message (optional)

Ausgabeeigenschaften

Eigenschaftsname Datentyp Erforderlich Beschreibung
id Zeichenfolge Nein
resource Zeichenfolge Nein
notificationType Zeichenfolge Nein
notificationUrl Zeichenfolge Nein

Nützliche Links