Operación CreateItem (tarea)

Artículo
03/29/2023

La operación CreateItem crea elementos de tarea en el almacén de Exchange.

Solicitud CreateItem de tarea

Descripción

En el ejemplo siguiente de una solicitud CreateItem se muestra cómo crear un elemento de tarea en un buzón de correo.

Código

<?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>

Comentarios

Las solicitudes de tareas periódicas se modifican cuando el equipo que ejecuta Microsoft Exchange Server 2007 que tiene instalado el rol de servidor acceso de cliente. Se producen los siguientes cambios:

Solo se guarda la fecha de la propiedad StartDate (Recurrence) del intervalo de periodicidad de la tarea. La parte de tiempo se trunca.
La propiedad StartDate (Recurrence) se puede ajustar, en función del patrón de periodicidad. Por ejemplo, si el patrón de periodicidad se especifica como cada lunes y StartDate se establece en el 26 de octubre de 2006, que es un jueves, StartDate se ajusta al 30 de octubre de 2006, que es el lunes siguiente.
Si se establece la propiedad StartDate de la tarea, se actualiza para que coincida con la StartDate (Periodicidad) del intervalo de periodicidad. La propiedad DueDate de la tarea también se actualiza en función del nuevo StartDate.
Si no se establece StartDate , solo se actualiza la propiedad DueDate para que coincida con startdate (periodicidad) del intervalo de periodicidad.

En la tabla siguiente se muestran los cambios que realiza el servidor de acceso de cliente en una tarea periódica que tiene un objeto Task.Recurrence.Pattern de todos los lunes.

Cambios en una tarea periódica

Propiedad	Valor original	Valor actualizado
Task.StartDate	1 de enero de 2006	30 de octubre de 2006
Task.DueDate	3 de enero de 2006	1 de noviembre de 2006
Task.Recurrence.Range.StartDate	26 de octubre de 2006	30 de octubre de 2006

De forma predeterminada, si no se especifica una carpeta de destino, los elementos de tarea se crean en la carpeta Tareas.

Elementos Request

En la solicitud se usan los siguientes elementos:

Respuesta correcta de CreateItem de tarea

Descripción

En el ejemplo siguiente se muestra una respuesta correcta a la solicitud CreateItem.

Código

<?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="https://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>