Kalender und EWS in Exchange

  • Artikel

Weitere Informationen zu Kalendern, Kalenderordnern und -elementen, Terminen und Besprechungen in Exchange.

Sie sind wahrscheinlich mit den vielen Kalenderfunktionen in E-Mail-Clients wie Outlook vertraut, mit denen Sie Termine pflegen, Besprechungen planen, die Verfügbarkeit anderer Personen prüfen, Teilnehmer einladen und Besprechungen ändern oder absagen können.

Kalenderbezogene Funktionen in Exchange unterscheiden sich etwas von den Optionen in einem Client wie Outlook. Statt Informationen anzuzeigen, können Sie mit EWS in Exchange beispielsweise Informationen erstellen, speichern, senden oder ändern. Um EWS zum Arbeiten mit Kalendern zu verwenden, müssen Sie vertraut sein mit Konzepten wie beispielsweise der Informationsspeicherung, Zeiten, Serien und Nachrichtenflüssen. Genauer gesagt, müssen Sie mit Folgendem vertraut sein:

  • Kalenderordner, Kalenderelemente und Kalenderansichten

  • Besprechungsanfragen, Antworten, Planung, Teilnehmern, Ressourcen, Räumen und Verfügbarkeit

  • Zeiträumen, Zeitzonen und Start- und Endzeiten von Besprechungen und Terminen

  • Terminserien, Serienmustern, Ausnahmen und einzelnen Instanzen von Terminen und Besprechungen

Glücklicherweise bieten EWS und die verwaltete EWS-API zahlreiche Vorgänge und Methoden, mit denen Sie eine Vielzahl von kalenderbezogenen Aufgaben ausführen können. Sie können beispielsweise die verwaltete EWS-API verwenden, um mit nur wenigen Codezeilen eine Besprechung zu erstellen und Einladungen an die Teilnehmer versenden, wie im folgenden Beispiel veranschaulicht wird.

            Appointment meeting = new Appointment(service);
            // Set the properties on the meeting object to create the meeting.
            meeting.Subject = "Team building exercise";
            meeting.Body = "Let's learn to really work as a team and then have lunch!";
            meeting.Start = DateTime.Now.AddDays(2);
            meeting.End = meeting.Start.AddHours(2);
            meeting.Location = "Conference Room 12";
            meeting.RequiredAttendees.Add("Mack.Chaves@contoso.com");
            meeting.RequiredAttendees.Add("Sadie.Daniels@contoso.com");
            meeting.OptionalAttendees.Add("Magdalena.Kemp@contoso.com");
            meeting.ReminderMinutesBeforeStart = 60;
            // Send the meeting request
            meeting.Save(SendInvitationsMode.SendToAllAndSaveCopy);

Kalenderordner und Kalenderelemente

Kalenderordner enthalten Kalenderelemente. Kalenderordner besitzen eine Ordnerklasse von IPF.Appointment, und können nur Elemente enthalten, die durch die verwaltete ItemClass-EWS-API-Eigenschaft definiert sind, die mit einem Appointment-Klasse-Objekt oder dem EWS-CalendarItemType-Element verknüpft ist.

Elemente in einem Kalenderordner unterscheiden sich etwas von Elementen in anderen Ordnern eines Postfachs, da Vorkommen in einer Terminserie und Ausnahmen in einer Terminserie keine tatsächlichen Elemente in einem Postfach sind, sondern intern als Anlagen eines Serienmasters gespeichert werden. Um daher alle Termine in einem bestimmten Datumsbereich abzurufen, müssen Sie die Kalenderansicht verwenden. Weitere Informationen zum Abrufen von Terminen und Kalenderansichten finden Sie unter Abrufen von Terminen und Besprechungen mithilfe von EWS in Exchange.

Besprechungen und Termine

Der wesentliche Unterschied zwischen Besprechungen und Terminen besteht darin, dass Besprechungen über Teilnehmer verfügen und Termine nicht. Intern verwendet Exchange dasselbe Objekt für Besprechungen und Termine. Zum Arbeiten mit Besprechungen und Terminen verwenden Sie die verwaltete EWS-API-Appointment-Klasse oder das EWS- CalendarItem-Element.

