Calendarios y EWS en ExchangeCalendars and EWS in Exchange

Obtenga información sobre calendarios, carpetas y elementos de calendario, citas y reuniones en Exchange.Learn about calendars, calendar folders and items, appointments, and meetings in Exchange.

Probablemente esté familiarizado con muchas de las características de calendario de los clientes de correo electrónico como Outlook, lo que le permite realizar un seguimiento de las citas, programar reuniones, comprobar la disponibilidad de los usuarios, invitar a los asistentes y cambiar o cancelar reuniones.You're probably familiar with many of the calendar features in email clients like Outlook, which enable you to track appointments, schedule meetings, check people's availability, invite attendees, and change or cancel meetings.

Las características relacionadas con el calendario de Exchange son un poco diferentes de las que se ven en un cliente como Outlook.Calendar-related features in Exchange are a little different than what you see in a client like Outlook. En lugar de Mostrar información, EWS en Exchange le permite hacer cosas como crear, almacenar, enviar o cambiar la información.Instead of displaying information, EWS in Exchange enables you to do things like create, store, send, or change information. Para usar EWS para trabajar con calendarios, debe estar familiarizado con los conceptos, como el almacenamiento de la información, el tiempo, la periodicidad y el flujo de mensajes.To use EWS to work with calendars, you'll need to be familiar with concepts such as information storage, time, recurrence, and message flow. Más concretamente, debe estar familiarizado con lo siguiente:More specifically, you'll need to be familiar with the following:

  • Carpetas de calendario, elementos de calendario y vistas de calendarioCalendar folders, calendar items, and calendar views

  • Convocatorias de reunión, respuestas, programación, asistentes, recursos, salas y disponibilidadMeeting requests, responses, scheduling, attendees, resources, rooms, and availability

  • Duraciones de tiempo, zonas horarias y horas de inicio y finalización de reuniones y citasTime durations, time zones, and start and end times of meetings and appointments

  • Series periódicas, patrones de periodicidad, excepciones y citas y reuniones de instancia únicaRecurring series, recurrence patterns, exceptions, and single instance appointments and meetings

Afortunadamente, EWS y la API administrada de EWS proporcionan un amplio conjunto de operaciones y métodos que permiten realizar una amplia variedad de tareas relacionadas con el calendario.Fortunately, EWS and the EWS Managed API provide a rich set of operations and methods that enable you to perform a wide range of calendar-related tasks. Por ejemplo, mediante la API administrada de EWS, puede crear una reunión y enviar invitaciones a los asistentes con unas pocas líneas de código, como se muestra en el ejemplo siguiente.For example, using the EWS Managed API, you can create a meeting and send invitations to attendees with just a few lines of code, as shown in the following example.

            Appointment meeting = new Appointment(service);
            // Set the properties on the meeting object to create the meeting.
            meeting.Subject = "Team building exercise";
            meeting.Body = "Let's learn to really work as a team and then have lunch!";
            meeting.Start = DateTime.Now.AddDays(2);
            meeting.End = meeting.Start.AddHours(2);
            meeting.Location = "Conference Room 12";
            meeting.RequiredAttendees.Add("Mack.Chaves@contoso.com");
            meeting.RequiredAttendees.Add("Sadie.Daniels@contoso.com");
            meeting.OptionalAttendees.Add("Magdalena.Kemp@contoso.com");
            meeting.ReminderMinutesBeforeStart = 60;
            // Send the meeting request
            meeting.Save(SendInvitationsMode.SendToAllAndSaveCopy);

Carpetas de calendario y elementos de calendarioCalendar folders and calendar items

Las carpetas de calendario contienen elementos de calendario.Calendar folders contain calendar items. Las carpetas de calendarios tienen una clase de carpeta de ipf. Citay puede incluir solo los elementos definidos por la propiedad de la API administrada de EWS de ItemClass , que está asociada con un objeto de clase de cita o el elemento CalendarItemType de EWS.Calendar folders have a folder class of IPF.Appointment, and can include only the items defined by the ItemClass EWS Managed API property, which is associated with an Appointment Class object, or the EWS CalendarItemType element.

Los elementos de una carpeta calendario son ligeramente diferentes de los elementos de otras carpetas de un buzón, ya que las repeticiones de una serie periódica y las excepciones a una serie periódica no son elementos reales en el buzón de correo, sino que se almacenan internamente como datos adjuntos en un maestro recurrente.Items in a Calendar folder are a little different from items in other folders in a mailbox because occurrences in a recurring series and exceptions to a recurring series are not actual items in the mailbox, but rather are stored internally as attachments to a recurring master. Por lo tanto, para poder recuperar todas las citas de un intervalo de fechas determinado, debe usar una vista de calendario.Therefore, in order to retrieve all appointments in a given date range, you need to use a calendar view. Para obtener más información sobre cómo recuperar las citas y las vistas de calendario, vea obtener citas y reuniones mediante EWS en Exchange.To learn more about retrieving appointments and calendar views, see Get appointments and meetings by using EWS in Exchange.

Reuniones y citasMeetings and appointments

