Operação CreateItem (tarefa)

Artigo
03/29/2023

A operação CreateItem cria itens de tarefa no repositório exchange.

Solicitação CreateItem de Tarefas

Descrição

O exemplo a seguir de uma solicitação CreateItem mostra como criar um item de tarefa em uma caixa de correio.

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>

Comments

As solicitações de tarefas recorrentes são alteradas quando são recebidas pelo computador que está executando Microsoft Exchange Server 2007 que tem a função de servidor do Client Access instalada. As seguintes alterações ocorrem:

Somente a data é salva para a propriedade StartDate (Recorrência) do intervalo de recorrência da tarefa. A parte de tempo é truncada.
A propriedade StartDate (Recorrência) pode ser ajustada, dependendo do padrão de recorrência. Por exemplo, se o padrão de recorrência for especificado como todas as segundas-feiras e o StartDate estiver definido como 26 de outubro de 2006, que é uma quinta-feira, StartDate será ajustado para 30 de outubro de 2006, que é a próxima segunda-feira.
Se a propriedade StartDate da tarefa for definida, ela será atualizada para corresponder ao StartDate (Recorrência) do intervalo de recorrência. A propriedade DueDate da tarefa também é atualizada com base no novo StartDate.
Se o StartDate não estiver definido, somente a propriedade DueDate será atualizada para corresponder ao StartDate (Recorrência) do intervalo de recorrência.

A tabela a seguir mostra as alterações que o servidor de Acesso ao Cliente faz em uma tarefa recorrente que tem uma Tarefa.Recorrência.Padrão de todas as segundas-feiras.

Alterações em uma tarefa recorrente

Propriedade	Valor original	Valor atualizado
Task.StartDate	1 de janeiro de 2006	30 de outubro de 2006
Task.DueDate	3 de janeiro de 2006	1 de novembro de 2006
Task.Recurrence.Range.StartDate	26 de outubro de 2006	30 de outubro de 2006

Por padrão, se uma pasta de destino não for especificada, os itens de tarefa serão criados na pasta Tarefas.

Elementos de solicitação

Os seguintes elementos são usados na solicitação:

Resposta createItem de tarefa bem-sucedida

Descrição

O exemplo a seguir mostra uma resposta bem-sucedida à solicitação 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>