Actualización de una serie periódica mediante EWS en Exchange
Obtenga información sobre cómo actualizar una serie periódica completa a la vez mediante la API administrada de EWS o EWS en Exchange.
Puede usar la API administrada de EWS o EWS para actualizar una serie periódica actualizando toda la serie o actualizando una única aparición. En este artículo trataremos cómo actualizar toda la serie a la vez.
En general, actualizar una serie periódica es muy similar a modificar una sola cita. Se usan los mismos métodos y operaciones, pero se usa el identificador de elemento del patrón periódico de la serie. En algunos casos, es posible que no empiece con el patrón periódico y que necesite encontrar el identificador de elemento para el patrón periódico.
Sin embargo, hay una diferencia clave a tener en cuenta al actualizar una serie periódica: actualizar el patrón de periodicidad. La actualización del patrón de periodicidad solo es posible con el patrón periódico y los cambios en el patrón pueden agregar o quitar repeticiones. Por ejemplo, si modifica la propiedad Recurrence.EndDate a una fecha posterior a su valor actual, se vuelve a evaluar el patrón de periodicidad y se pueden agregar repeticiones adicionales.
Modificación de todas las repeticiones de una serie mediante la API administrada de EWS
Para modificar todas las repeticiones de una serie, debe hacer lo siguiente:
- Enlace al patrón periódico de la serie mediante el método Appointment.BindToRecurringMaster o Appointment.Bind en un patrón periódico.
- Actualice las propiedades en el objeto appointment maestro periódico.
- Guarde los cambios en el patrón periódico mediante el método Appointment.Save .
En el ejemplo siguiente se actualiza una serie periódica para cambiar la ubicación, agregar un asistente y modificar el patrón de periodicidad. En este ejemplo se supone que el objeto ExchangeService pasado en el parámetro de servicio se ha inicializado con valores válidos en las propiedades Credentials y Url . El parámetro recurringAppointment es un objeto Appointment enlazado a una repetición o al patrón periódico para la serie que se va a actualizar.
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;
}
Modificación de todas las repeticiones de una serie mediante EWS
Para modificar todas las repeticiones de una serie, debe usar la operación UpdateItem con el identificador de elemento del patrón periódico en el elemento ItemId de la solicitud. La estructura de la solicitud es la misma que una solicitud para actualizar una sola cita.
En el ejemplo siguiente se actualiza la serie periódica de las siguientes maneras:
- Novedades la ubicación de la serie estableciendo el elemento Location.
- Novedades los asistentes estableciendo el elemento RequiredAttendees.
- Novedades la periodicidad estableciendo el elemento 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>
El servidor responde con un elemento UpdateItemResponse que incluye un elemento ResponseCode con un valor de NoError, lo que indica que la actualización se realizó correctamente.