Операция UpdateInboxRules

Операция UpdateInboxRules обновляет правила папки "Входящие" пользователя, прошедшего проверку подлинности, путем применения указанных операций. UpdateInboxRules используется для создания правила папки "Входящие", установки правила папки "Входящие" или удаления правила папки "Входящие".

При использовании операции UpdateInboxRules веб-службы Exchange удаляют правила отправки на стороне клиента. Правила отправки на стороне клиента хранятся на клиенте в сообщении FAI, связанном с правилом, и нигде. EWS удаляет это сообщение FAI правила по умолчанию, исходя из ожидания, что Outlook повторно создаст его. Однако Outlook не может воссоздать правила, которые также не существуют в качестве расширенного правила, а правила отправки на стороне клиента не существуют как расширенные правила. В результате эти правила теряются. Мы рекомендуем учитывать это при разработке решения.

Пример запроса UpdateInboxRules (создание правила)

Веб-службы Exchange можно использовать для создания правила папки "Входящие" в почтовом ящике пользователя в хранилище Exchange. Используйте элемент UpdateInboxRules в сочетании с элементом CreateRuleOperation для создания правила.

Описание

Клиент создает XML-код запроса и отправляет его на сервер.

Код

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

В этом примере создается правило, которое перемещает сообщение электронной почты в папку Нежелательная почта, если тема электронной почты содержит строку, равную "Интересно".

Элементы запроса

Запрос UpdateInboxRules включает следующие элементы:

• MailboxSmtpAddress

• RemoveOutlookRuleBlob

• Операции

Элемент Operations содержит элемент CreateRuleOperation для создания правила.

Пример ответа UpdateInboxRules (создание правила)

Описание

В следующем примере текста протокола SOAP показан успешный ответ на запрос UpdateInboxRules , создающий правило.

Код

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

Элементы успешного отклика

В ответе используются следующие элементы:

• ServerVersionInfo

• UpdateInboxRulesResponse

• ResponseMessages

• ResponseCode

Пример запроса UpdateInboxRules (Set Rule)

Веб-службы Exchange можно использовать для изменения правила папки "Входящие" в почтовом ящике пользователя в хранилище Exchange. Используйте элемент UpdateInboxRules в сочетании с элементом SetRuleOperation для изменения правила.

Описание

Клиент создает XML-код запроса и отправляет его на сервер.

Код

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

В этом примере отображаемое имя изменяется на "(Изменено) Это является нежелательным".

Примечание.

Значения атрибутов Id и ChangeKey элемента FolderId сокращены для удобства чтения.

Элементы запроса

Запрос UpdateInboxRules включает следующие элементы:

• MailboxSmtpAddress

• RemoveOutlookRuleBlob

• Операции

Элемент Operations содержит элемент SetRuleOperation для изменения правила.

Пример ответа UpdateInboxRules (Set Rule)

Описание

В следующем примере текста протокола SOAP показан успешный ответ на запрос UpdateInboxRules , изменяющий правило.

Код

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

Элементы успешного отклика

В ответе используются следующие элементы:

• ServerVersionInfo

• UpdateInboxRulesResponse

• ResponseMessages

• ResponseCode

Пример запроса UpdateInboxRules (правило удаления)

Веб-службы Exchange можно использовать для удаления правила папки "Входящие" в почтовом ящике пользователя в хранилище Exchange. Используйте UpdateInboxRules в сочетании с элементом DeleteRuleOperation для удаления правила.

Описание

Клиент создает XML-код запроса и отправляет его на сервер.

Код

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

В этом примере удаляется существующее идентифицированное правило.

Элементы запроса

Запрос UpdateInboxRules включает следующие элементы:

• MailboxSmtpAddress

• RemoveOutlookRuleBlob

• Операции

Элемент Operations содержит элемент DeleteRuleOperation для удаления правила.

Пример ответа UpdateInboxRules (правило удаления)

Описание

В следующем примере текста протокола SOAP показан успешный ответ на запрос UpdateInboxRules , который удаляет правило.

Код

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

Элементы успешного отклика

В ответе используются следующие элементы:

• ServerVersionInfo

• UpdateInboxRulesResponse

• ResponseMessages

• ResponseCode

См. также

Операция GetInboxRules