CreateItem-Vorgang (Aufgabe)

Artikel
03/29/2023

Der CreateItem-Vorgang erstellt Aufgabenelemente im Exchange-Speicher.

Task CreateItem Request

Beschreibung

Das folgende Beispiel einer CreateItem-Anforderung zeigt, wie ein Aufgabenelement in einem Postfach erstellt wird.

Code

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <CreateItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
                xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" 
                MessageDisposition="SaveOnly">
      <Items>
        <t:Task>
          <t:Subject>My task</t:Subject>
          <t:DueDate>2006-10-26T21:32:52</t:DueDate>
          <t:Status>NotStarted</t:Status>
        </t:Task>
      </Items>
    </CreateItem>
  </soap:Body>
</soap:Envelope>

Kommentare

Anforderungen für wiederkehrende Aufgaben werden geändert, wenn sie von dem Computer empfangen werden, auf dem Microsoft Exchange Server 2007 ausgeführt wird, auf dem die Clientzugriffsserverrolle installiert ist. Die folgenden Änderungen treten auf:

Nur das Datum wird für die Eigenschaft StartDate (Recurrence) des Serienbereichs der Aufgabe gespeichert. Der Zeitteil wird abgeschnitten.
Die Eigenschaft StartDate (Recurrence) kann abhängig vom Serienmuster angepasst werden. Wenn z. B. das Serienmuster als jeden Montag angegeben wird und startDate auf den 26. Oktober 2006 festgelegt ist, d. h. ein Donnerstag, wird StartDate an den 30. Oktober 2006 angepasst, d. h. den nächsten Montag.
Wenn die StartDate-Eigenschaft der Aufgabe festgelegt ist, wird sie so aktualisiert, dass sie mit dem StartDate (Recurrence) des Serienbereichs übereinstimmt. Die DueDate-Eigenschaft des Vorgangs wird ebenfalls basierend auf dem neuen StartDate aktualisiert.
Wenn StartDate nicht festgelegt ist, wird nur die DueDate-Eigenschaft so aktualisiert, dass sie dem StartDate (Recurrence) des Serienbereichs entspricht.

Die folgende Tabelle zeigt die Änderungen, die der Clientzugriffsserver an einer wiederkehrenden Aufgabe mit einem Task.Recurrence.Pattern von jedem Montag vornimmt.

Änderungen an einer wiederkehrenden Aufgabe

Eigenschaft	Ursprünglicher Wert	Aktualisierter Wert
Task.StartDate	1. Januar 2006	Dienstag, 30. Oktober 2006
Task.DueDate	3. Januar 2006	1. November 2006
Task.Recurrence.Range.StartDate	Dienstag, 26. Oktober 2006	Dienstag, 30. Oktober 2006

Wenn kein Zielordner angegeben ist, werden Aufgabenelemente standardmäßig im Ordner Tasks erstellt.

Anfordern von Elementen

In der Anforderung werden folgende Elemente verwendet:

Erfolgreiche CreateItem-Antwort der Aufgabe

Beschreibung

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf die CreateItem-Anforderung.

Code

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="653" MinorBuildNumber="0" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <CreateItemResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
                        xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" 
                        xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:CreateItemResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Items>
            <t:Task>
              <t:ItemId Id="AAAtAE=" ChangeKey="EwAAABYA"/>
            </t:Task>
          </m:Items>
        </m:CreateItemResponseMessage>
      </m:ResponseMessages>
    </CreateItemResponse>
  </soap:Body>
</soap:Envelope>