Opération CreateItem (tâche)

Article
03/29/2023

L’opération CreateItem crée des éléments de tâche dans le magasin Exchange.

Demande de création d’élément de tâche

Description

L’exemple suivant de requête CreateItem montre comment créer un élément de tâche dans une boîte aux lettres.

Code

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

Les demandes de tâches périodiques sont modifiées lorsqu’elles sont reçues par l’ordinateur exécutant Microsoft Exchange Server 2007 sur lequel le rôle serveur d’accès au client est installé. Les modifications suivantes se produisent :

Seule la date est enregistrée pour la propriété StartDate (Périodicité) de la plage de périodicité de la tâche. La partie temps est tronquée.
La propriété StartDate (Périodicité) peut être ajustée, en fonction du modèle de périodicité. Par exemple, si le modèle de périodicité est spécifié comme tous les lundis et que startDate est défini sur le 26 octobre 2006, qui est un jeudi, StartDate est ajusté au 30 octobre 2006, qui est le lundi suivant.
Si la propriété StartDate de la tâche est définie, elle est mise à jour pour correspondre à StartDate (Périodicité) de la plage de périodicité. La propriété DueDate de la tâche est également mise à jour en fonction du nouveau StartDate.
Si la valeur StartDate n’est pas définie, seule la propriété DueDate est mise à jour pour correspondre à startDate (périodicité) de la plage de périodicité.

Le tableau suivant présente les modifications apportées par le serveur d’accès au client à une tâche périodique qui a un Task.Recurrence.Pattern de tous les lundis.

Modifications apportées à une tâche périodique

Propriété	Valeur d’origine	Valeur mise à jour
Task.StartDate	1er janvier 2006	30 octobre 2006
Task.DueDate	3 janvier 2006	1er novembre 2006
Task.Recurrence.Range.StartDate	26 octobre 2006	30 octobre 2006

Par défaut, si aucun dossier de destination n’est spécifié, les éléments de tâche sont créés dans le dossier Tâches.

Éléments de requête

Les éléments suivants sont utilisés dans la demande :

Réponse de création d’élément de tâche réussie

Description

L’exemple suivant montre une réponse réussie à la requête CreateItem.

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="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>