Traiter les éléments de calendrier par lots dans Exchange
Découvrez comment créer, obtenir, mettre à jour ou supprimer des lots d’éléments de calendrier dans un seul appel à l’aide de l’API managée EWS ou EWS dans Exchange.
Vous pouvez utiliser l’API managée EWS ou EWS pour travailler avec des lots de rendez-vous et de réunions afin de réduire le nombre d’appels qu’un client passe à un serveur Exchange. Lorsque vous utilisez l’API managée EWS pour créer, obtenir, mettre à jour et supprimer un lot d’éléments de calendrier, vous utilisez des méthodes d’objet ExchangeService , tandis que lorsque vous travaillez avec des éléments de calendrier uniques, vous utilisez des méthodes d’objet Appointment . Si vous utilisez EWS, vous utilisez la même opération pour les appels par lots que pour les appels uniques.
Tableau 1. Méthodes d’API managée EWS et opérations EWS pour l’utilisation de lots d’éléments de calendrier
| Afin de... | Utiliser cette méthode d’API managée EWS | Utiliser cette opération EWS |
|---|---|---|
| Créer des éléments de calendrier par lots |
CreateItems |
CreateItem |
| Obtenir des éléments de calendrier par lots |
BindToItems |
GetItem |
| Mettre à jour les éléments de calendrier par lots |
UpdateItems |
UpdateItem |
| Supprimer des éléments de calendrier par lots |
DeleteItems |
DeleteItem |
Dans cet article, vous allez apprendre à effectuer des tâches de base pour des lots d’éléments de calendrier à l’aide de l’API managée EWS ou EWS.
Notez que dans les exemples d’API managée EWS de cet article, si les méthodes sont appelées de manière séquentielle, vous pouvez créer, obtenir, mettre à jour, puis supprimer un lot d’éléments de calendrier.
Collection<ItemId> itemIds = BatchCreateCalendarItems(service);
Collection<Appointment> myAppointments = BatchGetCalendarItems(service, itemIds);
itemIds = BatchUpdateCalendarItems(service, myAppointments);
BatchDeleteCalendarItemsTwice(service, itemIds);
Créer des éléments de calendrier par lots à l’aide de l’API managée EWS
Vous pouvez créer des éléments de calendrier par lots à l’aide de la méthode d’API managée EWS CreateItems , comme illustré dans l’exemple suivant. Cet exemple crée trois objets Appointment (un rendez-vous à instance unique, un rendez-vous périodique et une réunion), puis les ajoute à une collection.
Cet exemple suppose que vous ont été authentifiés auprès d'un serveur Exchange et que vous avez acquis un ExchangeService object named 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;
}
Les objets Appointment de la collection peuvent être des rendez-vous ou des réunions, et des instances uniques ou une série périodique de l’une ou l’autre.
Créer des éléments de calendrier par lots à l’aide d’EWS
Vous pouvez créer des éléments de calendrier par lots à l’aide de l’opération CreateItem EWS, comme indiqué dans l’exemple de code suivant. Il s’agit également de la requête XML que l’API managée EWS envoie lorsque vous utilisez l’API managée EWS pour créer des éléments de calendrier par lots.
<?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>
Le serveur répond à la requête CreateItem avec un message CreateItemResponse qui inclut la valeur ResponseCodeNoError pour chacun des nouveaux éléments de calendrier, ce qui indique que chaque élément de calendrier a été créé avec succès.
Notez que les éléments de calendrier sont des réunions ou des rendez-vous, ou des instances uniques ou une série périodique, en fonction des valeurs d’élément de chaque élément de calendrier passées au serveur Exchange.
Voici la réponse du serveur. Les attributs ItemId et ChangeKey sont réduits pour une meilleure lisibilité.
<?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>
Obtenir des éléments de calendrier par lots à l’aide de l’API managée EWS
Vous pouvez obtenir des éléments de calendrier par lots à l’aide de la méthode d’API managée EWS BindToItems , comme illustré dans l’exemple suivant.
Cet exemple suppose que vous ont été authentifiés auprès d'un serveur Exchange et que vous avez acquis un ExchangeService object named 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;
}
Obtenir des éléments de calendrier par lots à l’aide d’EWS
Vous pouvez obtenir des éléments de calendrier par lots à l’aide de l’opération GetItem EWS, comme illustré dans l’exemple suivant. Il s’agit également de la requête XML que l’API managée EWS envoie lorsque vous utilisez l’API managée EWS pour obtenir des éléments de calendrier par lots.
Les attributs ItemId et ChangeKey sont réduits pour une meilleure lisibilité.
<?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>
Le serveur répond à la requête GetItem avec un message GetItemResponse avec les propriétés demandées pour chaque élément, comme indiqué dans l’exemple suivant.
<?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>
Mettre à jour les éléments de calendrier par lots à l’aide de l’API managée EWS
Vous pouvez mettre à jour les propriétés des éléments de calendrier par lots à l’aide de la méthode d’API managée UpdateItems EWS, comme illustré dans l’exemple suivant.
Cet exemple suppose que vous ont été authentifiés auprès d'un serveur Exchange et que vous avez acquis un ExchangeService object named 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;
}
Mettre à jour des éléments de calendrier par lots à l’aide d’EWS
Vous pouvez mettre à jour plusieurs éléments de calendrier à l’aide de l’opération UpdateItem EWS, comme indiqué dans l’exemple de code suivant. Il s’agit également de la requête XML que l’API managée EWS envoie lorsque vous utilisez l’API managée EWS pour mettre à jour des éléments de calendrier par lots.
<?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>
Le serveur répond à la requête UpdateItem avec un message UpdateItemResponse qui inclut la valeur ResponseCodeNoError, ce qui indique que chacune des mises à jour a été enregistrée avec succès sur le serveur. Tous les conflits sont signalés dans l’élément 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>
Supprimer des éléments de calendrier par lots à l’aide de l’API managée EWS
Vous pouvez supprimer des éléments de calendrier par lots à l’aide de la méthode d’API managée EWS DeleteItems , comme illustré dans l’exemple suivant. Cet exemple montre comment effectuer une deuxième demande de suppression pour indiquer qu’aucune exception n’est levée, mais que le serveur retourne une erreur ErrorItemNotFound pour indiquer que les éléments à supprimer n’étaient pas dans le magasin au moment de l’appel. Cette erreur est retournée si l’élément a déjà été supprimé ou si un ID d’élément incorrect est passé au serveur.
Cet exemple suppose que vous ont été authentifiés auprès d'un serveur Exchange et que vous avez acquis un ExchangeService object named 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++;
}
}
Lorsque la méthode DeleteItems est appelée la deuxième fois, aucune exception n’est levée, mais le serveur retourne une erreur ErrorItemNotFound dans le résultat.
Supprimer des éléments de calendrier par lots à l’aide d’EWS
Vous pouvez supprimer des éléments de calendrier par lots à l’aide de l’opération EWS DeleteItem , comme indiqué dans l’exemple de code suivant. Il s’agit également de la requête XML que l’API managée EWS envoie lorsque vous utilisez l’API managée EWS pour supprimer des éléments de calendrier par lots.
Les attributs ItemId et ChangeKey sont réduits pour une meilleure lisibilité.
<?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>
Le serveur répond à la requête DeleteItem avec un message DeleteItemResponse qui inclut la valeur ResponseCodeNoError pour chaque élément supprimé.
<?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>
Notez que si la requête DeleteItem est effectuée lorsque les éléments associés ont déjà été supprimés, aucune exception n’est levée, mais le serveur renvoie une erreur ErrorItemNotFound dans le résultat. L’exemple suivant montre la réponse du serveur à une requête DeleteItem lorsque les éléments associés ont déjà été supprimés.
<?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>
Vérification de la réussite d’un processus de traitement par lots
Lorsqu’un ou plusieurs éléments de calendrier d’une demande par lot ne peuvent pas être traités comme demandé, une erreur est retournée pour chaque élément de calendrier ayant échoué et le reste des éléments de calendrier du lot sont traités comme prévu. Des échecs dans le traitement par lots peuvent se produire si l’élément a été supprimé et ne peut donc pas être envoyé, récupéré ou mis à jour, ou si l’élément a été déplacé vers un autre dossier et a donc un nouvel ID d’élément et ne peut pas être modifié avec l’ID d’élément envoyé. Les informations de cette section montrent comment obtenir des détails d’erreur sur les échecs de traitement par lots des éléments de calendrier.
Pour vérifier la réussite d’un processus par lots à l’aide de l’API managée EWS, vous pouvez vérifier que la propriété OverallResult de ServiceResponseCollection est égale à ServiceResult.Success. Si c’est le cas, tous les éléments de calendrier ont été traités avec succès. Si OverallResult n’est pas égal à ServiceResult.Success, un ou plusieurs éléments de calendrier n’ont pas été traités correctement. Chacun des objets retournés dans ServiceResponseCollection contient les propriétés suivantes :
Ces propriétés contiennent des informations sur la raison pour laquelle les éléments de calendrier n’ont pas pu être traités comme demandé. Les exemples de cet article affichent les valeurs Result, ErrorCode et ErrorMessage pour chaque élément ayant échoué. Vous pouvez utiliser ces résultats pour examiner le problème.
Pour EWS, pour vérifier la réussite d’un processus par lot, vérifiez l’attribut ResponseClass pour chaque élément en cours de traitement. Voici la structure de base du ResponseMessageType, le type de base duquel tous les messages de réponse sont dérivés.
<ResponseMessage ResponseClass="Success | Warning | Error">
<MessageText/>
<ResponseCode/>
<DescriptiveLinkKey/>
<MessageXml/>
</ResponseMessage>
L’attribut ResponseClass est défini sur Réussite si l’élément de calendrier a été traité avec succès, ou Erreur s’il n’a pas été traité correctement. Pour les éléments de calendrier, vous ne rencontrerez pas d’avertissement pendant le traitement par lots. Si responseClass a la valeur Success, l’élément ResponseCode qui suit est également toujours défini sur NoError. Si responseClass a la valeur Error, vous devez vérifier les valeurs des éléments MessageText, ResponseCode et MessageXml pour déterminer la cause du problème. DescriptiveLinkKey n’est actuellement pas utilisé.
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour