Skip to main content
Skip table of contents

Operation: CreateDraftMail

Die Operation CreateDraftMail erstellt einen E-Mail-Entwurf.

Input

Der Adapter erwartet folgende XML-Struktur als Input:

Beispiel

XML 
<?xml version="1.0" encoding="UTF-8"?>
<CreateDraft>
	<Subject></Subject>
	<Message type="text|html"></Message>
	<ToRecipients>
		<Recipient></Recipient>
		<Recipient></Recipient>
	</ToRecipients>
	<!-- ###Optional### -->
	<CcRecipients>
		<Recipient></Recipient>
		<Recipient></Recipient>
	</CcRecipients>	
	<!-- ###Optional### -->
	<BccRecipients>
		<Recipient></Recipient>
		<Recipient></Recipient>
	</BccRecipients>
	<!-- ###Optional -->
	<Importance>high|normal|low</Importance>
	<!-- ###Optional### -->
	<Attachments>
		<Attachment>
			<FileName></FileName>
			<FileData></FileData>
		</Attachment>
	</Attachments>	
</CreateDraft>

Folgende Elemente können im Input enthalten sein:

Element

Beschreibung

CreateDraft

Umschließendes Element für die Operation CreateDraftMail

Subject

Betreff der E-Mail

Mögliche Werte:

Beliebige Zeichenkette

Message

Über das Attribut type wird die Art der Nachricht definiert.

Mögliche Werte:

  • text

  • html

Hinweis:

Der Input für html sollte im Format xhtml sein. Vor Übertragung wird html zu xhtml konvertiert.

Beispiele:

  • text:

XML 
<Message type="text">Hello, this is a test!</Message>

  • html:

XML 
<Message type="html">
	<html>
		<body>
			<h1>Welcome to our Newsletter</h1>
			<p>Hello,</p>
			<p>Thank you for your interest in our
				newsletter.
			</p>
			<ul>
				<li>First item</li>
				<li>Second item</li>
				<li>Third item</li>
			</ul>
			<p>We hope you find the information helpful.</p>
			<p>
				Best regards,
				<br />
				Your Newsletter Team
			</p>
		</body>
	</html>

ToRecipients

Empfänger der E-Mail. Enthält ein oder mehrere Recipient-Elemente.

Recipient

E-Mail-Adresse des Empfängers

Möglicher Wert:

E-Mail-Adresse

Beispiel:

test.user@softproject.de

CcRecipients

(optional)

Empfänger der E-Mail in Kopie (Cc). Das Element CcRecipients muss mindestens ein Recipient-Element enthalten.

BccRecipients

(optional)

Empfänger der E-Mail in Blindkopie (Bcc). Das Element BccRecipients muss mindestens ein Recipient-Element enthalten.

Importance

(optional)

Wichtigkeit der E-Mail

Mögliche Werte:

  • high: Höchste Wichtigkeitsstufe

  • normal: Mittlere Wichtigkeitsstufe

  • low: Niedrigste Wichtigkeitsstufe

Attachments

(optional)

Das Element Attachments kann einen oder mehrere Anhänge enthalten.

Attachment

(optional)

Das Element Attachment enthält die Elemente FileName und FileData.

FileName

(optional)

Dateiname des Anhangs

FileData

(optional)

Inhalt des Anhangs im Format base64

Output

Der Entwurf der E-Mail wird im Ordner Entwürfe gespeichert.

Der Adapter generiert folgendes XML-Dokument als Output:

Beispiel

XML 
<?xml version="1.0" encoding="UTF-8"?>
<CreateDraft>
   <Object>
      <Value name="@odata.context" type="String">https://graph.microsoft.com/v1.0/$metadata#users('test.user%40softproject.de')/messages/$entity</Value>
      <Value name="@odata.etag" type="String">W/"CQAAABYAAACRrcaFxKxcR7F2mRmZk4TVAAC6T6wA"</Value>
      <Value name="id" type="String">AAMkAGI0NDU3YTMxLTVkOTktNGQ2Zi04OGViLTgzNWM1YWFlNjAwNwBGAAAAAABqZX6HQaolT792ILCaL-z8BwCRrcaFxKxcR7F2mRmZk4TVAAAAAAEPAACRrcaFxKxcR7F2mRmZk4TVAAC6rA52AAA=</Value>
      <Value name="createdDateTime" type="String">2023-06-29T14:22:32Z</Value>
      <Value name="lastModifiedDateTime" type="String">2023-06-29T14:22:32Z</Value>
      <Value name="changeKey" type="String">CQAAABYAAACRrcaFxKxcR7F2mRmZk4TVAAC6T6wA</Value>
      <Array name="categories"/>
      <Value name="receivedDateTime" type="String">2023-06-29T14:22:32Z</Value>
      <Value name="sentDateTime" type="String">2023-06-29T14:22:32Z</Value>
      <Value name="hasAttachments" type="Boolean">false</Value>
      <Value name="internetMessageId" type="String"><GV1P193MB231298AC39075A87CA87D95CEF25A@GV1P193MB2312.EURP193.PROD.OUTLOOK.COM></Value>
      <Value name="subject" type="String">Unit-Test - Creating a draft mail</Value>
      <Value name="bodyPreview" type="String">Hello, this is a Unit-Test! Test for creating and sending a draft mail</Value>
      <Value name="importance" type="String">normal</Value>
      <Value name="parentFolderId" type="String">AAMkAGI0NDU3YTMxLTVkOTktNGQ2Zi04OGViLTgzNWM1YWFlNjAwNwAuAAAAAABqZX6HQaolT792ILCaL-z8AQCRrcaFxKxcR7F2mRmZk4TVAAAAAAEPAAA=</Value>
      <Value name="conversationId" type="String">AAQkAGI0NDU3YTMxLTVkOTktNGQ2Zi04OGViLTgzNWM1YWFlNjAwNwAQAMvXRjjTgmVNv6d_qGfIB0M=</Value>
      <Value name="conversationIndex" type="String">AQHZqpUky9dGONOCZU2/p36oZ8gHQw==</Value>
      <Value name="isDeliveryReceiptRequested" type="Boolean">false</Value>
      <Value name="isReadReceiptRequested" type="Boolean">false</Value>
      <Value name="isRead" type="Boolean">true</Value>
      <Value name="isDraft" type="Boolean">true</Value>
      <Value name="webLink" type="String">https://outlook.office365.com/owa/?ItemID=AAMkAGI0NDU3YTMxLTVkOTktNGQ2Zi04OGViLTgzNWM1YWFlNjAwNwBGAAAAAABqZX6HQaolT792ILCaL%2Fz8BwCRrcaFxKxcR7F2mRmZk4TVAAAAAAEPAACRrcaFxKxcR7F2mRmZk4TVAAC6rA52AAA%3D&exvsurl=1&viewmodel=ReadMessageItem</Value>
      <Value name="inferenceClassification" type="String">focused</Value>
      <Object name="body">
         <Value name="contentType" type="String">text</Value>
         <Value name="content" type="String">Hello, this is a Unit-Test! Test for creating and sending a draft mail</Value>
      </Object>
      <Array name="toRecipients">
         <Object>
            <Object name="emailAddress">
               <Value name="name" type="String">Test User</Value>
               <Value name="address" type="String">test.user@softproject.de</Value>
            </Object>
         </Object>
      </Array>
      <Array name="ccRecipients"/>
      <Array name="bccRecipients"/>
      <Array name="replyTo"/>
      <Object name="flag">
         <Value name="flagStatus" type="String">notFlagged</Value>
      </Object>
   </Object>
