UpdateItem-Vorgang
Der UpdateItem-Vorgang wird verwendet, um die Eigenschaften eines vorhandenen Elements im Exchange-Speicher zu ändern.
HinwBemerkungeneise
Sie können drei grundlegende Aktualisierungsaktionen für ein Element ausführen. In der folgenden Tabelle sind die Aktionen aufgeführt, die Sie ausführen können.
| Aktion | Beschreibung |
|---|---|
| Anfügen |
Fügt einer vorhandenen Eigenschaft Daten hinzu. Diese Aktion behält die aktuellen Daten bei. Append gilt nicht für alle Eigenschaften. |
| Satz |
Ersetzt Daten für eine Eigenschaft, wenn die Eigenschaft Daten enthält, oder erstellt die Eigenschaft und legt ihren Wert fest, wenn die Eigenschaft nicht vorhanden ist. Die Set-Aktion gilt nur für beschreibbare Eigenschaften. |
| Löschen |
Entfernt eine Eigenschaft aus einem Element. Dies unterscheidet sich vom Festlegen einer Eigenschaft auf einen leeren Wert. Wenn diese Aktion abgeschlossen ist, ist die Eigenschaft für das Element nicht vorhanden. Löschen gilt nur für beschreibbare Eigenschaften. |
Ein UpdateItem-Aufruf kann verwendet werden, um ein oder mehrere Elemente und eine oder mehrere Eigenschaften für jedes Element zu ändern. Das ItemChanges-Element enthält alle Änderungen, die im Rahmen dieses Aufrufs ausgeführt werden sollen. Das ItemChange-Element , ein untergeordnetes Element des ItemChanges-Elements , stellt die Änderungen dar, die an einem einzelnen Element ausgeführt werden sollen. Das ItemChange-Element enthält eine Reihe von Aktualisierungsaktionen, die für ein einzelnes Element ausgeführt werden können. Diese Änderungen sind im element Aktualisierungen (Item) enthalten. Das Element ItemId identifiziert das zu aktualisierende Element. Um mehr als eine Eigenschaft für ein Element zu aktualisieren, muss für jede Eigenschaft, die das Update erfordert, ein SetItemField, AppendToItemField oder DeleteItemField bereitgestellt werden.
Hinweis
Aktualisierungsaktionen werden in der Reihenfolge angewendet, in der sie angegeben werden.
Für jede Änderung müssen Sie den Pfad der zu ändernden Eigenschaft und eine Darstellung dieses Elements mit seinem neuen Wert angeben. Die Löschaktion unterscheidet sich geringfügig darin, dass nur der Pfad der Eigenschaft erforderlich ist, die gelöscht werden soll. Bei Set- und Append-Aktionen muss der angegebene Pfad auf dieselbe Eigenschaft verweisen, die in der Elementdarstellung festgelegt wird. Wenn diese unterschiedet, wird ein Fehler zurückgegeben.
Der UpdateItem-Vorgang kann die Start - und Endzeit eines Exchange-Speicherelements festlegen. In einer UpdateItem-Anforderung kann die Startzeit festgelegt werden, ohne auch die Endzeit festzulegen. Dies kann zu einem Fehler führen, wenn die Startzeit höher als die Endzeit ist. Beachten Sie, dass Clientanwendungen die Endzeit anpassen müssen, wenn die Startzeit geändert wird, um die Dauer beizubehalten.
Wenn ein einzelnes Kalenderelement aktualisiert wird, um ein wiederkehrendes Kalenderelement zu werden, muss die MeetingTimeZone-Eigenschaft durch den UpdateItem-Vorgang festgelegt werden, um die ursprüngliche Zeitzone des Kalenderelements beizubehalten.
SetItemField-Anforderungsbeispiel
Beschreibung
Das folgende Beispiel einer UpdateItem-Anforderung zeigt, wie die Vertraulichkeitseigenschaft für ein Element festgelegt 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>
<UpdateItem MessageDisposition="SaveOnly" ConflictResolution="AutoResolve"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ItemChanges>
<t:ItemChange>
<t:ItemId Id="AAAtAEFkb..." ChangeKey="CQAAABYAAAB..."/>
<t:Updates>
<t:SetItemField>
<t:FieldURI FieldURI="item:Sensitivity"/>
<t:Message>
<t:Sensitivity>Normal</t:Sensitivity>
</t:Message>
</t:SetItemField>
</t:Updates>
</t:ItemChange>
</ItemChanges>
</UpdateItem>
</soap:Body>
</soap:Envelope>
Kommentare
Der Elementbezeichner und der Änderungsschlüssel wurden gekürzt, um die Lesbarkeit zu erhalten.
SetItemField-Anforderungselemente
In der Anforderung werden folgende Elemente verwendet:
AppendToItemField-Anforderungsbeispiel
Beschreibung
Das folgende Beispiel einer UpdateItem-Anforderung zeigt, wie Text an die body-Eigenschaft eines Elements angefügt 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>
<UpdateItem MessageDisposition="SaveOnly" ConflictResolution="AutoResolve"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ItemChanges>
<t:ItemChange>
<t:ItemId Id="AAAtAEFkbW..." ChangeKey="CQAAABYA..."/>
<t:Updates>
<t:AppendToItemField>
<t:FieldURI FieldURI="item:Body"/>
<t:Message>
<t:Body BodyType="Text">Some additional text to append</t:Body>
</t:Message>
</t:AppendToItemField>
</t:Updates>
</t:ItemChange>
</ItemChanges>
</UpdateItem>
</soap:Body>
</soap:Envelope>
Kommentare
Die folgenden Eigenschaften unterstützen die Anfügeaktion:
message:ReplyTo
item:Body
Alle Empfänger- und Teilnehmersammlungseigenschaften
Der Elementbezeichner und der Änderungsschlüssel wurden gekürzt, um die Lesbarkeit zu erhalten.
AppendToItemField-Anforderungselemente
In der Anforderung werden folgende Elemente verwendet:
DeleteItemField-Anforderungsbeispiel
Beschreibung
Das folgende Beispiel einer UpdateItem-Anforderung zeigt, wie eine Eigenschaft für ein Element gelöscht 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>
<UpdateItem MessageDisposition="SaveOnly" ConflictResolution="AutoResolve"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ItemChanges>
<t:ItemChange>
<t:ItemId Id="AAAtAEFkbWluaXN0cm..." ChangeKey="CQAAABYAA..."/>
<t:Updates>
<t:DeleteItemField>
<t:FieldURI FieldURI="item:Body"/>
</t:DeleteItemField>
</t:Updates>
</t:ItemChange>
</ItemChanges>
</UpdateItem>
</soap:Body>
</soap:Envelope>
Kommentare
Der Elementbezeichner und der Änderungsschlüssel wurden gekürzt, um die Lesbarkeit zu erhalten.
DeleteItemField-Anforderungselemente
In der Anforderung werden folgende Elemente verwendet:
Beispiel für eine erfolgreiche Antwort
Beschreibung
Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine UpdateItem-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="664" MinorBuildNumber="0"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"/>
</soap:Header>
<soap:Body>
<UpdateItemResponse 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:UpdateItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:Message>
<t:ItemId Id="AAAtAEFkbW..." ChangeKey="CQAAABYAAA..."/>
</t:Message>
</m:Items>
</m:UpdateItemResponseMessage>
</m:ResponseMessages>
</UpdateItemResponse>
</soap:Body>
</soap:Envelope>
Kommentare
Der Elementbezeichner und der Änderungsschlüssel wurden gekürzt, um die Lesbarkeit zu erhalten.
Erfolgreiche Antwortelemente
In der Antwort werden folgende Elemente verwendet: