UpdateItem-Vorgang (Kontakt)

Der UpdateItem-Vorgang wird verwendet, um Kontaktelementeigenschaften im Exchange-Speicher zu aktualisieren.

Beispiel für eine UpdateItem-Anforderung (Contact)

Beschreibung

Im folgenden Codebeispiel wird gezeigt, wie die E-Mail-Adresse eines Kontakts aktualisiert wird.

Code

<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 xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
                ConflictResolution="AlwaysOverwrite">
      <ItemChanges>
        <t:ItemChange>
          <t:ItemId Id="AAAtAA=" ChangeKey="EQAAABYi" />
          <t:Updates>
            <t:SetItemField>
              <t:IndexedFieldURI FieldURI="contacts:EmailAddress" FieldIndex="EmailAddress1"/>
              <t:Contact>
                <t:EmailAddresses>
                  <t:Entry Key="EmailAddress1">changedemail@example.com</t:Entry>
                </t:EmailAddresses>
              </t:Contact>
            </t:SetItemField>
          </t:Updates>
        </t:ItemChange>
      </ItemChanges>
    </UpdateItem>
  </soap:Body>
</soap:Envelope>

Kommentare

Der Elementbezeichner wurde gekürzt, um die Lesbarkeit zu erhalten.

Anfordern von Elementen

In der Anforderung werden folgende Elemente verwendet:

• UpdateItem

• ItemChanges

• ItemChange

• ItemId

• Updates (Element)

• SetItemField

• IndexedFieldURI

• Contact

• EmailAddresses

• Eintrag (EmailAddress)

Erfolgreiche UpdateItem-Antwort (Contact)

Beschreibung

Das folgende Codebeispiel zeigt eine erfolgreiche UpdateItem-Antwort.

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="602" 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:Contact>
              <t:ItemId Id="AAAtAE=" ChangeKey="EQAAABYx" />
            </t:Contact>
          </m:Items>
        </m:UpdateItemResponseMessage>
      </m:ResponseMessages>
    </UpdateItemResponse>
  </soap:Body>
</soap:Envelope>

Kommentare

Der Elementbezeichner wurde gekürzt, um die Lesbarkeit zu erhalten.

Erfolgreiche Antwortelemente

In der Antwort werden folgende Elemente verwendet:

• ServerVersionInfo

• UpdateItemResponse

• ResponseMessages

• UpdateItemResponseMessage

• ResponseCode

• Items (NonEmptyArrayOfAllItemsType)

• Contact

• ItemId

Beispiel für eine ungültige UpdateItem-Anforderung (Contact)

Beschreibung

Das folgende Codebeispiel zeigt eine ungültige Anforderung.

Code

<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 xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
                ConflictResolution="AlwaysOverwrite">
      <ItemChanges>
        <t:ItemChange>
          <t:ItemId Id="AAAtAEF=" ChangeKey="EQAAABYi" />
          <t:Updates>
            <t:SetItemField>
              <t:IndexedFieldURI FieldURI="contacts:EmailAddress" FieldIndex="EmailAddress4"/>
              <t:Contact>
                <t:EmailAddresses>
                  <t:Entry Key="EmailAddress4">changedemail2@example.com</t:Entry>
                </t:EmailAddresses>
              </t:Contact>
            </t:SetItemField>
          </t:Updates>
        </t:ItemChange>
      </ItemChanges>
    </UpdateItem>
  </soap:Body>
</soap:Envelope>

Kommentare

Der Elementbezeichner wurde gekürzt, um die Lesbarkeit zu erhalten.

UpdateItem -Fehlerantwort (Contact)

Beschreibung

Das folgende Codebeispiel zeigt eine Fehlerantwort auf eine UpdateItem (Contact)-Anforderung.

Code

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="602" MinorBuildNumber="0" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <soap:Fault>
      <soap:faultcode>Client</soap:faultcode>
      <soap:faultstring>The request failed schema validation.</soap:faultstring>
      <detail>
        <e:ResponseCode xmlns:e="http://schemas.microsoft.com/exchange/services/2006/errors">ErrorSchemaValidation</e:ResponseCode>
        <e:Message xmlns:e="http://schemas.microsoft.com/exchange/services/2006/errors">The 'Key' attribute is invalid - The value 'EmailAddress4' is invalid according to its data type 'http://schemas.microsoft.com/exchange/services/2006/types:EmailAddressKeyType' - The Enumeration constraint failed.</e:Message>
        <e:Line xmlns:e="http://schemas.microsoft.com/exchange/services/2006/errors">17</e:Line>
        <e:Position xmlns:e="http://schemas.microsoft.com/exchange/services/2006/errors">19</e:Position>
      </detail>
    </soap:Fault>
  </soap:Body>
</soap:Envelope>

Kommentare

Einige Elemente, die im SOAP-Text einer Fehlerantwort verwendet werden, die durch einen Schemavalidierungsfehler verursacht wird, sind in den Nachrichten- oder Typenschemas nicht definiert. Das Detailelement enthält Informationen zum Fehler. Das ResponseCode-Element enthält den Fehlercode. Das Message-Element enthält eine Erklärung für den Fehler, sofern verfügbar. Das Line-Element beschreibt die Zeilennummer, in der der Schemaüberprüfungsfehler aufgetreten ist. Das Position-Element beschreibt die Position aus dem am weitesten links stehenden Zeichen des XML-Dokuments.

Siehe auch

UpdateItem-Vorgang