Partager via

Calendriers et EWS dans Exchange

  • Article

Découvrez les calendriers, les dossiers et les éléments de calendrier, les rendez-vous et les réunions dans Exchange.

Vous êtes probablement familiarisé avec de nombreuses fonctionnalités de calendrier des clients de messagerie comme Outlook, qui vous permettent d’effectuer le suivi de rendez-vous, de planifier des réunions, de vérifier la disponibilité de personnes, d’inviter des participants et de modifier ou d’annuler les réunions.

Les fonctionnalités de calendrier dans Exchange sont légèrement différentes de celles que vous voyez dans un client comme Outlook. Au lieu d'afficher des informations, EWS dans Exchange vous permet d'effectuer des actions comme créer, stocker, envoyer ou modifier des informations. Pour utiliser EWS avec des calendriers, vous devez être familiarisé avec des concepts tels que le stockage d'informations, l'heure, la périodicité et le flux de messages. Plus spécifiquement, vous devez être familiarisé avec les éléments suivants :

  • Dossiers de calendrier, éléments de calendrier et affichages de calendrier

  • Demandes de réunion, réponses, planification, participants, ressources, salles et disponibilité

  • Durées, fuseaux horaires et heures de début et de fin des réunions et rendez-vous

  • Séries périodiques, périodicités, exceptions et rendez-vous et réunions uniques

Heureusement, EWS et l'API managée EWS fournissent un large éventail d'opérations et de méthodes qui vous permettent d'effectuer un large éventail de tâches de calendrier. Par exemple, à l’aide de l’API managée EWS, vous pouvez créer une réunion et envoyer des invitations aux participants avec simplement quelques lignes de code, comme illustré dans l’exemple suivant.

            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);

Dossiers de calendrier et éléments de calendrier

Les dossiers de calendrier contiennent des éléments de calendrier. Les dossiers de calendrier ont une classe de dossier de IPF.Appointment, et peuvent inclure uniquement les éléments définis par la propriété de l'API managée EWS ItemClass, qui est associée à un objet de classe de rendez-vous, ou à l'élément CalendarItemType EWS.

Les éléments d’un dossier de Calendrier sont légèrement différents des éléments d’autres dossiers dans une boîte aux lettres car les occurrences d’une série périodique et les exceptions à une série périodique ne sont pas des éléments réels dans la boîte aux lettres. Elles sont plutôt stockées en interne sous forme de pièces jointes à un rendez-vous périodique important. Par conséquent, pour récupérer tous les rendez-vous sur une plage de dates donnée, vous devez utiliser un affichage calendrier. Pour en savoir plus sur la récupération des rendez-vous et des affichages de calendrier, voirCréer des rendez-vous et réunions à l’aide de EWS dans Exchange.

Réunions et rendez-vous

La principale différence entre les réunions et les rendez-vous réside dans la présence de participants aux réunions, mais pas aux rendez-vous. En interne, Exchange utilise le même objet pour les réunions et pour les rendez-vous. Pour utiliser les réunions et les rendez-vous, vous devez utiliser la classe de rendez-vous de l'API managée EWS ou l'élément CalendarItem d'EWS.

Les rendez-vous et les réunions peuvent être des instances uniques ou faire partie d'une série périodique. Cependant, les rendez-vous n'incluant ni participants, ni salles, ni ressources, ne nécessitent pas l'envoi d'un message.

Étant donné que les réunions incluent l'envoi et la réponse à des demandes et des mises à jour, elles impliquent plus que le simple accès à des éléments dans un dossier de calendrier. Elles ont également un flux de travail associé. Les réunions doivent être planifiées lorsque les participants sont disponibles et peuvent également impliquer la réservation d'une salle de réunion ou de ressources comme un projecteur ou d'autres appareils.

Le flux de travail d'une réunion comprend généralement les étapes suivantes :

  1. Une réunion est créée et renseignée avec des informations telles que l’heure de début et de fin, l’emplacement et un corps de message.
  2. Une liste de participants, ressources et salles potentiels est créée.
  3. Le statut de disponibilité des participants est vérifié.
  4. Une demande de réunion est envoyée aux participants.
  5. Les participantes répondent à la réunion avec leur intention de participer ou non. Les participants peuvent également proposer une nouvelle heure pour la réunion.
  6. Les réunions peuvent être annulées ou mises à jour, ce qui déclenche généralement l’envoi de nouveaux messages aux participants.

Calendriers et heure

Les fonctionnalités liées à l'heure font partie intégrante du calendrier. Les rendez-vous et les réunions ont des heures de début et de fin, des durées et d'autres propriétés liées à l'heure, telles que l'heure à laquelle un message est créé, envoyé et reçu. Les réunions et rendez-vous existants peuvent être récupérés à partir d'un dossier Calendrier sur la base d'une heure de début et de fin. Les séries périodiques ont des débuts et des fins. Et les réunions ont lieu dans un fuseau horaire donné, ce qui est de plus en plus important dans une économie mondiale.

Les heures sont stockées en interne sur un serveur Exchange en Temps universel coordonné (UTC). Exchange les convertit en heures locales en fonction des paramètres du client. Les propriétés DateTime sont limitées au fuseau horaire local de l'ordinateur.

Séries périodiques

Une série périodique de réunions ou de rendez-vous est constituée d'un rendez-vous ou réunion périodique important(e), d'un ensemble d'éléments d'occurrence et, éventuellement, d'un ensemble d'éléments d'exception. Les informations de périodicité sont stockées sur l'élément de rendez-vous périodique important. L'élément EWS RecurringMasterItemId est associé à des occurrences et des exceptions dans une série, ou vous pouvez utiliser la méthode d'API managée EWS Appointment.BindToRecurringMaster pour récupérer le rendez-vous périodique important. À l'aide d'une instance d'une série, vous pouvez trouver tous les éléments et les informations associés à la série.

Notez que les propriétés de périodicité existent sur tous les éléments de calendrier, mais elles sont renseignées uniquement sur les éléments de rendez-vous périodiques importants. Outre un index de toutes les occurrences d’une série, le rendez-vous périodique important a une référence à des occurrences modifiées et supprimées et à la périodicité d’une série (par exemple, quotidien, hebdomadaire, mensuel ou annuel).

Dans cette section

Voir aussi