Procesar elementos de calendario en lotes en Exchange
Obtenga información sobre cómo crear, obtener, actualizar o eliminar lotes de elementos de calendario en una sola llamada mediante la API administrada de EWS o EWS en Exchange.
Puede usar la API administrada de EWS o EWS para trabajar con lotes de citas y reuniones para reducir el número de llamadas que realiza un cliente a un servidor exchange. Cuando se usa la API administrada de EWS para crear, obtener, actualizar y eliminar un lote de elementos de calendario, se usan métodos de objeto ExchangeService , mientras que cuando se trabaja con elementos de calendario único, se usan métodos de objeto Appointment . Si usa EWS, se usa la misma operación para las llamadas por lotes que se usan para llamadas únicas.
Tabla 1. Métodos de API administrada de EWS y operaciones de EWS para trabajar con lotes de elementos de calendario
| Para | Uso de este método de API administrada de EWS | Uso de esta operación de EWS |
|---|---|---|
| Creación de elementos de calendario en lotes |
CreateItems |
CreateItem |
| Obtención de elementos de calendario en lotes |
BindToItems |
GetItem |
| Actualización de elementos de calendario en lotes |
UpdateItems |
UpdateItem |
| Eliminación de elementos de calendario en lotes |
DeleteItems |
DeleteItem |
En este artículo, aprenderá a completar tareas básicas para lotes de elementos de calendario mediante la API administrada de EWS o EWS.
Tenga en cuenta que en los ejemplos de API administrada de EWS de este artículo, si se llama secuencialmente a los métodos, puede crear, obtener, actualizar y, a continuación, eliminar un lote de elementos de calendario.
Collection<ItemId> itemIds = BatchCreateCalendarItems(service);
Collection<Appointment> myAppointments = BatchGetCalendarItems(service, itemIds);
itemIds = BatchUpdateCalendarItems(service, myAppointments);
BatchDeleteCalendarItemsTwice(service, itemIds);
Creación de elementos de calendario en lotes mediante la API administrada de EWS
Puede crear elementos de calendario en lotes mediante el método CreateItems EWS Managed API, como se muestra en el ejemplo siguiente. En este ejemplo se crean tres objetos Appointment (una cita de instancia única, una cita periódica y una reunión) y, a continuación, se agregan a una colección.
En este ejemplo se supone que se ha autenticado en un servidor de Exchange y ha adquirido un objeto ExchangeService denominado servicio.
public static Collection<ItemId> BatchCreateCalendarItems(ExchangeService service)
{
// These are unsaved local instances of an Appointment object.
// Despite the required parameter of an ExchangeService object (service), no call
// to an Exchange server is made when the objects are instantiated.
// A call to the Exchange server is made when the service.CreateItems() method is called.
Appointment appt1 = new Appointment(service);
Appointment recurrAppt2 = new Appointment(service);
Appointment meeting3 = new Appointment(service);
// Set the properties for a single instance appointment.
appt1.Subject = "Review current quarterly deliverables";
appt1.Body = "Wrap up all outstanding deliverables for this quarter and prepare for Q2.";
appt1.Start = DateTime.Now.AddDays(2);
appt1.End = appt1.Start.AddHours(3);
appt1.Location = "My office";
appt1.ReminderMinutesBeforeStart = 30;
// Set the properties for a recurring appointment.
recurrAppt2.Subject = "Food bank delivery";
recurrAppt2.Body = "Deliver the team's weekly food drive collection to the food bank.";
recurrAppt2.Start = DateTime.Now.AddDays(1);
recurrAppt2.End = recurrAppt2.Start.AddHours(1);
recurrAppt2.Location = "Local food bank";
arecurrAppt2.ReminderMinutesBeforeStart = 30;
DayOfTheWeek[] dow = new DayOfTheWeek[] {(DayOfTheWeek)recurrAppt2.Start.DayOfWeek};
recurrAppt2.Recurrence = new Recurrence.WeeklyPattern(recurrAppt2.Start.Date, 1, dow);
recurrAppt2.Recurrence.StartDate = recurrAppt2.Start.Date;
recurrAppt2.Recurrence.NumberOfOccurrences = 10;
// Set the properties for a single instance meeting.
meeting3.Subject = "Code Blast";
meeting3.Body = "Let's get together to finish all the methods and unit tests for the ContosoLive project.";
meeting3.Start = DateTime.Now.AddDays(3);
meeting3.End = meeting3.Start.AddHours(6);
meeting3.Location = "The lounge";
meeting3.RequiredAttendees.Add("Mack@contoso.com");
meeting3.RequiredAttendees.Add("Sadie@contoso.com");
meeting3.RequiredAttendees.Add("Magdalena@contoso.com");
meeting3.ReminderMinutesBeforeStart = 30;
// Add the appointment objects to a collection.
Collection<Appointment> calendarItems = new Collection<Appointment>() { appt1, recurrAppt2, meeting3 };
// Instantiate a collection of item IDs to populate from the values that are returned by the Exchange server.
Collection<ItemId> itemIds = new Collection<ItemId>();
// Send the batch of Appointment objects.
// Note that multiple calls to the Exchange server might be made when Appointment objects have attachments.
// Note also that the the ID of the item collection passed as the first parameter to CreateItems is set on return.
ServiceResponseCollection<ServiceResponse> response = service.CreateItems(calendarItems,
WellKnownFolderName.Calendar,
MessageDisposition.SendAndSaveCopy,
SendInvitationsMode.SendToAllAndSaveCopy);
if (response.OverallResult == ServiceResult.Success)
{
Console.WriteLine("All appointments and meetings sucessfully created.");
}
// Collect the item IDs from the created calendar items.
foreach (Appointment appt in calendarItems)
{
itemIds.Add(appt.Id);
}
int counter = 1;
// Show the IDs and errors for each message.
foreach (ServiceResponse resp in response)
{
// Because item IDs are long, show only five characters.
Console.WriteLine("Result (message {0}), id {1}: {2}", counter, itemIds[counter - 1].ToString().Substring(0, 5), resp.Result);
Console.WriteLine("Error Code: {0}", resp.ErrorCode);
Console.WriteLine("ErrorMessage: {0}\r\n", resp.ErrorMessage);
counter++;
}
// Return the collection of item IDs.
return itemIds;
}
Los objetos Appointment de la colección pueden ser citas o reuniones, e instancias únicas o una serie periódica de cualquiera de ellas.
Creación de elementos de calendario en lotes mediante EWS
Puede crear elementos de calendario en lotes mediante la operación EWS CreateItem , como se muestra en el ejemplo de código siguiente. Esta es también la solicitud XML que la API administrada de EWS envía cuando se usa la API administrada de EWS para crear elementos de calendario en lotes.
<?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" />
<t:TimeZoneContext>
<t:TimeZoneDefinition Id="Pacific Standard Time" />
</t:TimeZoneContext>
</soap:Header>
<soap:Body>
<m:CreateItem MessageDisposition="SendAndSaveCopy" SendMeetingInvitations="SendToAllAndSaveCopy">
<m:SavedItemFolderId>
<t:DistinguishedFolderId Id="calendar" />
</m:SavedItemFolderId>
<m:Items>
<t:CalendarItem>
<t:Subject>Review current quarterly deliverables</t:Subject>
<t:Body BodyType="HTML">Wrap up all outstanding deliverables for this quarter and prepare for Q2.</t:Body>
<t:ReminderDueBy>2014-01-07T12:13:40.333-08:00</t:ReminderDueBy>
<t:Start>2014-01-08T13:13:37.717-08:00</t:Start>
<t:End>2014-01-08T16:13:37.717-08:00</t:End>
<t:Location>Local food bank</t:Location>
<t:MeetingTimeZone TimeZoneName="Pacific Standard Time" />
</t:CalendarItem>
<t:CalendarItem>
<t:Subject>Food bank delivery</t:Subject>
<t:Body BodyType="HTML">Deliver the team's weekly food drive collection to the food bank.</t:Body>
<t:Start>2014-01-07T13:13:40.333-08:00</t:Start>
<t:End>2014-01-07T14:13:40.333-08:00</t:End>
<t:Recurrence>
<t:WeeklyRecurrence>
<t:Interval>1</t:Interval>
<t:DaysOfWeek>Tuesday</t:DaysOfWeek>
</t:WeeklyRecurrence>
<t:NumberedRecurrence>
<t:StartDate>2014-01-07-08:00</t:StartDate>
<t:NumberOfOccurrences>10</t:NumberOfOccurrences>
</t:NumberedRecurrence>
</t:Recurrence>
<t:MeetingTimeZone TimeZoneName="Pacific Standard Time" />
</t:CalendarItem>
<t:CalendarItem>
<t:Subject>Code Blast</t:Subject>
<t:Body BodyType="HTML">Let's get together to finish all the methods and unit tests for the ContosoLive project.</t:Body>
<t:ReminderMinutesBeforeStart>30</t:ReminderMinutesBeforeStart>
<t:Start>2014-01-09T13:13:44.998-08:00</t:Start>
<t:End>2014-01-09T19:13:44.998-08:00</t:End>
<t:Location>The lounge</t:Location>
<t:RequiredAttendees>
<t:Attendee>
<t:Mailbox>
<t:EmailAddress>Mack@contoso.com</t:EmailAddress>
</t:Mailbox>
</t:Attendee>
<t:Attendee>
<t:Mailbox>
<t:EmailAddress>Sadie@contoso.com</t:EmailAddress>
</t:Mailbox>
</t:Attendee>
<t:Attendee>
<t:Mailbox>
<t:EmailAddress>Magdalena@contoso.com</t:EmailAddress>
</t:Mailbox>
</t:Attendee>
</t:RequiredAttendees>
<t:MeetingTimeZone TimeZoneName="Pacific Standard Time" />
</t:CalendarItem>
</m:Items>
</m:CreateItem>
</soap:Body>
</soap:Envelope>
El servidor responde a la solicitud CreateItem con un mensaje CreateItemResponse que incluye un valor ResponseCode de NoError para cada uno de los nuevos elementos de calendario, lo que indica que cada elemento de calendario se creó correctamente.
Tenga en cuenta que los elementos de calendario son reuniones o citas, o instancias únicas o una serie periódica, según los valores de elemento de cada elemento de calendario pasados al servidor de Exchange.
La siguiente es la respuesta del servidor. Los atributos itemId y ChangeKey se acortan para mejorar la legibilidad.
<?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="847" MinorBuildNumber="12" Version="V2_8"
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:CreateItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:CreateItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:CalendarItem>
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
</t:CalendarItem>
</m:Items>
</m:CreateItemResponseMessage>
<m:CreateItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:CalendarItem>
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
</t:CalendarItem>
</m:Items>
</m:CreateItemResponseMessage>
<m:CreateItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:CalendarItem>
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
</t:CalendarItem>
</m:Items>
</m:CreateItemResponseMessage>
</m:ResponseMessages>
</m:CreateItemResponse>
</s:Body>
</s:Envelope>
Obtención de elementos de calendario en lotes mediante la API administrada de EWS
Puede obtener elementos de calendario en lotes mediante el método BindToItems EWS Managed API, como se muestra en el ejemplo siguiente.
En este ejemplo se supone que se ha autenticado en un servidor de Exchange y ha adquirido un objeto ExchangeService denominado servicio.
public static Collection<Appointment> BatchGetCalendarItems(ExchangeService service, Collection<ItemId> itemIds)
{
// As a best practice, create a property set that limits the properties returned by the Bind method to only those that are required.
PropertySet appointmentProps = new PropertySet(BasePropertySet.IdOnly,
AppointmentSchema.Subject,
AppointmentSchema.Body,
AppointmentSchema.ReminderMinutesBeforeStart,
AppointmentSchema.Start,
AppointmentSchema.End,
AppointmentSchema.AppointmentType,
AppointmentSchema.Location,
AppointmentSchema.RequiredAttendees);
ServiceResponseCollection<GetItemResponse> response = service.BindToItems(itemIds, appointmentProps);
Collection<Appointment> calendarItems = new Collection<Appointment>();
foreach (GetItemResponse items in response)
{
Item item = items.Item;
Appointment appointmentItem = (Appointment)item;
calendarItems.Add(appointmentItem);
Console.WriteLine("Found item {0}.", appointmentItem.Id.ToString().Substring(144));
}
if (response.OverallResult == ServiceResult.Success)
{
Console.WriteLine("All calendar items retrieved successfully.");
Console.WriteLine("\r\n");
}
else
{
int counter = 1;
// List the status of each message.
foreach (ServiceResponse resp in response)
{
// Because item IDs are long, show only last 8 characters.
Console.WriteLine("Result (message {0}), id {1}: {2}", counter, itemIds[counter - 1].ToString().Substring(144), resp.Result);
Console.WriteLine("Error Code: {0}", resp.ErrorCode);
Console.WriteLine("ErrorMessage: {0}\r\n", resp.ErrorMessage);
Console.WriteLine("\r\n");
counter++;
}
}
return calendarItems;
}
Obtención de elementos de calendario en lotes mediante EWS
Puede obtener elementos de calendario en lotes mediante la operación EWS GetItem , como se muestra en el ejemplo siguiente. Esta es también la solicitud XML que envía la API administrada de EWS cuando se usa la API administrada de EWS para obtener elementos de calendario en lotes.
Los atributos itemId y ChangeKey se acortan para mejorar la legibilidad.
<?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" />
<t:TimeZoneContext>
<t:TimeZoneDefinition Id="Pacific Standard Time" />
</t:TimeZoneContext>
</soap:Header>
<soap:Body>
<m:GetItem>
<m:ItemShape>
<t:BaseShape>IdOnly</t:BaseShape>
<t:AdditionalProperties>
<t:FieldURI FieldURI="item:Subject" />
<t:FieldURI FieldURI="item:Body" />
<t:FieldURI FieldURI="item:ReminderMinutesBeforeStart" />
<t:FieldURI FieldURI="calendar:Start" />
<t:FieldURI FieldURI="calendar:End" />
<t:FieldURI FieldURI="calendar:CalendarItemType" />
<t:FieldURI FieldURI="calendar:Location" />
<t:FieldURI FieldURI="calendar:RequiredAttendees" />
</t:AdditionalProperties>
</m:ItemShape>
<m:ItemIds>
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
</m:ItemIds>
</m:GetItem>
</soap:Body>
</soap:Envelope>
El servidor responde a la solicitud GetItem con un mensaje GetItemResponse con las propiedades solicitadas para cada elemento, como se muestra en el ejemplo siguiente.
<?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="847" MinorBuildNumber="16" Version="V2_8"
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:GetItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:GetItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:CalendarItem>
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
<t:Subject>Review current quarterly deliverables</t:Subject>
<t:Body BodyType="HTML">
&lt;html&gt;
&lt;head&gt;
&lt;meta http-equiv="Content-Type" content="text/html; charset=utf-8"&gt;
&lt;/head&gt;
&lt;body&gt;
Wrap up all outstanding deliverables for this quarter and prepare for Q2.
&lt;/body&gt;
&lt;/html&gt;
</t:Body>
<t:ReminderMinutesBeforeStart>30</t:ReminderMinutesBeforeStart>
<t:Start>2014-01-19T18:59:07Z</t:Start>
<t:End>2014-01-19T21:59:07Z</t:End>
<t:Location>Local food bank</t:Location>
<t:CalendarItemType>Single</t:CalendarItemType>
</t:CalendarItem>
</m:Items>
</m:GetItemResponseMessage>
<m:GetItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:CalendarItem>
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
<t:Subject>Food bank delivery</t:Subject>
<t:Body BodyType="HTML">
&lt;html&gt;
&lt;head&gt;
&lt;meta http-equiv="Content-Type" content="text/html; charset=utf-8"&gt;
&lt;/head&gt;
&lt;body&gt;
Deliver the team's weekly food drive collection to the food bank.
&lt;/body&gt;
&lt;/html&gt;
</t:Body>
<t:ReminderMinutesBeforeStart>15</t:ReminderMinutesBeforeStart>
<t:Start>2014-01-18T18:59:07Z</t:Start>
<t:End>2014-01-18T19:59:07Z</t:End>
<t:CalendarItemType>RecurringMaster</t:CalendarItemType>
</t:CalendarItem>
</m:Items>
</m:GetItemResponseMessage>
<m:GetItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:CalendarItem>
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
<t:Subject>Code Blast</t:Subject>
<t:Body BodyType="HTML">
&lt;html&gt;
&lt;head&gt;
&lt;meta http-equiv="Content-Type" content="text/html; charset=utf-8"&gt;
&lt;/head&gt;
&lt;body&gt;
Let's get together to finish all the methods and unit tests for the ContosoLive project.
&lt;/body&gt;
&lt;/html&gt;
</t:Body>
<t:ReminderMinutesBeforeStart>30</t:ReminderMinutesBeforeStart>
<t:Start>2014-01-20T18:59:08Z</t:Start>
<t:End>2014-01-21T00:59:08Z</t:End>
<t:Location>The lounge</t:Location>
<t:CalendarItemType>Single</t:CalendarItemType>
<t:RequiredAttendees>
<t:Attendee>
<t:Mailbox>
<t:Name>Mack@contoso.com</t:Name>
<t:EmailAddress>Mack@contoso.com</t:EmailAddress>
<t:RoutingType>SMTP</t:RoutingType>
</t:Mailbox>
<t:ResponseType>Unknown</t:ResponseType>
</t:Attendee>
<t:Attendee>
<t:Mailbox>
<t:Name>Sadie@contoso.com</t:Name>
<t:EmailAddress>Sadie@contoso.com</t:EmailAddress>
<t:RoutingType>SMTP</t:RoutingType>
</t:Mailbox>
<t:ResponseType>Unknown</t:ResponseType>
</t:Attendee>
<t:Attendee>
<t:Mailbox>
<t:Name>Magdalena@contoso.com</t:Name>
<t:EmailAddress>Magdalena@contoso.com</t:EmailAddress>
<t:RoutingType>SMTP</t:RoutingType>
</t:Mailbox>
<t:ResponseType>Unknown</t:ResponseType>
</t:Attendee>
</t:RequiredAttendees>
</t:CalendarItem>
</m:Items>
</m:GetItemResponseMessage>
</m:ResponseMessages>
</m:GetItemResponse>
</s:Body>
</s:Envelope>
Actualización de elementos de calendario en lotes mediante la API administrada de EWS
Puede actualizar las propiedades del elemento de calendario en lotes mediante el método UpdateItems EWS Managed API, como se muestra en el ejemplo siguiente.
En este ejemplo se supone que se ha autenticado en un servidor de Exchange y ha adquirido un objeto ExchangeService denominado servicio.
public static Collection<ItemId> BatchUpdateCalendarItems(ExchangeService service, Collection<Appointment> calendarItems)
{
int i = 1;
// Appointment item IDs to return.
Collection<ItemId> itemIds = new Collection<ItemId>();
// Update the subject of each calendar item locally.
foreach (Appointment appointment in calendarItems)
{
// Update the subject of each calendar item in the collection
appointment.Subject = "Company headquarters are moving down the street to 1234 Contoso Drive!: " + appointment.Subject.ToString();
Console.WriteLine("Updated the subject property for calendar item {0} of {1}, item id {2}.", i, calendarItems.Count, appointment.Id.ToString().Substring(0, 5));
i++;
// Collect item IDs to return instead of appointment objects.
itemIds.Add(appointment.Id);
}
// Send the updated items to the server.
// This method call results in an UpdateItem call to EWS.
ServiceResponseCollection<UpdateItemResponse> response = service.UpdateItems(calendarItems,
WellKnownFolderName.Calendar,
ConflictResolutionMode.AutoResolve,
MessageDisposition.SendAndSaveCopy,
SendInvitationsOrCancellationsMode.SendToChangedAndSaveCopy);
// Display the result of the UpdateItems method call.
if (response.OverallResult == ServiceResult.Success)
{
Console.WriteLine("Calendar items successfully updated.\r\n");
}
else
{
Console.WriteLine("Not all items were successfully updated on the server.\r\n");
i = 1;
foreach (ServiceResponse srvResponse in response)
{
Console.WriteLine("Result for message {0}: {1}", i, srvResponse.Result);
Console.WriteLine("Error code: {0}", srvResponse.ErrorCode);
Console.WriteLine("ErrorMessage: {0}\r\n", srvResponse.ErrorMessage);
i++;
}
}
return itemIds;
}
Actualización de elementos de calendario en lotes mediante EWS
Puede actualizar varios elementos de calendario mediante la operación EWS UpdateItem , como se muestra en el ejemplo de código siguiente. Esta es también la solicitud XML que la API administrada de EWS envía cuando se usa la API administrada de EWS para actualizar los elementos de calendario en lotes.
<?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" />
<t:TimeZoneContext>
<t:TimeZoneDefinition Id="Pacific Standard Time" />
</t:TimeZoneContext>
</soap:Header>
<soap:Body>
<m:UpdateItem MessageDisposition="SendAndSaveCopy" ConflictResolution="AutoResolve"
SendMeetingInvitationsOrCancellations="SendToChangedAndSaveCopy">
<m:SavedItemFolderId>
<t:DistinguishedFolderId Id="calendar" />
</m:SavedItemFolderId>
<m:ItemChanges>
<t:ItemChange>
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
<t:Updates>
<t:SetItemField>
<t:FieldURI FieldURI="item:Subject" />
<t:CalendarItem>
<t:Subject>Company headquarters are moving down the street to 1234 Contoso Drive!: Review current quarterly deliverables
</t:Subject>
</t:CalendarItem>
</t:SetItemField>
</t:Updates>
</t:ItemChange>
<t:ItemChange>
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
<t:Updates>
<t:SetItemField>
<t:FieldURI FieldURI="item:Subject" />
<t:CalendarItem>
<t:Subject>Company headquarters are moving down the street to 1234 Contoso Drive!: Food bank delivery</t:Subject>
</t:CalendarItem>
</t:SetItemField>
</t:Updates>
</t:ItemChange>
<t:ItemChange>
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
<t:Updates>
<t:SetItemField>
<t:FieldURI FieldURI="item:Subject" />
<t:CalendarItem>
<t:Subject>Company headquarters are moving down the street to 1234 Contoso Drive!: Code Blast</t:Subject>
</t:CalendarItem>
</t:SetItemField>
</t:Updates>
</t:ItemChange>
</m:ItemChanges>
</m:UpdateItem>
</soap:Body>
</soap:Envelope>
El servidor responde a la solicitud UpdateItem con un mensaje UpdateItemResponse que incluye un valor ResponseCode de NoError, lo que indica que cada una de las actualizaciones se guardó correctamente en el servidor. Los conflictos se notifican en el elemento ConflictResult .
<?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="859" MinorBuildNumber="13"
Version="V2_8" 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:UpdateItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:UpdateItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:CalendarItem>
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
</t:CalendarItem>
</m:Items>
<m:ConflictResults>
<t:Count>1</t:Count>
</m:ConflictResults>
</m:UpdateItemResponseMessage>
<m:UpdateItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:CalendarItem>
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
</t:CalendarItem>
</m:Items>
<m:ConflictResults>
<t:Count>1</t:Count>
</m:ConflictResults>
</m:UpdateItemResponseMessage>
<m:UpdateItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:CalendarItem>
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
</t:CalendarItem>
</m:Items>
<m:ConflictResults>
<t:Count>1</t:Count>
</m:ConflictResults>
</m:UpdateItemResponseMessage>
</m:ResponseMessages>
</m:UpdateItemResponse>
</s:Body>
</s:Envelope>
Eliminación de elementos de calendario en lotes mediante la API administrada de EWS
Puede eliminar elementos de calendario en lotes mediante el método DeleteItems EWS Managed API, como se muestra en el ejemplo siguiente. En este ejemplo se realiza la solicitud de eliminación una segunda vez para mostrar que no se produce ninguna excepción, pero que el servidor devolverá un error ErrorItemNotFound para indicar que los elementos que se van a eliminar no estaban en el almacén cuando se realizó la llamada. Este error se devuelve si el elemento ya se ha eliminado o si se pasa un identificador de elemento incorrecto al servidor.
En este ejemplo se supone que se ha autenticado en un servidor de Exchange y ha adquirido un objeto ExchangeService denominado servicio.
public static void BatchDeleteCalendarItemsTwice(ExchangeService service, Collection<ItemId> itemIds)
{
// Delete the batch of appointment objects
// This method call results in a DeleteItem call to EWS.
ServiceResponseCollection<ServiceResponse> response = service.DeleteItems(itemIds,
DeleteMode.MoveToDeletedItems,
SendCancellationsMode.SendToAllAndSaveCopy,
AffectedTaskOccurrence.AllOccurrences);
int counter = 1;
// Show the IDs and errors for each message.
foreach (ServiceResponse resp in response)
{
// Because item IDs are long, show only five characters.
Console.WriteLine("Result (message {0}), id {1}: {2}", counter, itemIds[counter - 1].ToString().Substring(0, 5), resp.Result);
Console.WriteLine("Error Code: {0}", resp.ErrorCode);
Console.WriteLine("ErrorMessage: {0}\r\n", resp.ErrorMessage);
counter++;
}
// Now attempt to delete the same items again.
response = service.DeleteItems(itemIds,
DeleteMode.MoveToDeletedItems,
SendCancellationsMode.SendToAllAndSaveCopy,
AffectedTaskOccurrence.AllOccurrences);
counter = 1;
// Show the IDs and errors for each message.
foreach (ServiceResponse resp in response)
{
// Because item IDs are long, show only five characters.
Console.WriteLine("Result (message {0}), id {1}: {2}", counter, itemIds[counter - 1].ToString().Substring(0, 5), resp.Result);
Console.WriteLine("Error Code: {0}", resp.ErrorCode);
Console.WriteLine("ErrorMessage: {0}\r\n", resp.ErrorMessage);
counter++;
}
}
Cuando se llama al método DeleteItems la segunda vez, no se produce ninguna excepción, pero el servidor devuelve un error ErrorItemNotFound en el resultado.
Eliminación de elementos de calendario en lotes mediante EWS
Puede eliminar elementos de calendario en lotes mediante la operación EWS DeleteItem , como se muestra en el ejemplo de código siguiente. Esta es también la solicitud XML que envía la API administrada de EWS cuando se usa la API administrada de EWS para eliminar elementos de calendario en lotes.
Los atributos itemId y ChangeKey se acortan para mejorar la legibilidad.
<?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" />
<t:TimeZoneContext>
<t:TimeZoneDefinition Id="Pacific Standard Time" />
</t:TimeZoneContext>
</soap:Header>
<soap:Body>
<m:DeleteItem DeleteType="MoveToDeletedItems"
AffectedTaskOccurrences="AllOccurrences"
SendMeetingCancellations="SendToAllAndSaveCopy">
<m:ItemIds>
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
<t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
</m:ItemIds>
</m:DeleteItem>
</soap:Body>
</soap:Envelope>
El servidor responde a la solicitud DeleteItem con un mensaje DeleteItemResponse que incluye un valor ResponseCode de NoError para cada elemento que se quitó.
<?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="859" MinorBuildNumber="13" Version="V2_8"
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:DeleteItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:DeleteItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
</m:DeleteItemResponseMessage>
<m:DeleteItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
</m:DeleteItemResponseMessage>
<m:DeleteItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
</m:DeleteItemResponseMessage>
</m:ResponseMessages>
</m:DeleteItemResponse>
</s:Body>
</s:Envelope>
Tenga en cuenta que si la solicitud DeleteItem se realiza cuando los elementos asociados ya se han eliminado, no se producirá ninguna excepción, pero el servidor devolverá un error ErrorItemNotFound en el resultado. En el ejemplo siguiente se muestra la respuesta del servidor a una solicitud DeleteItem cuando los elementos asociados ya se han eliminado.
<?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="859" MinorBuildNumber="13" Version="V2_8"
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:DeleteItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:DeleteItemResponseMessage ResponseClass="Error">
<m:MessageText>The specified object was not found in the store.</m:MessageText>
<m:ResponseCode>ErrorItemNotFound</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
</m:DeleteItemResponseMessage>
<m:DeleteItemResponseMessage ResponseClass="Error">
<m:MessageText>The specified object was not found in the store.</m:MessageText>
<m:ResponseCode>ErrorItemNotFound</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
</m:DeleteItemResponseMessage>
<m:DeleteItemResponseMessage ResponseClass="Error">
<m:MessageText>The specified object was not found in the store.</m:MessageText>
<m:ResponseCode>ErrorItemNotFound</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
</m:DeleteItemResponseMessage>
</m:ResponseMessages>
</m:DeleteItemResponse>
</s:Body>
</s:Envelope>
Comprobación de que un proceso por lotes se completó correctamente
Cuando uno o varios elementos de calendario de una solicitud por lotes no se pueden procesar según lo solicitado, se devuelve un error para cada elemento de calendario que no se pudo y el resto de los elementos de calendario del lote se procesan según lo previsto. Los errores en el procesamiento por lotes pueden producirse si el elemento se eliminó y, por lo tanto, no se puede enviar, recuperar o actualizar, o si el elemento se ha movido a otra carpeta y, por lo tanto, tiene un nuevo identificador de elemento y no se puede modificar con el identificador de elemento enviado. La información de esta sección muestra cómo obtener detalles de error sobre errores en el procesamiento por lotes de elementos de calendario.
Para comprobar el éxito de un proceso por lotes mediante la API administrada de EWS, puede comprobar que la propiedad OverallResult de ServiceResponseCollection es igual a ServiceResult.Success. Si es así, todos los elementos del calendario se procesaron correctamente. Si OverallResult no es igual a ServiceResult.Success, uno o varios de los elementos del calendario no se procesaron correctamente. Cada uno de los objetos devueltos en ServiceResponseCollection contiene las siguientes propiedades:
Estas propiedades contienen información sobre por qué no se pudieron procesar los elementos de calendario según lo solicitado. En los ejemplos de este artículo se imprimen los elementos Result, ErrorCode y ErrorMessage para cada elemento con errores. Puede usar estos resultados para investigar el problema.
Para EWS, para comprobar el éxito de un proceso por lotes, compruebe el atributo ResponseClass para cada elemento que se está procesando. A continuación se muestra la estructura básica de ResponseMessageType, el tipo base del que se derivan todos los mensajes de respuesta.
<ResponseMessage ResponseClass="Success | Warning | Error">
<MessageText/>
<ResponseCode/>
<DescriptiveLinkKey/>
<MessageXml/>
</ResponseMessage>
El atributo ResponseClass se establece en Correcto si el elemento de calendario se procesó correctamente o Error si no se procesó correctamente. En el caso de los elementos de calendario, no encontrará una advertencia durante el procesamiento por lotes. Si ResponseClass es Correcto, el elemento ResponseCode que sigue también se establece siempre en NoError. Si ResponseClass es Error, debe comprobar los valores de los elementos MessageText, ResponseCode y MessageXml para determinar qué causó el problema. DescriptiveLinkKey no se usa actualmente.
Consulte también
Comentarios
Próximamente: a lo largo de 2024, eliminaremos gradualmente los problemas de GitHub como mecanismo de comentarios para el contenido y lo reemplazaremos por un nuevo sistema de comentarios. Para obtener más información, consulte: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de