Mettre à jour le fuseau horaire pour un rendez-vous en utilisant EWS dans Exchange
Découvrez comment mettre à jour le fuseau horaire d’un rendez-vous ou d’une réunion existant à l’aide de l’API managée EWS ou EWS dans Exchange.
Lorsqu’un rendez-vous ou une réunion est créé dans un calendrier Exchange, le fuseau horaire utilisé pour spécifier les heures de début et de fin est enregistré en tant que fuseau horaire de création pour le rendez-vous. Vous pouvez modifier ce fuseau horaire à l’aide de l’API managée EWS ou EWS. Toutefois, la modification du fuseau horaire d’un rendez-vous a d’autres effets sur l’heure de début et de fin du rendez-vous.
Les valeurs d’heure sont stockées sur le serveur Exchange en temps universel de coordonnées (UTC). Par conséquent, si un rendez-vous est défini pour commencer à 13h00 (13h00) dans le fuseau horaire Est (UTC-05:00), cette valeur est stockée à 18h00 (18h00) sur le serveur, en supposant que le fuseau horaire est dans sa phase de temps standard. Lorsque ce rendez-vous est consulté dans d’autres fuseaux horaires, le nombre d’heures approprié est ajouté ou soustrait de la valeur UTC pour déterminer l’heure spécifique au fuseau horaire. Par exemple, si un rendez-vous a une heure de début à 13h00 Est (18h00 UTC) et qu’il est consulté à partir d’un client dans le fuseau horaire Pacifique (UTC-08:00), l’heure de début spécifique au fuseau horaire pour ce client est 10:00 (18:00 - 08:00).
Lorsque vous mettez à jour le fuseau horaire du rendez-vous sans mettre à jour l’heure de début et de fin, le serveur met à jour les valeurs UTC stockées sur le serveur pour conserver les heures de début et de fin comme les mêmes heures spécifiques au fuseau horaire. Par exemple, considérez le rendez-vous est à 13h00. L’heure est stockée à 18:00 UTC sur le serveur. Si le fuseau horaire du rendez-vous est remplacé par le fuseau horaire Pacifique, le serveur déplace l’heure de début à 13h00 Pacifique (21:00 UTC).
Vous pouvez modifier ce comportement en définissant explicitement les heures de début et de fin.
Mise à jour du fuseau horaire sur un rendez-vous existant à l’aide de l’API managée EWS
Dans l’exemple suivant, l’API managée EWS est utilisée pour mettre à jour le fuseau horaire d’un rendez-vous existant vers le fuseau horaire central en mettant à jour les propriétés Appointment.StartTimeZone et Appointment.EndTimeZone . Si le paramètre shiftAppointnment est défini sur true, le code ne définit pas explicitement les heures de début et de fin du rendez-vous. Dans ce cas, le serveur déplace les heures de début et de fin pour les conserver aux mêmes heures relatives au fuseau horaire dans le nouveau fuseau horaire. Si la valeur est false, le code convertit explicitement les heures de début et de fin pour conserver le rendez-vous en même temps au format UTC.
Cet exemple suppose que l’objet ExchangeService a été initialisé avec des valeurs valides dans les propriétés Identifiants et Url.
static void UpdateAppointmentTimeZone(ExchangeService service, ItemId apptId, bool shiftAppointment)
{
PropertySet includeTimeZones = new PropertySet(AppointmentSchema.Subject,
AppointmentSchema.Start,
AppointmentSchema.ReminderDueBy,
AppointmentSchema.End,
AppointmentSchema.StartTimeZone,
AppointmentSchema.EndTimeZone);
Appointment apptToUpdate;
// Load the existing appointment.
// This will result in a call to EWS.
try
{
apptToUpdate = Appointment.Bind(service, apptId, includeTimeZones);
}
catch (Exception ex)
{
Console.WriteLine("Error retrieving existing appointment: {0}", ex.Message);
return;
}
Console.WriteLine("Before update:");
// Output the current start, reminder, end, and time zones.
Console.WriteLine(" Start: {0}", apptToUpdate.Start);
Console.WriteLine(" Start time zone: {0}", apptToUpdate.StartTimeZone.DisplayName);
Console.WriteLine(" Reminder: {0}", apptToUpdate.ReminderDueBy);
Console.WriteLine(" End: {0}", apptToUpdate.End);
Console.WriteLine(" End time zone: {0}", apptToUpdate.EndTimeZone.DisplayName);
// Retrieve the Central time zone.
TimeZoneInfo centralTZ = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time");
// Update the time zones on the appointment.
apptToUpdate.StartTimeZone = centralTZ;
apptToUpdate.EndTimeZone = centralTZ;
if (!shiftAppointment)
{
// Set the start and end times explicitly so that the appointment
// will start and end at the same UTC time.
// Convert the times to then Central time zone. This
// will keep them at the same time in UTC.
// For example, 1:00 PM Eastern becomes 12:00 PM Central.
DateTime newStartTime = TimeZoneInfo.ConvertTime(
apptToUpdate.Start, centralTZ);
DateTime newEndTime = TimeZoneInfo.ConvertTime(
apptToUpdate.End, centralTZ);
apptToUpdate.Start = newStartTime;
apptToUpdate.End = newEndTime;
}
try
{
// Save the changes. This will result in a call to EWS.
apptToUpdate.Update(ConflictResolutionMode.AlwaysOverwrite,
SendInvitationsOrCancellationsMode.SendToNone);
}
catch (Exception ex)
{
Console.WriteLine("Error updating appointment: {0}", ex.Message);
return;
}
// Now rebind to the appointment to get the new values.
Appointment apptAfterUpdate;
try
{
// This will result in a call to EWS.
apptAfterUpdate = Appointment.Bind(service, apptId, includeTimeZones);
}
catch (Exception ex)
{
Console.WriteLine("Error retrieving existing appointment: {0}", ex.Message);
return;
}
Console.WriteLine("After update:");
// Output the current start, reminder, end, and time zones.
Console.WriteLine(" Start: {0}", apptAfterUpdate.Start);
Console.WriteLine(" Start time zone: {0}", apptAfterUpdate.StartTimeZone.DisplayName);
Console.WriteLine(" Reminder: {0}", apptAfterUpdate.ReminderDueBy);
Console.WriteLine(" End: {0}", apptAfterUpdate.End);
Console.WriteLine(" End time zone: {0}", apptAfterUpdate.EndTimeZone.DisplayName);
}
Lorsque l’exemple est utilisé pour mettre à jour un rendez-vous qui commence à 13h00 Est et se termine à 14h00 Est, avec le paramètre shiftAppointment défini sur true et la propriété ExchangeService.TimeZone définie sur le fuseau horaire Est, la sortie se présente comme suit.
Before update:
Start: 6/20/2014 1:00:00 PM
Start time zone: (UTC-05:00) Eastern Time (US & Canada)
Reminder: 6/20/2014 1:00:00 PM
End: 6/20/2014 2:00:00 PM
End time zone: (UTC-05:00) Eastern Time (US & Canada)
After update:
Start: 6/20/2014 2:00:00 PM
Start time zone: (UTC-06:00) Central Time (US & Canada)
Reminder: 6/20/2014 2:00:00 PM
End: 6/20/2014 3:00:00 PM
End time zone: (UTC-06:00) Central Time (US & Canada)
Lorsque l’exemple est utilisé pour mettre à jour le même rendez-vous avec le paramètre shiftAppointment défini sur false et avec la propriété TimeZone à nouveau définie sur le fuseau horaire Est, la sortie est légèrement différente.
Before update:
Start: 6/20/2014 1:00:00 PM
Start time zone: (UTC-05:00) Eastern Time (US & Canada)
Reminder: 6/20/2014 1:00:00 PM
End: 6/20/2014 2:00:00 PM
End time zone: (UTC-05:00) Eastern Time (US & Canada)
After update:
Start: 6/20/2014 1:00:00 PM
Start time zone: (UTC-06:00) Central Time (US & Canada)
Reminder: 6/20/2014 1:00:00 PM
End: 6/20/2014 2:00:00 PM
End time zone: (UTC-06:00) Central Time (US & Canada)
Notez que les heures de début et de fin n’ont pas changé. Cela est dû au fait que les heures sont interprétées dans le fuseau horaire Est (car la propriété TimeZone est définie sur le fuseau horaire Est) et que les valeurs d’heure ont été mises à jour pour empêcher le déplacement du rendez-vous.
Mise à jour du fuseau horaire sur un rendez-vous existant à l’aide d’EWS
L’exemple suivant de demande d’opération UpdateItem EWS met à jour le fuseau horaire d’un rendez-vous. Cet exemple met uniquement à jour les éléments StartTimeZone et EndTimeZone , de sorte que le serveur déplace les heures de début et de fin du rendez-vous pour les conserver au même fuseau horaire dans le nouveau fuseau horaire. La valeur de l’élément ItemId est raccourcie pour plus de lisibilité.
<?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="Exchange2010" />
</soap:Header>
<soap:Body>
<m:UpdateItem ConflictResolution="AlwaysOverwrite" SendMeetingInvitationsOrCancellations="SendToNone">
<m:ItemChanges>
<t:ItemChange>
<t:ItemId Id="AAMkADA5..." ChangeKey="DwAAABYA..." />
<t:Updates>
<t:SetItemField>
<t:FieldURI FieldURI="calendar:StartTimeZone" />
<t:CalendarItem>
<t:StartTimeZone Id="Central Standard Time" />
</t:CalendarItem>
</t:SetItemField>
<t:SetItemField>
<t:FieldURI FieldURI="calendar:EndTimeZone" />
<t:CalendarItem>
<t:EndTimeZone Id="Central Standard Time" />
</t:CalendarItem>
</t:SetItemField>
</t:Updates>
</t:ItemChange>
</m:ItemChanges>
</m:UpdateItem>
</soap:Body>
</soap:Envelope>
L’exemple de demande suivant met à jour le fuseau horaire du rendez-vous et met également à jour les heures de début et de fin en définissant explicitement les éléments Start et End . La valeur de l’élément ItemId est raccourcie pour plus de lisibilité.
<?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="Exchange2010" />
</soap:Header>
<soap:Body>
<m:UpdateItem ConflictResolution="AlwaysOverwrite" SendMeetingInvitationsOrCancellations="SendToNone">
<m:ItemChanges>
<t:ItemChange>
<t:ItemId Id="AAMkADA5..." ChangeKey="DwAAABYA..." />
<t:Updates>
<t:SetItemField>
<t:FieldURI FieldURI="calendar:StartTimeZone" />
<t:CalendarItem>
<t:StartTimeZone Id="Central Standard Time" />
</t:CalendarItem>
</t:SetItemField>
<t:SetItemField>
<t:FieldURI FieldURI="calendar:EndTimeZone" />
<t:CalendarItem>
<t:EndTimeZone Id="Central Standard Time" />
</t:CalendarItem>
</t:SetItemField>
<t:SetItemField>
<t:FieldURI FieldURI="calendar:Start" />
<t:CalendarItem>
<t:Start>2014-06-20T17:00:00.000Z</t:Start>
</t:CalendarItem>
</t:SetItemField>
<t:SetItemField>
<t:FieldURI FieldURI="calendar:End" />
<t:CalendarItem>
<t:End>2014-06-20T18:00:00.000Z</t:End>
</t:CalendarItem>
</t:SetItemField>
</t:Updates>
</t:ItemChange>
</m:ItemChanges>
</m:UpdateItem>
</soap:Body>
</soap:Envelope>