Processar itens de calendário em lotes no Exchange
Saiba como criar, obter, atualizar ou excluir lotes de itens de calendário em uma única chamada usando a API Gerenciada do EWS ou o EWS no Exchange.
Você pode usar a API Gerenciada do EWS ou o EWS para trabalhar com lotes de compromissos e reuniões para reduzir o número de chamadas que um cliente faz a um servidor exchange. Quando você usa a API Gerenciada do EWS para criar, obter, atualizar e excluir um lote de itens de calendário, você usa métodos de objeto ExchangeService , enquanto quando você trabalha com itens de calendário único, usa métodos de objeto Appointment . Se você estiver usando o EWS, use a mesma operação para chamadas em lote que usa para chamadas individuais.
Tabela 1. Métodos de API Gerenciada do EWS e operações EWS para trabalhar com lotes de itens de calendário
| Para... | Use este método de API Gerenciada do EWS | Usar essa operação EWS |
|---|---|---|
| Criar itens de calendário em lotes |
Createitems |
CreateItem |
| Obter itens de calendário em lotes |
BindToItems |
GetItem |
| Atualizar itens de calendário em lotes |
UpdateItems |
UpdateItem |
| Excluir itens de calendário em lotes |
DeleteItems |
DeleteItem |
Neste artigo, você aprenderá a concluir tarefas básicas para lotes de itens de calendário usando a API Gerenciada do EWS ou o EWS.
Observe que, nos exemplos de API Gerenciada do EWS neste artigo, se os métodos forem chamados sequencialmente, você poderá criar, obter, atualizar e excluir um lote de itens de calendário.
Collection<ItemId> itemIds = BatchCreateCalendarItems(service);
Collection<Appointment> myAppointments = BatchGetCalendarItems(service, itemIds);
itemIds = BatchUpdateCalendarItems(service, myAppointments);
BatchDeleteCalendarItemsTwice(service, itemIds);
Criar itens de calendário em lotes usando a API Gerenciada do EWS
Você pode criar itens de calendário em lotes usando o método CreateItems EWS Managed API, conforme mostrado no exemplo a seguir. Este exemplo cria três objetos Appointment – um compromisso de instância única, um compromisso recorrente e uma reunião – e, em seguida, adiciona-os a uma coleção.
Este exemplo pressupõe que você se autenticou em um servidor Exchange e adquiriu um objetoExchangeService chamado service.
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;
}
Os objetos Appointment na coleção podem ser compromissos ou reuniões e instâncias individuais ou uma série recorrente de qualquer um deles.
Criar itens de calendário em lotes usando o EWS
Você pode criar itens de calendário em lotes usando a operação CreateItem EWS, conforme mostrado no exemplo de código a seguir. Essa também é a solicitação XML que a API Gerenciada do EWS envia quando você usa a API Gerenciada do EWS para criar itens de calendário em 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>
O servidor responde à solicitação CreateItem com uma mensagem CreateItemResponse que inclui um valor ResponseCode de NoError para cada um dos novos itens de calendário, o que indica que cada item de calendário foi criado com êxito.
Observe que os itens de calendário são reuniões ou compromissos ou instâncias individuais ou uma série recorrente, de acordo com os valores de elemento de cada item de calendário passado para o servidor exchange.
Esta é a resposta do servidor. Os atributos ItemId e ChangeKey são reduzidos para legibilidade.
<?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>
Obter itens de calendário em lotes usando a API Gerenciada do EWS
Você pode obter itens de calendário em lotes usando o método de API Gerenciada do BindToItems EWS, conforme mostrado no exemplo a seguir.
Este exemplo pressupõe que você se autenticou em um servidor Exchange e adquiriu um objetoExchangeService chamado service.
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;
}
Obter itens de calendário em lotes usando o EWS
Você pode obter itens de calendário em lotes usando a operação GetItem EWS, conforme mostrado no exemplo a seguir. Essa também é a solicitação XML que a API Gerenciada do EWS envia quando você usa a API Gerenciada do EWS para obter itens de calendário em lotes.
Os atributos ItemId e ChangeKey são reduzidos para legibilidade.
<?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>
O servidor responde à solicitação GetItem com uma mensagem GetItemResponse com as propriedades solicitadas para cada item, conforme mostrado no exemplo a seguir.
<?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>
Atualizar itens de calendário em lotes usando a API Gerenciada do EWS
Você pode atualizar as propriedades do item de calendário em lotes usando o método de API Gerenciada do UpdateItems EWS, conforme mostrado no exemplo a seguir.
Este exemplo pressupõe que você se autenticou em um servidor Exchange e adquiriu um objetoExchangeService chamado service.
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;
}
Atualizar itens de calendário em lotes usando o EWS
Você pode atualizar vários itens de calendário usando a operação UpdateItem EWS, conforme mostrado no exemplo de código a seguir. Essa também é a solicitação XML que a API Gerenciada do EWS envia quando você usa a API Gerenciada do EWS para atualizar itens de calendário em 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>
O servidor responde à solicitação UpdateItem com uma mensagem UpdateItemResponse que inclui um valor ResponseCode de NoError, que indica que cada uma das atualizações foi salva com êxito no servidor. Todos os conflitos são relatados no 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>
Excluir itens de calendário em lotes usando a API Gerenciada do EWS
Você pode excluir itens de calendário em lotes usando o método deleteItems EWS Managed API, conforme mostrado no exemplo a seguir. Este exemplo torna a solicitação de exclusão uma segunda vez para mostrar que nenhuma exceção é gerada, mas que o servidor retornará um erro ErrorItemNotFound para indicar que os itens a serem excluídos não estavam no repositório quando a chamada foi feita. Esse erro será retornado se o item já tiver sido excluído ou se uma ID de item ruim for passada para o servidor.
Este exemplo pressupõe que você se autenticou em um servidor Exchange e adquiriu um objetoExchangeService chamado service.
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++;
}
}
Quando o método DeleteItems é chamado pela segunda vez, nenhuma exceção é gerada, mas o servidor retorna um erro ErrorItemNotFound no resultado.
Excluir itens de calendário em lotes usando o EWS
Você pode excluir itens de calendário em lotes usando a operação DeleteItem EWS, conforme mostrado no exemplo de código a seguir. Essa também é a solicitação XML que a API Gerenciada do EWS envia quando você usa a API Gerenciada do EWS para excluir itens de calendário em lotes.
Os atributos ItemId e ChangeKey são reduzidos para legibilidade.
<?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>
O servidor responde à solicitação DeleteItem com uma mensagem DeleteItemResponse que inclui um valor ResponseCode de NoError para cada item que foi removido.
<?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>
Observe que, se a solicitação DeleteItem for feita quando os itens associados já tiverem sido excluídos, nenhuma exceção será gerada, mas o servidor retornará um erro ErrorItemNotFound no resultado. O exemplo a seguir mostra a resposta do servidor a uma solicitação DeleteItem quando os itens associados já foram excluídos.
<?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>
Verificando se um processo em lote foi concluído com êxito
Quando um ou mais itens de calendário em uma solicitação em lote não podem ser processados conforme solicitado, um erro é retornado para cada item de calendário que falhou e o restante dos itens de calendário no lote são processados conforme o esperado. Falhas no processamento em lote podem ocorrer se o item foi excluído e, portanto, não puder ser enviado, recuperado ou atualizado ou se o item for movido para uma pasta diferente e, portanto, tiver uma nova ID do item e não puder ser modificado com a ID do item enviada. As informações nesta seção mostram como obter detalhes de erro sobre falhas no processamento em lote de itens de calendário.
Para verificar o sucesso de um processo em lote usando a API Gerenciada do EWS, verifique se a propriedade OverallResult do ServiceResponseCollection é igual a ServiceResult.Success. Nesse caso, todos os itens de calendário foram processados com êxito. Se o OverallResult não for igual a ServiceResult.Success, um ou mais itens de calendário não foram processados com êxito. Cada um dos objetos retornados no ServiceResponseCollection contém as seguintes propriedades:
Essas propriedades contêm informações sobre por que os itens de calendário não puderam ser processados conforme solicitado. Os exemplos neste artigo imprimem o Resultado, o ErrorCode e o ErrorMessage para cada item com falha. Você pode usar esses resultados para investigar o problema.
Para eWS, para verificar o sucesso de um processo em lote, verifique o atributo ResponseClass para cada item que está sendo processado. A seguir está a estrutura básica do ResponseMessageType, o tipo base do qual todas as mensagens de resposta são derivadas.
<ResponseMessage ResponseClass="Success | Warning | Error">
<MessageText/>
<ResponseCode/>
<DescriptiveLinkKey/>
<MessageXml/>
</ResponseMessage>
O atributo ResponseClass será definido como Êxito se o item de calendário tiver sido processado com êxito ou Erro se ele não tiver sido processado com êxito. Para itens de calendário, você não encontrará um Aviso durante o processamento em lote. Se o ResponseClass for Success, o elemento ResponseCode a seguir também será sempre definido como NoError. Se a ResponseClass for Error, você precisará verificar os valores dos elementos MessageText, ResponseCode e MessageXml para determinar o que causou o problema. O DescriptiveLinkKey está atualmente não utilizado.
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de