Partager via

Opération UpdateInboxRules

  • Article

L’opération UpdateInboxRules met à jour les règles de boîte de réception de l’utilisateur authentifié en appliquant les opérations spécifiées. UpdateInboxRules est utilisé pour créer une règle de boîte de réception, définir une règle de boîte de réception ou supprimer une règle de boîte de réception.

Lorsque vous utilisez l’opération UpdateInboxRules , les services Web Exchange suppriment les règles d’envoi côté client. Les règles d’envoi côté client sont stockées sur le client dans le message FAI (Folder Associated Information) de règle et nulle part ailleurs. EWS supprime ce message FAI de règle par défaut, en fonction de l’attente qu’Outlook le recrée. Toutefois, Outlook ne peut pas recréer des règles qui n’existent pas en tant que règle étendue, et les règles d’envoi côté client n’existent pas en tant que règles étendues. Par conséquent, ces règles sont perdues. Nous vous suggérons d’en tenir compte lors de la conception de votre solution.

Exemple de requête UpdateInboxRules (Créer une règle)

Vous pouvez utiliser les services web Exchange pour créer une règle de boîte de réception dans la boîte aux lettres d’un utilisateur dans le magasin Exchange. Utilisez l’élément UpdateInboxRules conjointement avec l’élément CreateRuleOperation pour créer une règle.

Description

Le client construit le code XML de la requête et l’envoie au serveur.

Code

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope 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"
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
  <soap:Header>
    <t:RequestServerVersion Version ="Exchange2010_SP1"/>
  </soap:Header>
  <soap:Body>
      <m:UpdateInboxRules>
        <m:RemoveOutlookRuleBlob>true</m:RemoveOutlookRuleBlob>
        <m:Operations>
          <t:CreateRuleOperation>
            <t:Rule>
              <t:DisplayName>MoveInterestingToJunk</t:DisplayName>
              <t:Priority>1</t:Priority>
              <t:IsEnabled>true</t:IsEnabled>
              <t:Conditions>
                <t:ContainsSubjectStrings>
                  <t:String>Interesting</t:String>
                </t:ContainsSubjectStrings>
              </t:Conditions>
              <t:Exceptions />
              <t:Actions>
                <t:MoveToFolder>
                  <t:DistinguishedFolderId Id="junkemail" />
                </t:MoveToFolder>
              </t:Actions>
            </t:Rule>
          </t:CreateRuleOperation>
        </m:Operations>
      </m:UpdateInboxRules>
  </soap:Body>
</soap:Envelope>

Comments

Cet exemple génère une règle qui déplace un message électronique vers le dossier Courrier indésirable si l’objet du courrier électronique contient une chaîne égale à « Intéressant ».

Éléments de requête

La requête UpdateInboxRules inclut les éléments suivants :

L’élément Operations contient l’élément CreateRuleOperation pour créer une règle.

Exemple de réponse UpdateInboxRules (Créer une règle)

Description

L’exemple de corps SOAP (Simple Object Access Protocol) suivant montre une réponse réussie à la requête UpdateInboxRules qui crée une règle.

Code

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

Éléments de réponse réussis

Les éléments suivants sont utilisés dans la réponse :

Exemple de requête UpdateInboxRules (Set Rule)

Vous pouvez utiliser les services web Exchange pour modifier une règle de boîte de réception dans la boîte aux lettres d’un utilisateur dans la banque d’informations Exchange. Utilisez l’élément UpdateInboxRules conjointement avec l’élément SetRuleOperation pour modifier une règle.

Description

Le client construit le code XML de la requête et l’envoie au serveur.

Code

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope 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"
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
  <soap:Header>
    <t:RequestServerVersion Version ="Exchange2010_SP1"/>
  </soap:Header>
  <soap:Body>
      <m:UpdateInboxRules>
        <m:RemoveOutlookRuleBlob>true</m:RemoveOutlookRuleBlob>
        <Operations xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
          <SetRuleOperation xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
            <Rule>
              <RuleId>Nh8AAAAwW/w=</RuleId>
              <DisplayName>(Modified) This is Junk</DisplayName>
              <Priority>1</Priority>
              <IsEnabled>true</IsEnabled>
              <Conditions>
                <ContainsSubjectStrings>
                  <String>Interesting</String>
                </ContainsSubjectStrings>
              </Conditions>
              <Actions>
                <MoveToFolder>
                  <FolderId Id="AAMkADQ1YTE1" ChangeKey="AQAAAA==" />
                </MoveToFolder>
              </Actions>
            </Rule>
          </SetRuleOperation>
        </Operations>
      </m:UpdateInboxRules>
  </soap:Body>
</soap:Envelope>

Comments

Cet exemple montre comment modifier le nom d’affichage en « (Modifié) This is Junk ».

Remarque

Les valeurs des attributs Id et ChangeKey de l’élément FolderId ont été raccourcies pour plus de lisibilité.

Éléments de requête

La requête UpdateInboxRules inclut les éléments suivants :

L’élément Operations contient l’élément SetRuleOperation pour modifier une règle.

Exemple de réponse UpdateInboxRules (Set Rule)

Description

L’exemple de corps SOAP (Simple Object Access Protocol) suivant montre une réponse réussie à la requête UpdateInboxRules qui modifie une règle.

Code

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

Éléments de réponse réussis

Les éléments suivants sont utilisés dans la réponse :

Exemple de requête UpdateInboxRules (Delete Rule)

Vous pouvez utiliser les services web Exchange pour supprimer une règle de boîte de réception dans la boîte aux lettres d’un utilisateur dans le magasin Exchange. Utilisez updateInboxRules conjointement avec l’élément DeleteRuleOperation pour supprimer une règle.

Description

Le client construit le code XML de la requête et l’envoie au serveur.

Code

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope 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"
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
  <soap:Header>
    <t:RequestServerVersion Version ="Exchange2010_SP1"/>
  </soap:Header>
  <soap:Body>
      <m:UpdateInboxRules>
        <m:RemoveOutlookRuleBlob>true</m:RemoveOutlookRuleBlob>
        <m:Operations>
          <t:DeleteRuleOperation>
            <t:RuleId>Nh8AAAAwW/U=</t:RuleId>
          </t:DeleteRuleOperation>
        </m:Operations>
      </m:UpdateInboxRules>
  </soap:Body>
</soap:Envelope>

Comments

Cet exemple supprime la règle identifiée existante.

Éléments de requête

La requête UpdateInboxRules inclut les éléments suivants :

L’élément Operations contient l’élément DeleteRuleOperation pour supprimer une règle.

Exemple de réponse UpdateInboxRules (Delete Rule)

Description

L’exemple de corps SOAP (Simple Object Access Protocol) suivant montre une réponse réussie à la demande UpdateInboxRules qui supprime une règle.

Code

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

Éléments de réponse réussis

Les éléments suivants sont utilisés dans la réponse :

Voir aussi

Opération de GetInboxRules