GetReminders-Vorgang

Artikel
03/29/2023

Hier finden Sie Informationen zum EWS-Vorgang GetReminders .

Der Vorgang GetReminders Exchange Web Services (EWS) ruft Erinnerungen für Kalender- und Aufgabenelemente ab.

Dieser Vorgang wurde in Exchange Server 2013 eingeführt.

Verwenden des GetReminders-Vorgangs

Der GetReminders-Vorgang ruft Erinnerungen für aktuelle und zukünftige Kalender- und Aufgabenelemente im Postfach des Benutzers ab, abhängig von den elementwerten, die in der Anforderung übergeben werden. Der Vorgang kann alle aktuellen und zukünftigen Kalenderelemente sowie Aufgaben abrufen, für die eine Erinnerung festgelegt ist. Private Kalenderelemente sind in Antworten enthalten. Aufgaben ohne Erinnerungen sind weder in Antworten enthalten noch E-Mails mit Erinnerungen oder Nachverfolgungsflags.

Um alle aktuellen Erinnerungen abzurufen, empfehlen wir, reminderType auf Alle und EndTime auf die aktuelle Uhrzeit festzulegen.

Wenn die Elemente BeginTime und EndTime in der Anforderung enthalten sind, enthält die Antwort Erinnerungen für alle Kalender- und Aufgabenelemente, die zwischen einer Erinnerung zwischen BeginTime und EndTime auftreten.

In der folgenden Tabelle wird das Verhalten des ReminderType-Elements beschrieben, wenn die Elemente BeginTime und EndTime enthalten sind.

ReminderType-Elementwert	Beschreibung
Alle	Erinnerungen, die zwischen BeginTime und EndTime auftreten.
Current	Von Allen zurückgegebene Erinnerungen sowie Erinnerungen, die vor dem angeforderten Zeitfenster liegen, wenn das Ereignis noch andauert, plus alle Termine unabhängig vom Alter.
Alt	Von Allen zurückgegebene Erinnerungen, abzüglich aller Ereignisse, die noch nicht abgeschlossen wurden, abzüglich aller Termine. Die Elemente BeginTime und EndTime müssen so festgelegt werden, dass sie den Old-Wert verwenden.

SOAP-Header des GetReminders-Vorgangs

Der GetReminders-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 getReminders-Vorgangsanforderung

Das folgende Beispiel einer GetReminders-Vorgangsanforderung zeigt, wie die ersten fünf Kalenderelemente abgerufen werden, die zwischen BeginTime und EndTime auftreten.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="http://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:GetReminders>
      <m:EndTime>2014-04-16T21:00:00Z</m:EndTime>
      <m:ReminderType>All</m:ReminderType>
    </m:GetReminders>
  </soap:Body>
</soap:Envelope>

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

Der SOAP-Text kann auch die folgenden Elemente enthalten:

Erfolgreiche GetReminders-Vorgangsantwort

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine GetReminders-Vorgangsanforderung . Die Antwort enthält eine Erinnerung für das Kalenderelement "Teambesprechung" und eine Erinnerung für die Aufgabe "Aufgabe zum Senden von Besprechungsnotizen".

Hinweis

Bezeichner wurden gekürzt, um die Lesbarkeit zu erhalten.

<?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="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns="http://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">
    <GetRemindersResponse ResponseClass="Success"
                          xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
      <Reminders>
        <Reminder xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
          <Subject>Team meeting</Subject>
          <Location />
          <ReminderTime>2014-04-15T21:00:00Z</ReminderTime>
          <StartDate>2014-04-15T21:00:00Z</StartDate>
          <EndDate>2014-04-15T21:30:00Z</EndDate>
          <ItemId Id="vQAAAA=="
                  ChangeKey="DwAAABYAAAB4to43JyybTYwHLBM1k8MxAAACRoV4" />
          <RecurringMasterItemId Id="K7u5AAA=" ChangeKey="DwAAABYAAAB4to43JyybTYwHLBM1k8MxAAACRoV0" />
          <ReminderGroup>Calendar</ReminderGroup>
          <UID>6CF2FA62</UID>
        </Reminder>
        <Reminder xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
          <Subject>Task to send meeting notes</Subject>
          <Location />
          <ReminderTime>2014-04-16T14:00:00Z</ReminderTime>
          <StartDate>0001-01-02T00:00:00Z</StartDate>
          <EndDate>0001-01-02T00:00:00Z</EndDate>
          <ItemId Id="vAAAAA=="
                  ChangeKey="EwAAABQAAACOs0HEMq1WTKpI7sNu5qXNAAAIDg==" />
          <ReminderGroup>Task</ReminderGroup>
          <UID>vAAAAA==</UID>
        </Reminder>
      </Reminders>
    </GetRemindersResponse>
  </s:Body>
</s:Envelope>

Der SOAP-Antworttext enthält die folgenden Elemente:

Beispiel für getReminders-Vorgangsfehlerantwort

Das folgende Beispiel zeigt eine Fehlerantwort auf eine GetReminders-Vorgangsanforderung . Dies ist eine Antwort auf eine Anforderung, bei der das Enddatum vor dem Startdatum lag.

<?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="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns="http://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">
    <GetRemindersResponse ResponseClass="Error"
                          xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <MessageText>EndDate is earlier than StartDate</MessageText>
      <ResponseCode>ErrorInvalidOperation</ResponseCode>
      <DescriptiveLinkKey>0</DescriptiveLinkKey>
    </GetRemindersResponse>
  </s:Body>
</s:Envelope>

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

Weitere Fehlercodes, die für EWS generisch und für diesen Vorgang spezifisch sind, finden Sie unter ResponseCode.

Siehe auch

PerformReminderAction

Freigeben über