La diferencia fundamental entre las reuniones y las citas es que las reuniones tienen asistentes y las citas no.The essential difference between meetings and appointments is that meetings have attendees, and appointments don't. Internamente, Exchange usa el mismo objeto para las reuniones y las citas.Internally, Exchange uses the same object for both meetings and appointments. Use la clase de cita de API administrada EWS o el elemento CalendarItem de EWS para trabajar con reuniones y citas.You use the EWS Managed API Appointment class or the EWS CalendarItem element to work with meetings and appointments.

Las citas y las reuniones pueden ser únicas o formar parte de una serie periódica, pero debido a que las citas no incluyen asistentes, salones o recursos, no necesitan que se envíe un mensaje.Both appointments and meetings can be single instances or part of a recurring series, but because appointments don't include attendees, rooms, or resources, they do not require a message to be sent.

Debido a que las reuniones incluyen el envío y la respuesta a solicitudes y actualizaciones, implican algo más que obtener acceso a los elementos de una carpeta de calendario.Because meetings include sending and responding to requests and updates, they involve more than just accessing items in a Calendar folder. También tienen un flujo de trabajo asociado.They also have an associated workflow. Las reuniones deben programarse cuando los asistentes están disponibles, y también pueden implicar la reserva de una sala de reuniones o recursos como un proyector u otro equipo.Meetings must be scheduled when attendees are available, and can also involve reserving a meeting room, or resources such as a projector or other equipment.

El flujo de trabajo de reuniones suele implicar los siguientes pasos:The meeting workflow typically involves the following steps:

  1. Una reunión se crea y se rellena con información como la hora de inicio y finalización, la ubicación y el cuerpo de un mensaje.A meeting is created and populated with information such as start and end time, location, and a message body.

  2. Se crea una lista de los asistentes, los recursos y las salas potenciales.A list of prospective attendees, resources, and rooms is created.

  3. Se comprueba el estado de disponibilidad de los asistentes.The availability status of attendees is checked.

  4. Se envía una convocatoria de reunión a los asistentes.A meeting request is sent to attendees.

  5. Los asistentes responden a la reunión con su intención de asistir o no.Attendees reply to the meeting with their intention to attend or not. Los asistentes también pueden proponer una nueva hora para la reunión.Attendees may also propose a new time for the meeting.

  6. Las reuniones se pueden cancelar o actualizar, lo que normalmente desencadena que se envíen nuevos mensajes a los asistentes.Meetings can be canceled or updated, which typically trigger new messages to be sent to attendees.

Calendarios y horaCalendars and time

La funcionalidad relacionada con el tiempo es fundamental para el calendario.Time-related functionality is integral to calendaring. Las citas y las reuniones tienen horas de inicio y finalización, duraciones y otras propiedades relacionadas con el tiempo, como la hora en la que se crea, envía y recibe un mensaje.Appointments and meetings have start and end times, durations, and other time-related properties, such as the time at which a message is created, sent, and received. Las citas y reuniones existentes se pueden recuperar de una carpeta de calendario a partir de una hora de inicio y de finalización.Existing appointments and meetings can be retrieved from a Calendar folder based on a start and end time. Las series periódicas tienen principio y fin.Recurring series have beginnings and ends. Las reuniones se producen dentro de una zona horaria determinada, que es cada vez más importante en una economía global.And meetings occur within a given time zone, which is increasingly important in a global economy.

Las horas se almacenan internamente en un servidor de Exchange en la hora universal coordinada (UTC).Times are stored internally on an Exchange server in Coordinated Universal Time (UTC). Exchange los convierte en la zona horaria local según la configuración del cliente.Exchange converts them to local time zone based on client settings. Las propiedades DateTime tienen un ámbito de la zona horaria local del equipo.DateTime properties are scoped to the computer's local time zone.

Serie periódicaRecurring series

Una serie de citas o reuniones periódicas consta de un maestro recurrente, un conjunto de elementos de repeticiones y, opcionalmente, un conjunto de elementos de excepción.A recurring series of appointments or meetings is comprised of a recurring master, a set of occurrence items, and optionally, a set of exception items. La información de periodicidad se almacena en el elemento maestro periódico.Recurrence information is stored on the recurring master item. El elemento EWS RecurringMasterItemId está asociado a ocurrencias y excepciones en una serie, o bien puede usar el método de API administrada de EWS appointment. BindToRecurringMaster para obtener el patrón recurrente.The RecurringMasterItemId EWS element is associated with occurrences and exceptions in a series, or you can use the Appointment.BindToRecurringMaster EWS Managed API method to get the recurring master. Mediante el uso de una instancia de una serie, puede encontrar todos los elementos e información asociados a la serie.Using an instance of a series, you can find all the elements and information associated with the series.

Tenga en cuenta que las propiedades de periodicidad existen en todos los elementos de calendario, pero solo se rellenan en elementos maestros periódicos.Note that recurrence properties exist on all calendar items, but they are populated only on recurring master items. Además de un índice de todas las apariciones de una serie, el patrón recurrente tiene una referencia a repeticiones modificadas y eliminadas, así como el patrón de periodicidad de una serie (por ejemplo, diaria, semanal, mensual o anual).In addition to an index of all occurrences in a series, the recurring master has a reference to modified and deleted occurrences and the recurrence pattern of a series (for example, daily, weekly, monthly, or yearly).

En esta secciónIn this section

Vea tambiénSee also