UpdateFolder-Vorgang
Der UpdateFolder-Vorgang wird verwendet, um eigenschaften eines vorhandenen Elements im Exchange-Speicher zu ändern. Jeder UpdateFolder-Vorgang besteht aus folgenden Elementen:
Ein FolderId-Element , das einen zu aktualisierenden Ordner angibt.
Ein interner Pfad eines Elements im Ordner, wie durch das Ordner-Shape angegeben, das die zu aktualisierenden Daten angibt.
Ein Ordner, der den neuen Wert des aktualisierten Felds enthält, wenn das Update kein Löschvorgang ist.
Hinweise
Für ein Element können drei grundlegende Aktualisierungsaktionen ausgeführt werden. Diese Aktionen sind in der folgenden Tabelle aufgeführt.
| Aktion | Beschreibung |
|---|---|
| Anfügen |
Die Anfügeaktion fügt einer vorhandenen Eigenschaft Daten hinzu. Die daten, die derzeit vorhanden sind, werden beibehalten. Append gilt nicht für alle Eigenschaften. |
| Set |
Die Set-Aktion ersetzt Daten für eine Eigenschaft, wenn sie Daten enthält, oder erstellt die Eigenschaft und legt ihren Wert fest, wenn sie nicht vorhanden ist. Die Set-Aktion gilt nur für beschreibbare Eigenschaften. |
| Löschen |
Die Löschaktion entfernt eine Eigenschaft aus einem Ordner. Dies unterscheidet sich vom Festlegen auf einen leeren Wert. Nach Abschluss des Vorgangs ist die Eigenschaft für den Ordner nicht vorhanden. Löschen gilt nur für beschreibbare Eigenschaften. |
UpdateFolder-Anforderungsbeispiel
Beschreibung
Das folgende Beispiel einer UpdateFolder-Anforderung zeigt, wie ein Ordneranzeigename aktualisiert wird.
Code
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<UpdateFolder xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<FolderChanges>
<t:FolderChange>
<t:FolderId Id="AScA" ChangeKey="GO3u/"/>
<t:Updates>
<t:SetFolderField>
<t:FieldURI FieldURI="folder:DisplayName"/>
<t:Folder>
<t:DisplayName>NewFolderName</t:DisplayName>
</t:Folder>
</t:SetFolderField>
</t:Updates>
</t:FolderChange>
</FolderChanges>
</UpdateFolder>
</soap:Body>
</soap:Envelope>
Kommentare
In diesem Beispiel wird der Anzeigename des Ordners in NewFolderName geändert.
Hinweis
Die Werte der Id - und ChangeKey-Attribute des FolderId-Elements wurden aus Gründen der Lesbarkeit gekürzt.
Anfordern von Elementen
In der Anforderung werden folgende Elemente verwendet:
Weitere Elemente, die Sie zum Erstellen einer UpdateFolder-Anforderung verwenden können, finden Sie im Schema.
Hinweis
Der Standardspeicherort des Schemas befindet sich im virtuellen EWS-Verzeichnis auf dem Computer, auf dem die Clientzugriffsserverrolle installiert ist.
UpdateFolder-Antwortbeispiel
Beschreibung
Das folgende Beispiel zeigt eine erfolgreiche Antwort auf die UpdateFolder-Anforderung. In diesem Beispiel wird der neue Änderungsschlüssel zurückgegeben, um die aktualisierte status des Ordners widerzuspiegeln.
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="685" MinorBuildNumber="8"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<UpdateFolderResponse 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:UpdateFolderResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Folders>
<t:Folder>
<t:FolderId Id="AAAlAFVz" ChangeKey="AQAAAB" />
</t:Folder>
</m:Folders>
</m:UpdateFolderResponseMessage>
</m:ResponseMessages>
</UpdateFolderResponse>
</soap:Body>
</soap:Envelope>
Kommentare
Hinweis
Die Ordner-ID und der Änderungsschlüssel wurden gekürzt, um die Lesbarkeit zu erhalten.
Die ordner-ID, die in der Antwort zurückgegeben wird, stellt den aktualisierten Ordner dar.
Erfolgreiche Antwortelemente
In der Antwort werden folgende Elemente verwendet:
UpdateFolder-Fehlerantwortbeispiel
Beschreibung
Das folgende Beispiel zeigt eine Fehlerantwort auf eine UpdateFolder-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="685" MinorBuildNumber="8"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<UpdateFolderResponse 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:UpdateFolderResponseMessage ResponseClass="Error">
<m:MessageText>The change key is invalid.</m:MessageText>
<m:ResponseCode>ErrorInvalidChangeKey</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
<m:Folders />
</m:UpdateFolderResponseMessage>
</m:ResponseMessages>
</UpdateFolderResponse>
</soap:Body>
</soap:Envelope>
Kommentare
Dieses Beispiel zeigt eine Fehlerantwort, die durch ein ungültiges ChangeKey-Attribut in der Anforderung verursacht wird.
Fehlerantwortelemente
Folgende Elemente werden in der Fehlerantwort verwendet: