Compartilhar via

Operação UpdateInboxRules

  • Artigo

A operação UpdateInboxRules atualiza as regras de caixa de entrada do usuário autenticado aplicando as operações especificadas. UpdateInboxRules é usado para criar uma regra de caixa de entrada, para definir uma regra de caixa de entrada ou para excluir uma regra de caixa de entrada.

Quando você usa a operação UpdateInboxRules , o Exchange Web Services exclui as regras de envio do lado do cliente. As regras de envio do lado do cliente são armazenadas no cliente na mensagem FAI (Informações Associadas à Pasta de Regra) e em nenhum outro lugar. O EWS exclui essa mensagem fai de regra por padrão, com base na expectativa de que o Outlook a recriará. No entanto, o Outlook não pode recriar regras que também não existem como uma regra estendida e as regras de envio do lado do cliente não existem como regras estendidas. Como resultado, essas regras são perdidas. Sugerimos que você considere isso ao projetar sua solução.

Exemplo de solicitação UpdateInboxRules (Criar Regra)

Você pode usar os Serviços Web do Exchange para criar uma regra de caixa de entrada na caixa de correio de um usuário na exchange store. Use o elemento UpdateInboxRules em conjunto com o elemento CreateRuleOperation para criar uma regra.

Descrição

O cliente constrói a solicitação XML e a envia para o 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>

Comments

Este exemplo cria uma regra que moverá uma mensagem de email para a pasta Lixo eletrônico se o assunto de email contiver uma cadeia de caracteres igual a "Interessante".

Elementos de solicitação

A solicitação UpdateInboxRules inclui os seguintes elementos:

O elemento Operations contém o elemento CreateRuleOperation para criar uma regra.

Exemplo de resposta UpdateInboxRules (Criar Regra)

Descrição

O exemplo de corpo soap (Protocolo de Acesso a Objeto Simples) a seguir mostra uma resposta bem-sucedida à solicitação UpdateInboxRules que cria uma regra.

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 resposta bem-sucedidos

Os seguintes elementos são usados na resposta:

Exemplo de solicitação UpdateInboxRules (Definir Regra)

Você pode usar o Exchange Web Services para modificar uma regra de caixa de entrada na caixa de correio de um usuário na exchange store. Use o elemento UpdateInboxRules em conjunto com o elemento SetRuleOperation para modificar uma regra.

Descrição

O cliente constrói a solicitação XML e a envia para o 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>

Comments

Este exemplo altera o nome de exibição para "(Modificado) This is Junk".

Observação

Os valores dos atributos Id e ChangeKey do elemento FolderId foram abreviados para legibilidade.

Elementos de solicitação

A solicitação UpdateInboxRules inclui os seguintes elementos:

O elemento Operations contém o elemento SetRuleOperation para modificar uma regra.

Exemplo de resposta UpdateInboxRules (Definir Regra)

Descrição

O exemplo de corpo SOAP (Protocolo de Acesso a Objeto Simples) a seguir mostra uma resposta bem-sucedida à solicitação UpdateInboxRules que modifica uma regra.

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 resposta bem-sucedidos

Os seguintes elementos são usados na resposta:

Exemplo de solicitação UpdateInboxRules (Excluir Regra)

Você pode usar os Serviços Web do Exchange para excluir uma regra de caixa de entrada na caixa de correio de um usuário na loja do Exchange. Use o UpdateInboxRules em conjunto com o elemento DeleteRuleOperation para excluir uma regra.

Descrição

O cliente constrói a solicitação XML e a envia para o 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>

Comments

Este exemplo exclui a regra identificada existente.

Elementos de solicitação

A solicitação UpdateInboxRules inclui os seguintes elementos:

O elemento Operations contém o elemento DeleteRuleOperation para excluir uma regra.

Exemplo de resposta UpdateInboxRules (Excluir Regra)

Descrição

O exemplo de corpo soap (Protocolo de Acesso a Objeto Simples) a seguir mostra uma resposta bem-sucedida à solicitação UpdateInboxRules que exclui uma regra.

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 resposta bem-sucedidos

Os seguintes elementos são usados na resposta:

Confira também

Operação GetInboxRules