Créer des rendez-vous et des réunions à l’aide d’EWS dans Exchange
Découvrez comment obtenir des rendez-vous et des réunions à l’aide de l’API managée EWS ou EWS dans Exchange.
Vous pouvez récupérer des rendez-vous et des réunions à partir d’un dossier de calendrier à l’aide de la méthode d’API managée EWS CalendarFolder.FindAppointments ou de l’opération FindItem EWS.
Obtenir des rendez-vous à l’aide de l’API managée EWS
L’exemple de code suivant montre comment utiliser l’API managée EWS pour récupérer les rendez-vous d’un utilisateur qui se trouvent entre une heure de début et une heure de fin spécifiée.
// Initialize values for the start and end times, and the number of appointments to retrieve.
DateTime startDate = DateTime.Now;
DateTime endDate = startDate.AddDays(30);
const int NUM_APPTS = 5;
// Initialize the calendar folder object with only the folder ID.
CalendarFolder calendar = CalendarFolder.Bind(service, WellKnownFolderName.Calendar, new PropertySet());
// Set the start and end time and number of appointments to retrieve.
CalendarView cView = new CalendarView(startDate, endDate, NUM_APPTS);
// Limit the properties returned to the appointment's subject, start time, and end time.
cView.PropertySet = new PropertySet(AppointmentSchema.Subject, AppointmentSchema.Start, AppointmentSchema.End);
// Retrieve a collection of appointments by using the calendar view.
FindItemsResults<Appointment> appointments = calendar.FindAppointments(cView);
Console.WriteLine("\nThe first " + NUM_APPTS + " appointments on your calendar from " + startDate.Date.ToShortDateString() +
" to " + endDate.Date.ToShortDateString() + " are: \n");
foreach (Appointment a in appointments)
{
Console.Write("Subject: " + a.Subject.ToString() + " ");
Console.Write("Start: " + a.Start.ToString() + " ");
Console.Write("End: " + a.End.ToString());
Console.WriteLine();
}
Voici la sortie de l’exemple de code.
The first five appointments on your calendar from 8/21/2013 to 9/20/2013 are:
Subject: Contoso devs team meeting Start: 8/21/2013 12:30:00 PM End: 8/21/2013 1:00:00 PM
Subject: Daily status meeting Start: 8/21/2013 1:00:00 PM End: 8/21/2013 2:00:00 PM
Subject: Lunch with sales team Start: 8/21/2013 2:30:00 PM End: 8/21/2013 3:30:00 PM
Subject: Tennis at the club Start: 8/22/2013 11:00:00 AM End: 8/22/2013 12:00:00 PM
Subject: Online training webcast: 8/22/2013 2:00:00 PM End: 8/22/2013 3:00:00 PM
Obtenir des rendez-vous à l’aide d’EWS
Le code XML suivant montre une demande d’opération GetFolder pour retourner un ID de dossier pour l’opération FindItem .
<?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="https://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<t:RequestServerVersion Version="Exchange2007_SP1" />
</soap:Header>
<soap:Body>
<m:GetFolder>
<m:FolderShape>
<t:BaseShape>IdOnly</t:BaseShape>
</m:FolderShape>
<m:FolderIds>
<t:DistinguishedFolderId Id="calendar" />
</m:FolderIds>
</m:GetFolder>
</soap:Body>
</soap:Envelope>
Le code XML suivant affiche la réponse GetFolder . Notez que les attributs FolderID et ChangeKey sont raccourcis pour plus de lisibilité.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="https://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15" MinorVersion="0" MajorBuildNumber="731" MinorBuildNumber="10" Version="V2_3"
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">
<m:GetFolderResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:GetFolderResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Folders>
<t:CalendarFolder>
<t:FolderId Id="AAMk" ChangeKey="AgAA" />
</t:CalendarFolder>
</m:Folders>
</m:GetFolderResponseMessage>
</m:ResponseMessages>
</m:GetFolderResponse>
</s:Body>
</s:Envelope>
Le code XML suivant montre la requête FindItem utilisée pour retourner les rendez-vous demandés. Notez que les attributs FolderID et ChangeKey sont raccourcis pour plus de lisibilité.
<?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="https://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<t:RequestServerVersion Version="Exchange2007_SP1" />
</soap:Header>
<soap:Body>
<m:FindItem Traversal="Shallow">
<m:ItemShape>
<t:BaseShape>IdOnly</t:BaseShape>
<t:AdditionalProperties>
<t:FieldURI FieldURI="item:Subject" />
<t:FieldURI FieldURI="calendar:Start" />
<t:FieldURI FieldURI="calendar:End" />
</t:AdditionalProperties>
</m:ItemShape>
<m:CalendarView MaxEntriesReturned="5" StartDate="2013-08-21T17:30:24.127Z" EndDate="2013-09-20T17:30:24.127Z" />
<m:ParentFolderIds>
<t:FolderId Id="AAMk" ChangeKey="AgAA" />
</m:ParentFolderIds>
</m:FindItem>
</soap:Body>
</soap:Envelope>
Le code XML suivant affiche la réponse FindItem . Notez que les attributs ItemID et ChangeKey sont raccourcis pour plus de lisibilité.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="https://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15" MinorVersion="0" MajorBuildNumber="731" MinorBuildNumber="10" Version="V2_3"
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">
<m:FindItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:FindItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:RootFolder TotalItemsInView="33" IncludesLastItemInRange="false">
<t:Items>
<t:CalendarItem>
<t:ItemId Id="AAMk" ChangeKey="DwAA" />
<t:Subject>Contoso devs team meeting</t:Subject>
<t:Start>2013-08-21T19:30:00Z</t:Start>
<t:End>2013-08-21T20:00:00Z</t:End>
</t:CalendarItem>
<t:CalendarItem>
<t:ItemId Id="AAMk" ChangeKey="DwAA" />
<t:Subject>Daily status meeting</t:Subject>
<t:Start>2013-08-21T20:00:00Z</t:Start>
<t:End>2013-08-21T21:00:00Z</t:End>
</t:CalendarItem>
<t:CalendarItem>
<t:ItemId Id="AAMk" ChangeKey="DwAA" />
<t:Subject>Lunch with sales team</t:Subject>
<t:Start>2013-08-21T21:30:00Z</t:Start>
<t:End>2013-08-21T22:30:00Z</t:End>
</t:CalendarItem>
<t:CalendarItem>
<t:ItemId Id="AAMk" ChangeKey="DwAA" />
<t:Subject>Tennis at the club</t:Subject>
<t:Start>2013-08-22T18:00:00Z</t:Start>
<t:End>2013-08-22T19:00:00Z</t:End>
</t:CalendarItem>
<t:CalendarItem>
<t:ItemId Id="AAMkA" ChangeKey="DwAA" />
<t:Subject>Online training webcast</t:Subject>
<t:Start>2013-08-22T21:00:00Z</t:Start>
<t:End>2013-08-22T22:00:00Z</t:End>
</t:CalendarItem>
</t:Items>
</m:RootFolder>
</m:FindItemResponseMessage>
</m:ResponseMessages>
</m:FindItemResponse>
</s:Body>
</s:Envelope>
Réunions périodiques et affichage calendrier
Le dossier calendrier est légèrement différent des autres dossiers d’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, mais sont plutôt stockées en interne sous forme de pièces jointes à un maître périodique. Cela signifie que bien que vous puissiez créer une requête EWS qui retourne des valeurs entre un ensemble de valeurs de début et de fin à l’aide de l’une des méthodes de surcharge FindItems de l’API managée EWS, comme ExchangeService.FindItems ou l’opération FindItem EWS, EWS ne recherche pas les exceptions et les occurrences dans la table des pièces jointes de chaque élément de calendrier.
Au lieu de cela, vous souhaitez vraiment appliquer une vue de données à une union de deux tables SQL, à l’aide d’un objet CalendarView . Notez que pour des raisons de performances, nous vous recommandons d’utiliser la propriété PropertySet pour limiter la taille de la réponse en indiquant le nombre de rendez-vous ou de réunions que vous souhaitez renvoyer, ainsi que les propriétés spécifiques souhaitées.
Voir aussi
- Calendriers et EWS dans Exchange
- Créer des rendez-vous et des réunions à l’aide d’EWS dans Exchange 2013
- Mettre à jour des rendez-vous et des réunions à l’aide d’EWS dans Exchange
- Supprimer des rendez-vous et annuler des réunions à l'aide d’EWS dans Exchange
- Développer des clients de service web pour Exchange
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour