Operation: ListMails

Die Operation ListMails erstellt eine Liste aller E-Mails aus einem spezifischen E-Mail-Ordner basierend auf der ID des E-Mail-Ordners.

Hinweis:

Mit den Parametern Limit und Offset kann festgelegt werden, wie viele E-Mail-Ordner im Output ausgegeben werden.

Standardmäßig werden 10 Ordner ausgegeben.

Bei Bedarf kann man die Parameter Limit und Offset im Adapter verwenden, um mehr als 10 E-Mail-Ordner im Output zu erhalten.

Hierbei ist zu beachten, dass die MS Graph API maximal 1000 Elemente auf einmal ausgeben kann. Wenn beispielsweise 2000 Elemente abgerufen werden sollen, ist eine Iteration mit den entsprechenden Paging-Einstellungen erforderlich. Dies bedeutet, dass für die zweite Iteration bei Limit der Wert 2000 zu setzen ist und bei Offset der Wert 1001.

Input

Der Adapter erwartet die folgende XML-Struktur als Input:

Beispiel

XML

<?xml version="1.0" encoding="UTF-8"?>
<MailFolder>
		<FolderId>1231241423141241</FolderId>
		<!-- ###OPTIONAL### -->
		<FilterBy>		
			<Read>true/false</Read>
			<Sender>test.user@softproject.de</Sender>
			<ReceivedDateTime>
				<From>2022-05-23T11:59:59Z</From>
				<To>2022-05-23T11:59:59Z</To>
			</ReceivedDateTime>
			<Importance>high|normal|low</Importance>
		</FilterBy>
</MailFolder>

Die folgenden Elemente können im Input enthalten sein:

Element	Beschreibung
`MailFolder`	Umschließendes Element für die Operation `ListMails`
`FolderId`	ID des E-Mail-Ordners, dessen E-Mails aufgelistet werden sollen Die E-Mail-Ordner-ID wird mit der Operation `ListMailFolders` ausgegeben. Mögliche Werte: `Beliebige Zeichenkette`
`FilterBy`	(optional) Umschließendes Element für die Filteroptionen `Read, Sender, ReceivedDateTime` und `Importance.`
`Read`	(optional) Filtert nach E-Mails, die als gelesen bzw. ungelesen markiert sind. Mögliche Werte: `true`: Filtert nach E-Mails, die als gelesen markiert sind. `false`: Filtert nach E-Mails, die als ungelesen markiert sind.
`Sender`	(optional) E-Mail-Adresse des Senders Mögliche Werte: `E-Mail-Adresse` *Beispiel:* `test.user@softproject.de`
`ReceivedDateTime`	(optional) Umschließendes Element für die Zeitspanne, die das neueste und älteste Empfangsdatum der aufzulistenden E-Mails enthält
`From`	(optional) Ältestes Empfangsdatum (Zeit und Datum) der aufzulistenden E-Mails Mögliche Werte: `YYYY-MM-DDThh:mm:ssZ` *Beispiel:* `2022-05-23T11:59:59Z`
`To`	(optional) Jüngstes Empfangsdatum (Zeit und Datum) der aufzulistenden E-Mails Mögliche Werte: `YYYY-MM-DDThh:mm:ssZ` *Beispiel:* `2022-05-23T11:59:59Z`
`Importance`	(optional) Wichtigkeit der E-Mail Mögliche Werte: `high`: Höchste Wichtigkeitsstufe `normal`: Mittlere Wichtigkeitsstufe `low`: Niedrigste Wichtigkeitsstufe

Output

Anhand der im Input definierten Daten generiert der Adapter eine Liste mit den E-Mails des Accounts.