Termine und Besprechungen können einzelne Instanzen oder teil einer Terminserie sein, da Termine jedoch keine Teilnehmer, Räume oder Ressourcen umfassen, muss dafür keine Nachricht gesendet werden.

Da Besprechungen das Senden und Antworten auf Anfragen und Aktualisierungen umfasst, ist dazu mehr Aufwand nötig, als nur auf Elemente in einem Kalenderordner zuzugreifen. Sie sind auch mit einem Workflow verknüpft. Besprechungen müssen geplant werden, wenn Teilnehmer verfügbar sind und können außerdem die Reservierung eines Besprechungsraums oder von Ressourcen wie einem Projektor oder anderen Dingen umfassen.

Zum Besprechungsworkflow gehören in der Regel folgende Schritte:

  1. Ein Meeting wird erstellt und mit Informationen wie Start- und Endzeit, Ort und einem Nachrichtentext befüllt.
  2. Dann wird eine Liste mit potenziellen Teilnehmern, Ressourcen und dem Raum erstellt.
  3. Anschließend wird der Verfügbarkeitsstatus der Teilnehmer überprüft.
  4. Daraufhin wird eine Besprechungsanfrage an die Teilnehmer gesendet.
  5. Teilnehmer antworten auf die Besprechungsanfrage mit der Absicht, an der Besprechung teilzunehmen oder nicht. Teilnehmer können außerdem eine andere Zeit für die Besprechung vorschlagen.
  6. Besprechungen können abgesagt oder aktualisiert werden, dadurch wird in der Regel ein neues Versenden von E-Mails an die Teilnehmer ausgelöst.

Kalender und die Uhrzeit

Zeitbezogene Funktionen sind für die Kalendererstellung von wesentlicher Bedeutung. Termine und Besprechungen verfügen über Start- und Endzeiten, Daueren und andere zeitbezogene Eigenschaften, z. B. den Zeitpunkt, zu dem eine Nachricht erstellt, gesendet und empfangen wird. Vorhandene Termine und Besprechungen können basierend auf einer Start- und Endzeit aus einem Kalenderordner abgerufen werden. Serienserien haben Anfangs- und Endvorgänge. Und Treffen finden innerhalb einer bestimmten Zeitzone statt, die in einer globalen Wirtschaft immer wichtiger wird.

Uhrzeiten werden auf einem Exchange-Server intern in der koordinierten Weltzeit (Coordinated Universal Time, UTC) gespeichert. Exchange wandelt sie basierend auf den Clienteinstellungen in die Uhrzeit der lokalen Zeitzone um. DateTime-Eigenschaften beziehen sich auf die lokale Zeitzone des Computers.

Terminserie

Eine Terminserie von Terminen oder Besprechungen besteht aus einem Serienmaster, einer Gruppe von Serienelementen, und optional aus einer Gruppe von Ausnahmeelementen. Serieninformationen werden im Serienmasterelement gespeichert. Das RecurringMasterItemId-EWS-Element ist mit Vorkommen und Ausnahmen in einer Serie verknüpft, außerdem können Sie die verwaltete Appointment.BindToRecurringMaster-EWS-API-Methode verwenden, um den Serienmaster abzurufen. Mithilfe einer Serieninstanz können Sie nach allen der Serie zugeordneten Elementen und Informationen suchen.

Beachten Sie, dass Serieneigenschaften zu allen Kalenderelementen vorhanden sind, sie werden jedoch nur bei den Serienmasterelementen ausgefüllt. Zusätzlich zu einem Index aller Vorkommen in einer Serie besitzt der Serienmaster einen Verweis zu geänderten und gelöschten Vorkommen und Serienmustern (z. B. täglich, wöchentlich, monatlich oder jährlich).

Inhalt dieses Abschnitts

Siehe auch