UpdateFolder-Vorgang

  • Artikel

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.

HinwBemerkungeneise

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.
Satz
 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 für eine 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="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <UpdateFolder xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
                  xmlns:t="https://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 den aktualisierten 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="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <UpdateFolderResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                          xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                          xmlns="https://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="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <UpdateFolderResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                          xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                          xmlns="https://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:

Siehe auch