Mettre à jour une série périodique à l’aide d’EWS dans Exchange
Découvrez comment mettre à jour une série périodique entière à la fois à l’aide de l’API managée EWS ou d’EWS dans Exchange.
Vous pouvez utiliser l’API managée EWS ou EWS pour mettre à jour une série périodique en mettant à jour la série entière ou en mettant à jour une seule occurrence. Dans cet article, nous allons expliquer comment mettre à jour l’ensemble de la série en même temps.
En général, la mise à jour d’une série périodique est très similaire à la modification d’un seul rendez-vous. Vous utilisez les mêmes méthodes et opérations, mais vous utilisez l’ID d’élément du maître périodique de la série. Dans certains cas, vous pouvez ne pas commencer par la forme de base périodique et vous devrez peut-être trouver l’ID d’élément pour la forme de base périodique.
Toutefois, il existe une différence clé à prendre en compte lors de la mise à jour d’une série périodique : la mise à jour du modèle de périodicité. La mise à jour du modèle de périodicité n’est possible qu’avec la forme de base périodique, et les modifications apportées au modèle peuvent ajouter ou supprimer des occurrences. Par exemple, si vous modifiez la propriété Recurrence.EndDate à une date ultérieure à sa valeur actuelle, le modèle de périodicité est réévalué et des occurrences supplémentaires peuvent être ajoutées.
Modifier toutes les occurrences d’une série à l’aide de l’API managée EWS
Pour modifier toutes les occurrences d’une série, vous devez :
- Liez au maître périodique pour la série à l’aide de la méthode Appointment.BindToRecurringMaster ou Appointment.Bind sur un maître récurrent.
- Mettez à jour les propriétés de l’objet rendez-vous principal périodique.
- Enregistrez les modifications apportées au maître périodique à l’aide de la méthode Appointment.Save .
L’exemple suivant met à jour une série périodique pour modifier l’emplacement, ajouter un participant et modifier le modèle de périodicité. Cet exemple suppose que l’objet ExchangeService passé dans le paramètre de service a été initialisé avec des valeurs valides dans les propriétés Credentials et Url . Le paramètre recurringAppointment est un objet Appointment lié à une occurrence ou au maître périodique de la série à mettre à jour.
using Microsoft.Exchange.WebServices.Data;
public static bool UpdateRecurringSeries(ExchangeService service, Appointment recurringAppointment)
{
Appointment recurringMaster = null;
// If the item is a single appointment, fail.
if (recurringAppointment.AppointmentType == AppointmentType.Single)
{
Console.WriteLine("ERROR: The item to delete is not part of a recurring series.");
return false;
}
// Check the Appointment that was passed. Is it
// an occurrence or the recurring master?
if (recurringAppointment.AppointmentType != AppointmentType.RecurringMaster)
{
// If an occurrence was passed in, bind to the master.
try
{
// This method results in a call to EWS.
recurringMaster = Appointment.BindToRecurringMaster(service, recurringAppointment.Id);
}
catch (Exception ex)
{
Console.WriteLine("Couldn't bind to master: {0}", ex.Message);
return false;
}
}
else
{
// Bind to the appointment to load all properties.
// This method results in a call to EWS.
recurringMaster = Appointment.Bind(service, recurringAppointment.Id);
}
// Basic updates. These kinds of updates are the same
// as if you were updating a single appointment.
// Update the location. All occurrences will update to this new location.
recurringMaster.Location = "Conference Room 2";
// Add an attendee.
Attendee newAttendee = new Attendee("sadie@contoso.com");
recurringMaster.RequiredAttendees.Add(newAttendee);
// Changes to the recurrence. This is only applicable to a recurring
// master.
// If the series has an end date, extend the series to add two more occurrences.
if (recurringMaster.Recurrence.HasEnd)
{
// NumberOfOccurrences is only set if the user created the
// appointment with a set number of occurrences.
// Otherwise, there's a start and end date.
if (recurringMaster.Recurrence.NumberOfOccurrences != null)
{
recurringMaster.Recurrence.NumberOfOccurrences += 2;
}
else
{
// This is a bit more complicated if you want to add two more
// occurrences. You need to calculate a new end date.
Type recurrenceType = recurringMaster.Recurrence.GetType();
switch (recurrenceType.Name)
{
case "DailyPattern":
recurringMaster.Recurrence.EndDate =
recurringMaster.Recurrence.EndDate.Value.AddDays(2);
break;
case "WeeklyPattern":
recurringMaster.Recurrence.EndDate =
recurringMaster.Recurrence.EndDate.Value.AddDays(14);
break;
case "YearlyPattern":
recurringMaster.Recurrence.EndDate =
recurringMaster.Recurrence.EndDate.Value.AddYears(2);
break;
default:
// Do nothing here. There are other recurrence
// types but for simplicity, these aren't covered.
break;
}
}
}
else
{
// If it has no end, set an end date to 2 weeks from today.
recurringMaster.Recurrence.EndDate = DateTime.Now.AddDays(14);
}
// Update the series.
try
{
// This method results in a call to EWS.
recurringMaster.Update(ConflictResolutionMode.AutoResolve);
}
catch (Exception ex)
{
Console.WriteLine("Error updating series: {0}", ex.Message);
return false;
}
return true;
}
Modifier toutes les occurrences d’une série à l’aide d’EWS
Pour modifier toutes les occurrences d’une série, vous devez utiliser l’opération UpdateItem avec l’ID d’élément du maître périodique dans l’élément ItemId de la requête. La structure de la demande est la même qu’une demande de mise à jour d’un seul rendez-vous.
L’exemple suivant met à jour la série périodique des manières suivantes :
- Mises à jour l’emplacement de la série en définissant l’élément Location.
- Mises à jour les participants en définissant l’élément RequiredAttendees.
- Mises à jour la périodicité en définissant l’élément Recurrence (RecurrenceType).
<?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="https://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<t:RequestServerVersion Version="Exchange2007_SP1" />
<t:TimeZoneContext>
<t:TimeZoneDefinition Id="Eastern Standard Time" />
</t:TimeZoneContext>
</soap:Header>
<soap:Body>
<m:UpdateItem MessageDisposition="SaveOnly" ConflictResolution="AutoResolve" SendMeetingInvitationsOrCancellations="SendToAllAndSaveCopy">
<m:ItemChanges>
<t:ItemChange>
<t:ItemId Id="AAMkADA5..." ChangeKey="DwAAABYA..." />
<t:Updates>
<t:SetItemField>
<t:FieldURI FieldURI="calendar:Location" />
<t:CalendarItem>
<t:Location>Conference Room 2</t:Location>
</t:CalendarItem>
</t:SetItemField>
<t:SetItemField>
<t:FieldURI FieldURI="calendar:RequiredAttendees" />
<t:CalendarItem>
<t:RequiredAttendees>
<t:Attendee>
<t:Mailbox>
<t:Name>Mack Chaves</t:Name>
<t:EmailAddress>mack@contoso.com</t:EmailAddress>
<t:RoutingType>SMTP</t:RoutingType>
</t:Mailbox>
</t:Attendee>
<t:Attendee>
<t:Mailbox>
<t:Name>Sadie Daniels</t:Name>
<t:EmailAddress>sadie@contoso.com</t:EmailAddress>
<t:RoutingType>SMTP</t:RoutingType>
</t:Mailbox>
</t:Attendee>
</t:RequiredAttendees>
</t:CalendarItem>
</t:SetItemField>
<t:SetItemField>
<t:FieldURI FieldURI="calendar:Recurrence" />
<t:CalendarItem>
<t:Recurrence>
<t:WeeklyRecurrence>
<t:Interval>1</t:Interval>
<t:DaysOfWeek>Tuesday</t:DaysOfWeek>
</t:WeeklyRecurrence>
<t:EndDateRecurrence>
<t:StartDate>2014-05-06</t:StartDate>
<t:EndDate>2014-06-22-04:00</t:EndDate>
</t:EndDateRecurrence>
</t:Recurrence>
</t:CalendarItem>
</t:SetItemField>
<t:SetItemField>
<t:FieldURI FieldURI="calendar:MeetingTimeZone" />
<t:CalendarItem>
<t:MeetingTimeZone TimeZoneName="Pacific Standard Time" />
</t:CalendarItem>
</t:SetItemField>
</t:Updates>
</t:ItemChange>
</m:ItemChanges>
</m:UpdateItem>
</soap:Body>
</soap:Envelope>
Le serveur répond avec un élément UpdateItemResponse qui inclut un élément ResponseCode avec la valeur NoError, ce qui indique que la mise à jour a réussi.