</CreateDraft>

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

CreateDraft

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

Object

Umschließendes Element für die Elemente Value mit Angaben zum erstellten E-Mail-Entwurf.

Value + name Attribute

Das Element Value kann im Attribut name verschiedene Werte enthalten.

Mögliche Werte für das Attribut name:

  • @odata.context: Request URL, um eine Antwort von MS Graph zu erhalten

  • @odata.etag

  • id: ID des E-Mail-Entwurfs

  • createdDateTime: Datum und Zeit der Erstellung des E-Mail-Entwurfs

  • lastModifiedDateTime: Datum und Zeit der letzten Änderung des E-Mail-Entwurfs

  • changeKey: Änderungsschlüssel eines Elements

  • receivedDateTime: Datum und Zeit des Empfangs des E-Mail-Entwurfs

  • sentDateTime: Datum und Zeit der Versendung des E-Mail-Entwurfs

  • hasAttachments: Anhänge

  • internetMessageId: Internet Message ID eines Elements

  • subject: Betreff des E-Mail-Entwurfs

  • bodyPreview: Vorschau des E-Mail-Entwurfs

  • importance: Wichtigkeit mit den möglichen Werten high, normal, low

  • parentFolderId: ID des übergeordneten E-Mail-Ordners

  • conversationId: bringt eine E-Mail-Nachricht mit einer bestimmten E-Mail-Konversation in Verbindung

  • conversationIndex: Conversation Index

  • isDeliveryReceiptRequested: Sendebestätigung angefragt

  • isReadReceiptRequested: Lesebestätigung angefragt

  • isRead: E-Mail-Entwurf als gelesen markiert

  • isDraft: E-Mail als Entwurf markiert

  • webLink: Weblink für Aufruf der E-Mail im Browser

  • inferenceClassification: Klassifizierung der Nachrichten eines Nutzers, um den Fokus auf die für den Nutzer relevanten oder wichtigen Nachrichten zu lenken.

Das Attribut type gibt den Typ der angegebenen Daten an:

  • String: Beliebige Zeichenkette

  • Number: Beliebige Ganzzahl (Integer)

  • Boolean: Boolescher Wert mit den Optionen true oder false

Object + name Attribute + Wert body (Textkörper der Mail)

Definiert den Textkörper der Mail.
Im Element Object können weitere Value-Elemente enthalten sein mit folgenden Attributen:

  • contentType: Typ des Inhalts
    Mögliche Werte:

    • html

    • text

  • content: Textkörper der Mail

Array

Array mit Angabe zu Empfängern, Empfängern in Kopie und Empfängern in Blindkopie mit E-Mail-Adresse und Name.

Mögliche Werte im Attribut name:

  • toRecipients: Empfänger des E-Mail-Entwurfs

  • ccRecipients: Empfänger des E-Mail-Entwurfs in Kopie

  • bccRecipients: Empfänger des E-Mail-Entwurfs in Blindkopie

  • replyTo: nicht in Verwendung (Wenn die ursprüngliche Nachricht einen Empfänger in der replyTo-Eigenschaft angibt, wird die Antwort an die Empfänger in replyTo und nicht an den Empfänger in der Eigenschaft from gesendet.)

Object

Gibt Namen und E-Mail-Adressen der Empfänger an (toRecipients, ccRecipients, bccRecipients, replyTo).

Object

Das Element Object als Attribut name enthalten mit dem Wert flag.
Im Element Object können weitere Value-Elemente enthalten sein mit folgenden Attributen:

  • name mit den Werten flagStatus (...)


Mögliche Werte für flagStatus sind:

  • notFlagged

  • Flagged


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.

Contact Support Close