Operación UpdateInboxRules

La operación UpdateInboxRules actualiza las reglas de bandeja de entrada del usuario autenticado aplicando las operaciones especificadas. 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.

Cuando se usa la operación UpdateInboxRules , Exchange Web Services elimina las reglas de envío del lado cliente. 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. EWS elimina este mensaje FAI de la regla de manera predeterminada, basándose en la expectativa de que Outlook volverá a crearlo. 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. Como resultado, estas reglas se pierden. Le sugerimos que considere esta posibilidad al diseñar su solución.

Ejemplo de solicitud UpdateInboxRules (Crear regla)

Puede usar servicios web de Exchange para crear una regla de bandeja de entrada en el buzón de un usuario en el almacén de Exchange. Use el elemento UpdateInboxRules junto con el elemento CreateRuleOperation para crear una regla.

Descripción

El cliente construye el XML de solicitud y lo envía al servidor.

Código

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

Comentarios

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

Elementos Request

La solicitud UpdateInboxRules incluye los siguientes elementos:

• MailboxSmtpAddress

• RemoveOutlookRuleBlob

• Operations

El elemento Operations contiene el elemento CreateRuleOperation para crear una regla.

Ejemplo de respuesta UpdateInboxRules (Crear regla)

Descripción

En el siguiente ejemplo de cuerpo de Simple Object Access Protocol (SOAP) se muestra una respuesta correcta a la solicitud UpdateInboxRules que crea una regla.

Código

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

Elementos de respuesta correctos

Los siguientes elementos se usan en la respuesta:

• ServerVersionInfo

• UpdateInboxRulesResponse

• ResponseMessages

• ResponseCode

Ejemplo de solicitud UpdateInboxRules (Establecer regla)

Puede usar servicios web de Exchange para modificar una regla de bandeja de entrada en el buzón de correo de un usuario en el almacén de Exchange. Use el elemento UpdateInboxRules junto con el elemento SetRuleOperation para modificar una regla.

Descripción

El cliente construye el XML de solicitud y lo envía al servidor.

Código

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

Comentarios

En este ejemplo se cambia el nombre para mostrar a "(Modified) This is Junk".

Nota:

Los valores de los atributos Id y ChangeKey del elemento FolderId se han acortado para mejorar la legibilidad.

Elementos Request

La solicitud UpdateInboxRules incluye los siguientes elementos:

• MailboxSmtpAddress

• RemoveOutlookRuleBlob

• Operations

El elemento Operations contiene el elemento SetRuleOperation para modificar una regla.

Ejemplo de respuesta UpdateInboxRules (establecer regla)

Descripción

En el siguiente ejemplo de cuerpo de Simple Object Access Protocol (SOAP) se muestra una respuesta correcta a la solicitud UpdateInboxRules que modifica una regla.

Código

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

Elementos de respuesta correctos

Los siguientes elementos se usan en la respuesta:

• ServerVersionInfo

• UpdateInboxRulesResponse

• ResponseMessages

• ResponseCode

Ejemplo de solicitud UpdateInboxRules (eliminar regla)

Puede usar servicios web de Exchange para eliminar una regla de bandeja de entrada en el buzón de correo de un usuario en el almacén de Exchange. Use UpdateInboxRules junto con el elemento DeleteRuleOperation para eliminar una regla.

Descripción

El cliente construye el XML de solicitud y lo envía al servidor.

Código

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

Comentarios

En este ejemplo se elimina la regla identificada existente.

Elementos Request

La solicitud UpdateInboxRules incluye los siguientes elementos:

• MailboxSmtpAddress

• RemoveOutlookRuleBlob

• Operations

El elemento Operations contiene el elemento DeleteRuleOperation para eliminar una regla.

Ejemplo de respuesta updateInboxRules (regla de eliminación)

Descripción

En el siguiente ejemplo de cuerpo de Simple Object Access Protocol (SOAP) se muestra una respuesta correcta a la solicitud UpdateInboxRules que elimina una regla.

Código

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

Elementos de respuesta correctos

Los siguientes elementos se usan en la respuesta:

• ServerVersionInfo

• UpdateInboxRulesResponse

• ResponseMessages

• ResponseCode

Vea también

Operación de GetInboxRules