Operación de UpdateInboxRulesUpdateInboxRules operation

La operación UpdateInboxRules actualiza las reglas de la bandeja de entrada del usuario autenticado mediante la aplicación de las operaciones especificadas.The UpdateInboxRules operation updates the authenticated user's Inbox rules by applying the specified operations. UpdateInboxRules se usa para crear una regla de bandeja de entrada, para establecer una regla de bandeja de entrada o para eliminar una regla de bandeja de entrada.UpdateInboxRules is used to create an Inbox rule, to set an Inbox rule, or to delete an Inbox rule.

Cuando se usa la operación UpdateInboxRules , servicios web Exchange elimina las reglas de envío del lado cliente.When you use the UpdateInboxRules operation, Exchange Web Services deletes client-side send rules. Las reglas de envío del lado cliente se almacenan en el cliente en el Mensaje de información asociada de carpetas (FAI) de la regla y en ningún otro lugar.Client-side send rules are stored on the client in the rule Folder Associated Information (FAI) Message and nowhere else. EWS elimina este mensaje FAI de la regla de manera predeterminada, basándose en la expectativa de que Outlook volverá a crearlo.EWS deletes this rule FAI message by default, based on the expectation that Outlook will recreate it. En cambio, Outlook no puede volver a crear reglas que tampoco existen como una regla extendida, y las reglas de envío del lado cliente no existen como reglas extendidas.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. Como resultado, estas reglas se pierden.As a result, these rules are lost. Le sugerimos que considere esta posibilidad al diseñar su solución.We suggest you consider this when designing your solution.

Ejemplo de solicitud UpdateInboxRules (Create Rule)UpdateInboxRules (Create Rule) request example

Puede usar los servicios web Exchange para crear una regla de bandeja de entrada en el buzón de un usuario en el almacén de Exchange.You can use Exchange Web Services to create an Inbox rule in a user's mailbox in the Exchange store. Use el elemento UpdateInboxRules junto con el elemento CreateRuleOperation para crear una regla.Use the UpdateInboxRules element in conjunction with the CreateRuleOperation element to create a rule.

DescriptionDescription

El cliente crea el XML de la solicitud y lo envía al servidor.The client constructs the request XML and sends it to the server.

CódigoCode

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

ComentariosComments

En este ejemplo se crea una regla que moverá un mensaje de correo electrónico a la carpeta correo electrónico no deseado si el asunto del correo electrónico contiene una cadena que es igual a "interesante".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".

Elementos de solicitudRequest elements

La solicitud UpdateInboxRules incluye los siguientes elementos:The UpdateInboxRules request includes the following elements:

El elemento Operations contiene el elemento CreateRuleOperation para crear una regla.The Operations element contains the CreateRuleOperation element to create a rule.

Ejemplo de respuesta UpdateInboxRules (Create Rule)UpdateInboxRules (Create Rule) response example

DescriptionDescription

El siguiente ejemplo del cuerpo del Protocolo simple de acceso a objetos (SOAP) muestra una respuesta correcta a la solicitud UpdateInboxRules que crea una regla.The following Simple Object Access Protocol (SOAP) body example shows a successful response to the UpdateInboxRules request that creates a rule.

CódigoCode

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

Elementos Response correctoSuccessful response elements

En la respuesta se usan los siguientes elementos:The following elements are used in the response:

Ejemplo de solicitud de UpdateInboxRules (Set Rule)UpdateInboxRules (Set Rule) request example

Puede usar los servicios web Exchange para modificar una regla de bandeja de entrada en el buzón de un usuario en el almacén de Exchange.You can use Exchange Web Services to modify an Inbox rule in a user's mailbox in the Exchange store. Use el elemento UpdateInboxRules junto con el elemento SetRuleOperation para modificar una regla.Use the UpdateInboxRules element in conjunction with the SetRuleOperation element to modify a rule.

DescriptionDescription

El cliente crea el XML de la solicitud y lo envía al servidor.The client constructs the request XML and sends it to the server.

CódigoCode

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

ComentariosComments

En este ejemplo se cambia el nombre para mostrar por "(modificado) se trata de correo no deseado".This example changes the display name to "(Modified) This is Junk".

Nota

Los valores de los atributos ID y changekey del elemento FolderId se han abreviado para facilitar su lectura.The values of the Id and ChangeKey attributes of the FolderId element have been shortened for readability.

Elementos de solicitudRequest elements

La solicitud UpdateInboxRules incluye los siguientes elementos:The UpdateInboxRules request includes the following elements:

El elemento Operations contiene el elemento SetRuleOperation para modificar una regla.The Operations element contains the SetRuleOperation element to modify a rule.

Ejemplo de respuesta UpdateInboxRules (Set Rule)UpdateInboxRules (Set Rule) response example

DescriptionDescription

El siguiente ejemplo del cuerpo del Protocolo simple de acceso a objetos (SOAP) muestra una respuesta correcta a la solicitud UpdateInboxRules que modifica una regla.The following Simple Object Access Protocol (SOAP) body example shows a successful response to the UpdateInboxRules request that modifies a rule.

CódigoCode

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

Elementos Response correctoSuccessful response elements

En la respuesta se usan los siguientes elementos:The following elements are used in the response:

Ejemplo de solicitud UpdateInboxRules (Delete Rule)UpdateInboxRules (Delete Rule) request example

Puede usar los servicios web Exchange para eliminar una regla de bandeja de entrada en el buzón de un usuario en el almacén de Exchange.You can use Exchange Web Services to delete an Inbox rule in a user's mailbox in the Exchange store. Use UpdateInboxRules junto con el elemento DeleteRuleOperation para eliminar una regla.Use the UpdateInboxRules in conjunction with the DeleteRuleOperation element to delete a rule.

DescriptionDescription

El cliente crea el XML de la solicitud y lo envía al servidor.The client constructs the request XML and sends it to the server.

CódigoCode

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

ComentariosComments

En este ejemplo se elimina la regla identificada existente.This example deletes the existing identified rule.

Elementos de solicitudRequest elements

La solicitud UpdateInboxRules incluye los siguientes elementos:The UpdateInboxRules request includes the following elements:

El elemento Operations contiene el elemento DeleteRuleOperation para eliminar una regla.The Operations element contains the DeleteRuleOperation element to delete a rule.

Ejemplo de respuesta UpdateInboxRules (Delete Rule)UpdateInboxRules (Delete Rule) response example

DescriptionDescription

El siguiente ejemplo del cuerpo del Protocolo simple de acceso a objetos (SOAP) muestra una respuesta correcta a la solicitud UpdateInboxRules que elimina una regla.The following Simple Object Access Protocol (SOAP) body example shows a successful response to the UpdateInboxRules request that deletes a rule.

CódigoCode

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

Elementos Response correctoSuccessful response elements

En la respuesta se usan los siguientes elementos:The following elements are used in the response:

Vea tambiénSee also

Operación de GetInboxRulesGetInboxRules operation