Операция CreateItem (задача)

Статья
03/29/2023

Операция CreateItem создает элементы задач в хранилище Exchange.

Запрос createItem для задачи

Описание

В следующем примере запроса CreateItem показано, как создать элемент задачи в почтовом ящике.

Код

<?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>
    <CreateItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
                xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" 
                MessageDisposition="SaveOnly">
      <Items>
        <t:Task>
          <t:Subject>My task</t:Subject>
          <t:DueDate>2006-10-26T21:32:52</t:DueDate>
          <t:Status>NotStarted</t:Status>
        </t:Task>
      </Items>
    </CreateItem>
  </soap:Body>
</soap:Envelope>

Comments

Запросы для повторяющихся задач изменяются при их получении компьютером, работающим Microsoft Exchange Server 2007 с установленной ролью сервера клиентского доступа. Происходят следующие изменения:

Сохраняется только дата для свойства StartDate (Повторение) диапазона повторений задачи. Временная часть усечена.
Свойство StartDate (Повторение) можно изменить в зависимости от шаблона повторения. Например, если шаблон повторения указан как каждый понедельник, а для параметра StartDate задано значение 26 октября 2006 г. (четверг), startDate корректируется до 30 октября 2006 г., то есть следующего понедельника.
Если задано свойство StartDate задачи, оно обновляется в соответствии с начальной датой (повторение) диапазона повторений. Свойство DueDate задачи также обновляется на основе нового startDate.
Если параметр StartDate не задан, обновляется только свойство DueDate , чтобы оно соответствовало начальной дате (повторение) диапазона повторений.

В следующей таблице показаны изменения, которые сервер клиентского доступа вносит в повторяющуюся задачу с task.Recurrence.Pattern каждого понедельника.

Изменения в повторяющейся задаче

Свойство	Исходное значение	Обновленное значение
Task.StartDate	1 января 2006 г.	30 октября 2006 г.
Task.DueDate	3 января 2006 г.	1 ноября 2006 г.
Task.Recurrence.Range.StartDate	26 октября 2006 г.	30 октября 2006 г.

По умолчанию, если конечная папка не указана, элементы задач создаются в папке Задачи.

Элементы запроса

В запросе используются следующие элементы:

Успешное выполнение задачи CreateItem Response

Описание

В следующем примере показан успешный ответ на запрос CreateItem.

Код

<?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="653" MinorBuildNumber="0" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <CreateItemResponse 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:CreateItemResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Items>
            <t:Task>
              <t:ItemId Id="AAAtAE=" ChangeKey="EwAAABYA"/>
            </t:Task>
          </m:Items>
        </m:CreateItemResponseMessage>
      </m:ResponseMessages>
    </CreateItemResponse>
  </soap:Body>
</soap:Envelope>