UpdateItem 操作

UpdateItem 操作は、アイテム ストア内の既存のアイテムのプロパティを変更Exchangeされます。

注釈

アイテムに対して 3 つの基本的な更新アクションを実行できます。 次の表に、実行できるアクションの一覧を示します。

操作	説明
追加	既存のプロパティにデータを追加します。 このアクションでは、現在のデータが保持されます。 Append は、すべてのプロパティには適用されません。
Set	プロパティにデータが含まれている場合はプロパティのデータを置き換えるか、プロパティを作成し、プロパティが存在しない場合は値を設定します。 set アクションは、書き込み可能なプロパティにのみ適用されます。
削除	アイテムからプロパティを削除します。 これは、プロパティを空の値に設定する場合とは異なります。 このアクションが完了すると、アイテムのプロパティは存在しません。 Delete は書き込み可能なプロパティにのみ適用されます。

UpdateItem 呼び出 しを使用して、1 つ以上のアイテム、および各アイテムの 1 つ以上のプロパティを変更できます。 ItemChanges 要素には、この呼び出しの一部として実行されるすべての変更が含まれる。 ItemChange要素の子であるItemChange要素は、1 つのアイテムに対して実行する変更を表します。 ItemChange 要素には、1 つのアイテムに対して実行できる一連の更新アクションが含まれる。 これらの変更は、Updates (Item) 要素に含 まれています。 ItemId 要素は、更新するアイテムを識別します。 アイテムの複数のプロパティを更新するには、更新が必要なプロパティごとに SetItemField、AppendToItemField、または DeleteItemFieldを指定する必要があります。

注意

更新アクションは、指定された順序で適用されます。

変更ごとに、変更するプロパティのパスと、新しい値を持つそのアイテムの表現を指定する必要があります。 削除アクションは、削除する必要があるプロパティのパスだけが必要になるという理由で少し異なります。 set アクションと append アクションの場合、指定するパスは、アイテム表現で設定されているのと同じプロパティを参照する必要があります。 これらが異なる場合は、エラーが返されます。

UpdateItem 操作では、ストア アイテム の 開始時刻と終了時刻Exchange設定できます。 UpdateItem 要求では、終了 時刻も設定せずに開始時刻を 設定できます。 開始時刻が終了時刻より後の場合、エラーが発生する可能性があります。 クライアント アプリケーションは、期間を維持するために開始時刻が変更された場合に終了時刻を調整する必要があります。

1 つの予定表アイテムが定期的なマスター 予定表アイテムに更新される場合、予定表アイテムの元のタイム ゾーンを保持するには 、MeetingTimeZone プロパティを UpdateItem 操作で設定する必要があります。

SetItemField 要求の例

説明

UpdateItem 要求の次 の例 は、アイテムの感度プロパティを設定する方法を示しています。

コード

<?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="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <UpdateItem MessageDisposition="SaveOnly" ConflictResolution="AutoResolve" 
                xmlns="https://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>

コメント

アイテム識別子と変更キーは、読みやすさを維持するために短縮されました。

SetItemField 要求要素

要求では、次の要素が使用されます。

• UpdateItem

• ItemChanges

• ItemChange

• ItemId

• Updates (Item)

• SetItemField

• FieldURI

• Message

• Sensitivity

AppendToItemField 要求の例

説明

UpdateItem 要求の次の例は、アイテムの body プロパティにテキストを追加する方法を示しています。

コード

<?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="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <UpdateItem MessageDisposition="SaveOnly" ConflictResolution="AutoResolve" 
                xmlns="https://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>

コメント

次のプロパティは、追加アクションをサポートします。

• message:ReplyTo

• item:Body

• すべての受信者および出席者コレクションのプロパティ

アイテム識別子と変更キーは、読みやすさを維持するために短縮されました。

AppendToItemField 要求要素

要求では、次の要素が使用されます。

• UpdateItem

• ItemChanges

• ItemChange

• ItemId

• Updates (Item)

• AppendToItemField

• FieldURI

• Message

• Body

DeleteItemField 要求の例

説明

UpdateItem 要求の次の例は、アイテムのプロパティを削除する方法を示しています。

コード

<?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="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <UpdateItem MessageDisposition="SaveOnly" ConflictResolution="AutoResolve" 
                xmlns="https://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>

コメント

アイテム識別子と変更キーは、読みやすさを維持するために短縮されました。

DeleteItemField 要求要素

要求では、次の要素が使用されます。

• UpdateItem

• ItemChanges

• ItemChange

• ItemId

• Updates (Item)

• DeleteItemField

• FieldURI

成功した応答の例

説明

次の例は、UpdateItem 要求に対する正常な 応答を示 しています。

コード

<?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="https://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <UpdateItemResponse 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: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>

コメント

アイテム識別子と変更キーは、読みやすさを維持するために短縮されました。

成功した応答要素

応答では、次の要素が使用されます。

• ServerVersionInfo

• UpdateItemResponse

• ResponseMessages

• UpdateItemResponseMessage

• ResponseCode

• Items

• Message

• ItemId

関連項目

UpdateItem 操作 (タスク)

UpdateItem 操作 (連絡先)

• EWS XML 要素 (Exchange

連絡先の更新

タスクの更新