Opération PerformReminderAction

Article
03/29/2023

Recherchez des informations sur l’opération EWS PerformReminderAction .

L’opération PerformReminderAction Exchange Web Services (EWS) lance une action ignorer ou répéter sur un rappel.

Cette opération est une nouveauté d’Exchange Server 2013.

Utilisation de l’opération PerformReminderAction

Vous pouvez utiliser l’opération PerformReminderAction pour ignorer ou répéter (retarder) les rappels retournés par l’opération GetReminders . Pour répéter un rappel, définissez ActionType sur Snooze et définissez la valeur NewReminderTime sur une heure ultérieure à la valeur ReminderTime actuelle, sinon le NewReminderTime est ignoré par le serveur. Si le rappel concerne une occurrence d’une réunion périodique et que l’action Répéter est effectuée sur le rappel avec un NewReminderTime qui est passé le rappel de l’occurrence suivante, le rappel est effectivement ignoré.

Pour ignorer un rappel, définissez ActionType sur Ignorer. Lorsque le serveur traite la requête, le serveur modifie la valeur IsReminderSet de l’élément de True à False.

En-têtes SOAP de l’opération PerformReminderAction

L’opération PerformReminderAction peut utiliser les en-têtes SOAP répertoriés dans le tableau suivant.

Nom de l'en-tête	Élément	Description
Imitation	ExchangeImpersonation	Identifie l’utilisateur que l’application cliente emprunte l’identité. Cet en-tête s’applique à une requête.
MailboxCulture	MailboxCulture	Identifie la culture, telle que définie dans la RFC 3066, « Balises pour l’identification des langues », à utiliser pour accéder à la boîte aux lettres. Cet en-tête s’applique à une requête.
RequestVersion	RequestServerVersion	Identifie la version du schéma pour la demande d’opération. Cet en-tête s’applique à une requête.
ServerVersion	ServerVersionInfo	Identifie la version du serveur qui a répondu à la requête. Cet en-tête s’applique à une réponse.

Exemple de demande d’opération PerformReminderAction

L’exemple suivant de demande d’opération PerformReminderAction montre comment répéter un rappel actuel et définir une nouvelle heure de rappel. Notez que vous devez inclure la touche ChangeKey pour l’ÉlémentId et que NewReminderTime doit être définie sur une heure ultérieure à la valeur ReminderTime renvoyée par l’opération GetReminders .

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <t:RequestServerVersion Version="Exchange2013" />
  </soap:Header>
  <soap:Body>
    <m:PerformReminderAction>
      <m:ReminderItemActions>
        <t:ReminderItemAction>
          <t:ActionType>Snooze</t:ActionType>
          <t:ItemId Id="vwAAAA=="
           ChangeKey="DwAAABQAAACOs0HEMq1WTKpI7sNu5qXNAAAUDA=="/>
          <t:NewReminderTime>2014-04-16T17:00:00Z</t:NewReminderTime>
        </t:ReminderItemAction>
      </m:ReminderItemActions>
    </m:PerformReminderAction>
  </soap:Body>
</soap:Envelope>

Remarque

La valeur ItemId a été raccourcie pour préserver la lisibilité.

Le corps SOAP de la demande contient les éléments suivants :

Réponse de l’opération PerformReminderAction réussie

L’exemple suivant montre une réponse réussie à une demande d’opération PerformReminderAction . L’élément UpdatedItemIds contient les ItemIds de l’élément de calendrier mis à jour.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <ServerVersionInfo MajorVersion="15"
                       MinorVersion="0"
                       MajorBuildNumber="921"
                       MinorBuildNumber="20"
                       Version="V2_10"
                       xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <PerformReminderActionResponse ResponseClass="Success"
                                   xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
      <UpdatedItemIds>
        <ItemId Id="vwAAAA=="
                ChangeKey="DwAAABYAAAB4to43JyybTYwHLBM1k8MxAAAJKP+S"/>
      </UpdatedItemIds>
    </PerformReminderActionResponse>
  </s:Body>
</s:Envelope>

Le corps SOAP de la réponse contient les éléments suivants :

Exemple de réponse d’erreur d’opération PerformReminderAction

L’exemple suivant montre une réponse à une demande d’opération PerformReminderAction quand aucune modification n’a été apportée sur le serveur. Il s’agit d’une réponse dans laquelle une demande a été envoyée, mais aucun UpdatedItemIds n’a été retourné, ce qui signifie qu’aucun rappel n’a été modifié.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <ServerVersionInfo MajorVersion="15"
                       MinorVersion="0"
                       MajorBuildNumber="918"
                       MinorBuildNumber="7"
                       Version="V2_10"
                       xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <PerformReminderActionResponse ResponseClass="Success"
                                   xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
      <UpdatedItemIds />
    </PerformReminderActionResponse>
  </s:Body>
</s:Envelope>

Le corps SOAP de la réponse d’erreur contient les éléments suivants :

Pour obtenir des codes d’erreur supplémentaires génériques pour EWS, consultez ResponseCode.

Voir aussi

Opération GetReminders

Partager via