UpdateInboxRules-Vorgang
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="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>
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="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>
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="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>
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="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>
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="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>
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="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>
Erfolgreiche Antwortelemente
In der Antwort werden folgende Elemente verwendet:
Siehe auch
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für