Freigeben über

UpdateInboxRules-Vorgang

  • Artikel

Der UpdateInboxRules-Vorgang aktualisiert die Posteingangsregeln des authentifizierten Benutzers, indem die angegebenen Vorgänge angewendet werden. UpdateInboxRules wird zum Erstellen einer Posteingangsregel, zum Festlegen einer Posteingangsregel oder zum Löschen einer Posteingangsregel verwendet.

Wenn Sie den UpdateInboxRules-Vorgang verwenden, werden clientseitige Senderegeln von Exchange-Webdiensten gelöscht. Clientseitige Senderegeln werden auf dem Client in der Regel Folder Associated Information (FAI)-Nachricht und nirgendwo sonst gespeichert. EWS löscht diese REGEL-FAI-Nachricht standardmäßig, basierend auf der Erwartung, dass Outlook sie neu erstellt. Outlook kann jedoch keine Regeln neu erstellen, die nicht auch als erweiterte Regel vorhanden sind, und clientseitige Senderegeln sind nicht als erweiterte Regeln vorhanden. Dadurch gehen diese Regeln verloren. Wir empfehlen Ihnen, dies beim Entwerfen Ihrer Lösung zu berücksichtigen.

UpdateInboxRules -Anforderungsbeispiel (Regel erstellen)

Sie können Exchange-Webdienste verwenden, um eine Posteingangsregel im Postfach eines Benutzers im Exchange-Speicher zu erstellen. Verwenden Sie das UpdateInboxRules-Element in Verbindung mit dem CreateRuleOperation-Element , um eine Regel zu erstellen.

Beschreibung

Der Client erstellt die Anforderungs-XML und sendet sie an den Server.

Code

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

Kommentare

In diesem Beispiel wird eine Regel erstellt, mit der eine E-Mail-Nachricht in den Junk-E-Mail-Ordner verschoben wird, wenn der E-Mail-Betreff eine Zeichenfolge enthält, die gleich "Interessant" ist.

Anfordern von Elementen

Die UpdateInboxRules-Anforderung enthält die folgenden Elemente:

Das Operations-Element enthält das CreateRuleOperation-Element zum Erstellen einer Regel.

Antwortbeispiel für UpdateInboxRules (Regel erstellen)

Beschreibung

Das folgende SOAP-Textbeispiel (Simple Object Access Protocol) zeigt eine erfolgreiche Antwort auf die UpdateInboxRules-Anforderung , die eine Regel erstellt.

Code

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

Erfolgreiche Antwortelemente

In der Antwort werden folgende Elemente verwendet:

UpdateInboxRules (Set Rule)-Anforderungsbeispiel

Sie können Exchange-Webdienste verwenden, um eine Posteingangsregel im Postfach eines Benutzers im Exchange-Speicher zu ändern. Verwenden Sie das UpdateInboxRules-Element in Verbindung mit dem SetRuleOperation-Element , um eine Regel zu ändern.

Beschreibung

Der Client erstellt die Anforderungs-XML und sendet sie an den Server.

Code

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

Kommentare

In diesem Beispiel wird der Anzeigename in "(Modified) This is Junk" geändert.

Hinweis

Die Werte der Id - und ChangeKey-Attribute des FolderId-Elements wurden aus Gründen der Lesbarkeit gekürzt.

Anfordern von Elementen

Die UpdateInboxRules-Anforderung enthält die folgenden Elemente:

Das Operations-Element enthält das SetRuleOperation-Element zum Ändern einer Regel.

UpdateInboxRules -Antwortbeispiel (Regel festlegen)

Beschreibung

Das folgende SOAP-Textbeispiel (Simple Object Access Protocol) zeigt eine erfolgreiche Antwort auf die UpdateInboxRules-Anforderung , die eine Regel ändert.

Code

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

Erfolgreiche Antwortelemente

In der Antwort werden folgende Elemente verwendet:

UpdateInboxRules (Delete Rule)-Anforderungsbeispiel

Sie können Exchange-Webdienste verwenden, um eine Posteingangsregel im Postfach eines Benutzers im Exchange-Speicher zu löschen. Verwenden Sie updateInboxRules in Verbindung mit dem DeleteRuleOperation-Element , um eine Regel zu löschen.

Beschreibung

Der Client erstellt die Anforderungs-XML und sendet sie an den Server.

Code

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

Kommentare

In diesem Beispiel wird die vorhandene identifizierte Regel gelöscht.

Anfordern von Elementen

Die UpdateInboxRules-Anforderung enthält die folgenden Elemente:

Das Operations-Element enthält das DeleteRuleOperation-Element zum Löschen einer Regel.

UpdateInboxRules (Delete Rule)-Antwortbeispiel

Beschreibung

Das folgende SOAP-Textbeispiel (Simple Object Access Protocol) zeigt eine erfolgreiche Antwort auf die UpdateInboxRules-Anforderung , die eine Regel löscht.

Code

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

Erfolgreiche Antwortelemente

In der Antwort werden folgende Elemente verwendet:

Siehe auch

GetInboxRules-Vorgang