Operation: ListMailFolders

Die Operation ListMailFolders erstellt eine Liste der vorhandenen E-Mail-Ordner.

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 den Access Token vom MS Graph Auth Adapter mit dazugehörigem Mapping als Input.

Output

Der Adapter generiert als Output eine Liste der im Outlook-Account vorhandenen E-Mail-Ordner mit E-Mail-Ordner-ID:

Example

XML

<?xml version="1.0" encoding="UTF-8"?>
<MailFolder>
   <Object>
      <Value name="id" type="String">AAMkAGI0NDU3YTMxLTVkOTktNGQ2Zi04OGViLTgzNWM1YWFlNjAwNwAuAAAAAABqZX6HQaolT792ILCaL-z8AQCRrcaFxKxcR7F2mRmZk4TVAAAAAAEXAAA=</Value>
      <Value name="displayName" type="String">Inbox</Value>
      <Value name="parentFolderId" type="String">AAMkAGI0NDU3YTMxLTVkOTktNGQ2Zi04OGViLTgzNWM1YWFlNjAwNwAuAAAAAABqZX6HQaolT792ILCaL-z8AQCRrcaFxKxcR7F2mRmZk4TVAAAAAAEIAAA=</Value>
      <Value name="childFolderCount" type="Number">0</Value>
      <Value name="unreadItemCount" type="Number">0</Value>
      <Value name="totalItemCount" type="Number">0</Value>
      <Value name="sizeInBytes" type="Number">0</Value>
      <Value name="isHidden" type="Boolean">false</Value>
   </Object>
<Object>
      <Value name="id" type="String">AAMkAGI0NDU3YTMxLTVkOTktNGQ2Zi04OGViLTgzNWM1YWFlNjAwNwAuAAAAAABqZX6HQaolT792ILCaL-z8AQCRrcaFxKxcR7F2mRmZk4TVAAAAAAEPAAA=</Value>
      <Value name="displayName" type="String">Drafts</Value>
      <Value name="parentFolderId" type="String">AAMkAGI0NDU3YTMxLTVkOTktNGQ2Zi04OGViLTgzNWM1YWFlNjAwNwAuAAAAAABqZX6HQaolT792ILCaL-z8AQCRrcaFxKxcR7F2mRmZk4TVAAAAAAEIAAA=</Value>
      <Value name="childFolderCount" type="Number">0</Value>
      <Value name="unreadItemCount" type="Number">7</Value>
      <Value name="totalItemCount" type="Number">16</Value>
      <Value name="sizeInBytes" type="Number">7453898</Value>
      <Value name="isHidden" type="Boolean">false</Value>
   </Object>
 <Object>
      <Value name="id" type="String">AAMkAGI0NDU3YTMxLTVkOTktNGQ2Zi04OGViLTgzNWM1YWFlNjAwNwAuAAAAAABqZX6HQaolT792ILCaL-z8AQCRrcaFxKxcR7F2mRmZk4TVAAAAAAEJAAA=</Value>
      <Value name="displayName" type="String">Sent</Value>
      <Value name="parentFolderId" type="String">AAMkAGI0NDU3YTMxLTVkOTktNGQ2Zi04OGViLTgzNWM1YWFlNjAwNwAuAAAAAABqZX6HQaolT792ILCaL-z8AQCRrcaFxKxcR7F2mRmZk4TVAAAAAAEIAAA=</Value>
      <Value name="childFolderCount" type="Number">0</Value>
      <Value name="unreadItemCount" type="Number">0</Value>
      <Value name="totalItemCount" type="Number">591</Value>
      <Value name="sizeInBytes" type="Number">182028852</Value>
      <Value name="isHidden" type="Boolean">false</Value>
   </Object>
...
</MailFolder>

Hinweis:

Im Output sind Metadaten enthalten, die von MS Graph bereitgestellt werden. Nähere Informationen zu diesen Metadaten sind in der offiziellen MS Graph-Dokumentation zu finden: https://learn.microsoft.com/de-de/graph/

Folgende Elemente und Attribute können im Output enthalten sein:

Element

Beschreibung

MailFolder

Umschließendes Element für den Output der Operation ListMailFolders

Object

Umschließendes Element für die Elemente Value mit Angaben zu den E-Mail-Ordnern:

ID des E-Mail-Ordners
Name des E-Mail-Ordners
ID des übergeordneten E-Mail-Ordners
Anzahl der Unterordner
Anzahl der ungelesenen Elemente
Gesamtanzahl der Elemente im Ordner
Größe des E-Mail-Ordners in Byte
Sichtbarkeit des Ordners

Value

Das Element Value kann im Attribut name verschiedene Werte enthalten:

Mögliche Werte:

id: ID des E-Mail-Ordners
displayName: Name des E-Mail-Ordners
parentFolderId: ID des übergeordneten E-Mail-Ordners
childFolderCount: Anzahl der Unterordner
unreadItemCount: Anzahl der ungelesenen Elemente
totalItemCount: Gesamtanzahl der Elemente im Ordner
sizeInBytes: Größe des E-Mail-Ordners in Byte
isHidden: Sichtbarkeit des Ordners

Das Attribut type gibt den Typ der angegebenen Daten an:

String: Beliebige Zeichenkette
Number: Beliebige Ganzzahl (Integer)
Boolean: Boole’scher Wert mit den Optionen true oder false