PerformReminderAction-Vorgang

Hier finden Sie Informationen zum EWS-Vorgang PerformReminderAction .

Der EwS-Vorgang ( PerformReminderAction Exchange Web Services) initiiert eine Verwerfen- oder Snooze-Aktion für eine Erinnerung.

Dieser Vorgang wurde in Exchange Server 2013 eingeführt.

Verwenden des PerformReminderAction-Vorgangs

Sie können den PerformReminderAction-Vorgang verwenden, um erinnerungen, die vom GetReminders-Vorgang zurückgegeben werden, zu verwerfen oder wiederzuverzögern. Wenn Sie eine Erinnerung erneut anzeigen möchten, legen Sie actionType auf Snooze fest, und legen Sie den NewReminderTime-Wert auf eine Zeit nach der aktuellen ReminderTime fest. Andernfalls wird NewReminderTime vom Server ignoriert. Wenn die Erinnerung für das Auftreten einer Besprechungsserie gilt und die Snooze-Aktion für die Erinnerung mit einem NewReminderTime-Wert ausgeführt wird, der über die Erinnerung an das nächste Ereignis hinaus liegt, wird die Erinnerung effektiv verworfen.

Um eine Erinnerung zu schließen, legen Sie ActionType auf Verwerfen fest. Wenn der Server die Anforderung verarbeitet, ändert der Server den IsReminderSet-Wert für das Element von True in False.

PerformReminderAction-Vorgang SOAP-Header

Der PerformReminderAction-Vorgang kann die SOAP-Header verwenden, die in der folgenden Tabelle aufgeführt sind.

Headername Element Beschreibung
Impersonation
ExchangeImpersonation
Identifiziert den Benutzer, für den die Clientanwendung einen Identitätswechsel durchführt. Dieser Header gilt für eine Anforderung.
MailboxCulture
MailboxCulture
Identifiziert die Kultur, wie in RFC 3066 "Tags für die Identifizierung von Sprachen" definiert, die für den Zugriff auf das Postfach verwendet werden soll. Dieser Header gilt für eine Anforderung.
RequestVersion
RequestServerVersion
Gibt die Schemaversion für die Vorgangsanforderung an. Dieser Header gilt für eine Anforderung.
ServerVersion
ServerVersionInfo
Gibt die Version des Servers an, der auf die Anforderung geantwortet hat. Dieser Header gilt für eine Antwort.

Beispiel für eine Anforderung des PerformReminderAction-Vorgangs

Im folgenden Beispiel für eine PerformReminderAction-Vorgangsanforderung wird gezeigt, wie sie eine aktuelle Erinnerung zurückstellen und eine neue Erinnerungszeit festlegen. Beachten Sie, dass Sie den ChangeKey für die ItemId einschließen müssen, und NewReminderTime muss auf einen Zeitpunkt festgelegt werden, der später als die vom GetReminders-Vorgang zurückgegebene ReminderTime ist.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <t:RequestServerVersion Version="Exchange2013" />
  </soap:Header>
  <soap:Body>
    <m:PerformReminderAction>
      <m:ReminderItemActions>
        <t:ReminderItemAction>
          <t:ActionType>Snooze</t:ActionType>
          <t:ItemId Id="vwAAAA=="
           ChangeKey="DwAAABQAAACOs0HEMq1WTKpI7sNu5qXNAAAUDA=="/>
          <t:NewReminderTime>2014-04-16T17:00:00Z</t:NewReminderTime>
        </t:ReminderItemAction>
      </m:ReminderItemActions>
    </m:PerformReminderAction>
  </soap:Body>
</soap:Envelope>

Hinweis

Der ItemId-Wert wurde gekürzt, um die Lesbarkeit zu erhalten.

Der SOAP-Anforderungstext enthält die folgenden Elemente:

Erfolgreiche PerformReminderAction-Vorgangsantwort

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine PerformReminderAction-Vorgangsanforderung . Das UpdatedItemIds-Element enthält die ItemIds des aktualisierten Kalenderelements .

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <ServerVersionInfo MajorVersion="15"
                       MinorVersion="0"
                       MajorBuildNumber="921"
                       MinorBuildNumber="20"
                       Version="V2_10"
                       xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns="https://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <PerformReminderActionResponse ResponseClass="Success"
                                   xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
      <UpdatedItemIds>
        <ItemId Id="vwAAAA=="
                ChangeKey="DwAAABYAAAB4to43JyybTYwHLBM1k8MxAAAJKP+S"/>
      </UpdatedItemIds>
    </PerformReminderActionResponse>
  </s:Body>
</s:Envelope>

Der SOAP-Antworttext enthält die folgenden Elemente:

Beispiel für die Fehlerantwort des PerformReminderAction-Vorgangs

Das folgende Beispiel zeigt eine Antwort auf eine PerformReminderAction-Vorgangsanforderung , wenn keine Änderung auf dem Server vorgenommen wurde. Dies ist eine Antwort, in der eine Anforderung gesendet wurde, aber keine UpdatedItemIds zurückgegeben wurden, was bedeutet, dass keine Erinnerungen geändert wurden.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <ServerVersionInfo MajorVersion="15"
                       MinorVersion="0"
                       MajorBuildNumber="918"
                       MinorBuildNumber="7"
                       Version="V2_10"
                       xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns="https://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <PerformReminderActionResponse ResponseClass="Success"
                                   xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
      <UpdatedItemIds />
    </PerformReminderActionResponse>
  </s:Body>
</s:Envelope>

Der SOAP-Text der Fehlerantwort enthält die folgenden Elemente:

Weitere Fehlercodes, die für EWS generisch sind, finden Sie unter ResponseCode.

Siehe auch