Opération de UpdateInboxRulesUpdateInboxRules operation

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.The UpdateInboxRules operation updates the authenticated user's Inbox rules by applying the specified operations. UpdateInboxRules permet de créer une règle de boîte de réception, de définir une règle de boîte de réception ou de supprimer une règle de boîte de réception.UpdateInboxRules is used to create an Inbox rule, to set an Inbox rule, or to delete an Inbox rule.

Lorsque vous utilisez l’opération UpdateInboxRules , les services Web Exchange suppriment les règles d’envoi côté client.When you use the UpdateInboxRules operation, Exchange Web Services deletes client-side send rules. Les règles d’envoi côté client sont stockées sur le client dans le message du dossier de la règle (FAI) et nulle part ailleurs.Client-side send rules are stored on the client in the rule Folder Associated Information (FAI) Message and nowhere else. EWS supprime cette règle par défaut, en fonction de la prévision qu’Outlook va recréer.EWS deletes this rule FAI message by default, based on the expectation that Outlook will recreate it. Toutefois, Outlook ne peut pas recréer des règles qui n’existent pas également en tant que règle étendue, et les règles d’envoi côté client n’existent pas en tant que règles étendues.However, Outlook can't recreate rules that don't also exist as an extended rule, and client-side send rules don't exist as extended rules. Par conséquent, ces règles sont perdues.As a result, these rules are lost. Nous vous suggérons de vous en prendre en compte lors de la conception de votre solution.We suggest you consider this when designing your solution.

Exemple de requête UpdateInboxRules (Create Rule)UpdateInboxRules (Create Rule) request example

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 la Banque d’aide Exchange.You can use Exchange Web Services to create an Inbox rule in a user's mailbox in the Exchange store. Utilisez l’élément UpdateInboxRules en association avec l’élément CreateRuleOperation pour créer une règle.Use the UpdateInboxRules element in conjunction with the CreateRuleOperation element to create a rule.

DescriptionDescription

Le client construit le code XML de la demande et l’envoie au serveur.The client constructs the request XML and sends it to the server.

CodeCode

<?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="https://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="https://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>

CommentairesComments

Cet exemple illustre la création d’une règle qui déplace un message électronique vers le dossier courrier indésirable si l’objet de l’e-mail contient une chaîne égale à « intéressante ».This example builds a rule that will move an e-mail message to the Junk E-mail folder if the e-mail subject contains a string that equals "Interesting".

Demander des élémentsRequest elements

La requête UpdateInboxRules inclut les éléments suivants :The UpdateInboxRules request includes the following elements:

L’élément Operations contient l’élément CreateRuleOperation pour créer une règle.The Operations element contains the CreateRuleOperation element to create a rule.

Exemple de réponse UpdateInboxRules (Create Rule)UpdateInboxRules (Create Rule) response example

DescriptionDescription

L’exemple de corps SOAP (Simple Object Access Protocol) suivant montre une réponse réussie à la demande UpdateInboxRules qui crée une règle.The following Simple Object Access Protocol (SOAP) body example shows a successful response to the UpdateInboxRules request that creates a rule.

CodeCode

<?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="https://schemas.microsoft.com/exchange/services/2006/types" 
        xmlns="https://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="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
    </UpdateInboxRulesResponse>
  </s:Body>
</s:Envelope>

Éléments de réponse réussisSuccessful response elements

Les éléments suivants sont utilisés dans la réponse :The following elements are used in the response:

Exemple de requête UpdateInboxRules (Set Rule)UpdateInboxRules (Set Rule) request example

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’aide Exchange.You can use Exchange Web Services to modify an Inbox rule in a user's mailbox in the Exchange store. Utilisez l’élément UpdateInboxRules en association avec l’élément SetRuleOperation pour modifier une règle.Use the UpdateInboxRules element in conjunction with the SetRuleOperation element to modify a rule.

DescriptionDescription

Le client construit le code XML de la demande et l’envoie au serveur.The client constructs the request XML and sends it to the server.

CodeCode

<?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="https://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="https://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="https://schemas.microsoft.com/exchange/services/2006/messages">
          <SetRuleOperation xmlns="https://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>

CommentairesComments

Cet exemple montre comment modifier le nom complet en « (modifié) This is junk ».This example changes the display name to "(Modified) This is Junk".

Notes

Les valeurs des attributs ID et ChangeKey de l’élément FolderId ont été raccourcies pour des raisons de lisibilité.The values of the Id and ChangeKey attributes of the FolderId element have been shortened for readability.

Demander des élémentsRequest elements

La requête UpdateInboxRules inclut les éléments suivants :The UpdateInboxRules request includes the following elements:

L’élément Operations contient l’élément SetRuleOperation pour modifier une règle.The Operations element contains the SetRuleOperation element to modify a rule.

Exemple de réponse UpdateInboxRules (Set Rule)UpdateInboxRules (Set Rule) response example

DescriptionDescription

L’exemple de corps SOAP (Simple Object Access Protocol) suivant montre une réponse réussie à la demande UpdateInboxRules qui modifie une règle.The following Simple Object Access Protocol (SOAP) body example shows a successful response to the UpdateInboxRules request that modifies a rule.

CodeCode

<?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="https://schemas.microsoft.com/exchange/services/2006/types" 
        xmlns="https://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="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
    </UpdateInboxRulesResponse>
  </s:Body>
</s:Envelope>

Éléments de réponse réussisSuccessful response elements

Les éléments suivants sont utilisés dans la réponse :The following elements are used in the response:

Exemple de requête UpdateInboxRules (Delete Rule)UpdateInboxRules (Delete Rule) request example

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 la Banque d’aide Exchange.You can use Exchange Web Services to delete an Inbox rule in a user's mailbox in the Exchange store. Utilisez l' UpdateInboxRules en association avec l’élément DeleteRuleOperation pour supprimer une règle.Use the UpdateInboxRules in conjunction with the DeleteRuleOperation element to delete a rule.

DescriptionDescription

Le client construit le code XML de la demande et l’envoie au serveur.The client constructs the request XML and sends it to the server.

CodeCode

<?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="https://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="https://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>

CommentairesComments

Cet exemple supprime la règle identifiée existante.This example deletes the existing identified rule.

Demander des élémentsRequest elements

La requête UpdateInboxRules inclut les éléments suivants :The UpdateInboxRules request includes the following elements:

L’élément Operations contient l’élément DeleteRuleOperation pour supprimer une règle.The Operations element contains the DeleteRuleOperation element to delete a rule.

Exemple de réponse UpdateInboxRules (Delete Rule)UpdateInboxRules (Delete Rule) response example

DescriptionDescription

L’exemple de corps SOAP (Simple Object Access Protocol) suivant montre une réponse réussie à la demande UpdateInboxRules qui supprime une règle.The following Simple Object Access Protocol (SOAP) body example shows a successful response to the UpdateInboxRules request that deletes a rule.

CodeCode

<?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="https://schemas.microsoft.com/exchange/services/2006/types" 
        xmlns="https://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="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
    </UpdateInboxRulesResponse>
  </s:Body>
</s:Envelope>

Éléments de réponse réussisSuccessful response elements

Les éléments suivants sont utilisés dans la réponse :The following elements are used in the response:

Voir aussiSee also

Opération de GetInboxRulesGetInboxRules operation