Funktionen und Operationen | X4Documentation

Mit dem MS Graph E-Mail Connector lassen sich für die E-Mail-Accounts von Firmennutzern eines in MS Azure registrierten Unternehmens verschiedene Operationen durchführen, wie z. B. E-Mail-Ordner anlegen, umbenennen oder löschen, E-Mails versenden oder in einen anderen E-Mail-

Ordner verschieben.

Hinweis;

Zur Nutzung des MS Graph E-Mail Connectors ist eine Authentifizierung in MS Azure über den MS Graph Auth Adapter mit Access Token erforderlich.

Eigenschaften

Operation

Bestimmt, welche Operation der Adapter ausführt.

Mögliche Werte:

List Mail Folders: Erstellt eine Liste aller E-Mail-Ordner der Accounts
List Mails: Erstellt eine Liste aller E-Mails des Accounts
Create Mail Folder: Erstellt einen neuen E-Mail-Ordner
Rename Mail Folder: Benennt einen bestehen E-Mail-Ordner um
Delete Mail Folder: Löscht einen bestehen E-Mail-Ordner
Delete Mail: Löscht eine bestehe E-Mail
Get Mail: Lädt eine E-Mail anhand einer spezifischen E-Mail-ID
Move Mail: Verschiebt eine E-Mail in einen anderen Ordner
Send Mail: Versendet eine E-Mail
Create Draft Mail: Erstellt einen Entwurf einer E-Mail
Send Draft Mail: Versendet eine als Entwurf erstellte E-Mail

Parameter

`Repository`	Virtuelles Repository des Adapter-Projekts. Der Wert kann nicht geändert werden.
`Token`	Zur Verwendung des MS Graph E-Mail Connectors ist ein Access Token erforderlich. Dieser Access Token gewährt Zugriff auf MS Azure und somit zu den in MS Azure registrierten Firmennutzern. Der Access Token wird durch den MS Graph Auth Adapter geliefert. Mögliche Werte: `Beliebige Zeichenkette`
`Email`	E-Mail-Account, zu dem über den Access Token Zugriff gewährt wird und für den die Adapter-Operationen ausgeführt werden. Mögliche Werte: `E-Mail-Adresse`
`Limit`	Anzahl der Elemente, für die eine Operation durchgeführt werden soll. Hinweis: Dieser Parameter wird nur für die Operationen `ListMailFolders` und `ListMails` in Kombination mit dem Parameter `Offset` verwendet. Mögliche Werte: `Beliebige Ganzzahl (Integer)` Hinweis: Wird der Parameter `Limit` ohne den Parameter `Offset` verwendet (Parameter `Offset` = 0), so wird im Output die Anzahl an Elementen angegeben, die im Parameter `Limit` spezifiziert ist. Beispiel: Parameter `Limit` = `100` bei der Operation `ListMails` 100 E-Mails werden ausgegeben.
`Offset`	Legt die Anzahl der ausgewählten Elemente fest. Hinweis: Dieser Parameter wird nur für die Operationen `ListMailFolders` und `ListMails` in Kombination mit dem Parameter `Limit` verwendet. Mögliche Werte: `Beliebige Ganzzahl (Integer)`

Statuswerte

`1`	Die Operation wurde erfolgreich ausgeführt.
`-1`	Die Operation konnte nicht erfolgreich ausgeführt werden (Details siehe Server-Log).