Trabajando con citas

Cargar y guardar una cita en formato ICS

El Appointment La clase en Aspose.Email for Java se puede usar para cargar una cita en formato ICS, así como para crear una nueva cita y guardarla en disco en formato ICS. En este artículo, primero creamos una cita y la guardamos en disco en formato ICS y luego la cargamos.

Cargar una cita en formato ICS

Para cargar una cita en formato ICS, se requieren los siguientes pasos:

  1. Cree una instancia de la Appointment clase.
  2. Llame al Load() método proporcionando la ruta del archivo ICS.
  3. Lea cualquier propiedad para obtener cualquier información de la cita (archivo ICS).

Los siguientes fragmentos de código muestran cómo cargar una cita en formato ICS.

Crear una cita y guardarla en disco en formato ICS

Se requieren los siguientes pasos para crear una cita y guardarla en formato ICS.

  1. Cree una instancia de la Appointment clase y inicialícela con este constructor.
  2. Pase los siguientes argumentos en el constructor anterior
    1. Asistentes
    2. Descripción
    3. Fecha de finalización
    4. Ubicación
    5. Organizador
    6. Fecha de inicio
    7. Resumen
    8. Fecha de creación
    9. Fecha de última modificación 
  3. Llame al Save() método y especificar el nombre del archivo y el formato en los argumentos.

La cita puede abrirse en Microsoft Outlook o en cualquier programa que pueda cargar un archivo ICS. Si el archivo se abre en Microsoft Outlook, este agrega automáticamente la cita al calendario de Outlook.

Los siguientes fragmentos de código muestran cómo crear y guardar una cita en disco en formato ICS.

Guardar citas en formato MSG

Aspose.Email permite guardar citas directamente en archivos .msg. Las siguientes clases públicas están disponibles para personalizar el proceso de guardado de citas:

El siguiente ejemplo de código muestra cómo cargar una cita desde un archivo y luego guardarla en dos formatos diferentes: .ics y .msg.

Appointment appointment = Appointment.load("fileName");
appointment.save("fileName.ics", new AppointmentIcsSaveOptions());
appointment.save("fileName.msg", new AppointmentMsgSaveOptions());

Crear una cita con contenido HTML

Es una práctica común usar el encabezado X-ALT-DESC en el formato iCalendar (RFC 5545). Es una propiedad extendida que proporciona una descripción alternativa legible por humanos de un elemento o evento del calendario. Este encabezado suele utilizarse para incluir una representación en texto plano o HTML de la descripción del evento, lo que puede ser útil para la compatibilidad con software de calendario más antiguo o para proporcionar una versión simplificada de la descripción. En casos en que la descripción primaria no sea compatible o no se muestre correctamente en la aplicación de calendario del destinatario, se utiliza el encabezado X-ALT-DESC para proporcionar una descripción alternativa del evento. Permite al remitente incluir diferentes representaciones de la descripción del evento para garantizar una mejor compatibilidad y accesibilidad en diferentes software y plataformas de calendario. Para crear una cita con contenido HTML, configure el HtmlDescription propiedad a ’true’. Pruebe el siguiente ejemplo de código que muestra cómo crear y definir un objeto de cita con detalles y configuraciones específicas, incluyendo la fecha, hora, ubicación, organizador, asistentes y una descripción formateada:

Date startDate = new Date();
Appointment appointment = new Appointment("Bygget 83",
        startDate, // start date
        addHours(startDate, 1), // end date
        new MailAddress("TintinStrom@from.com", "Tintin Strom"), // organizer
        MailAddressCollection.to_MailAddressCollection(
                new MailAddress("AinaMartensson@to.com", "Aina Martensson"))); // attendee
appointment.setHtmlDescription("<html>\n"
        + "     <style type=\"\"text/css\"\">\n"
        + "      .text {\n"
        + "             font-family:'Comic Sans MS';\n"
        + "             font-size:16px;\n"
        + "            }\n"
        + "     </style>\n"
        + "    <body>\n"
        + "     <p class=\"\"text\"\">Hi, I'm happy to invite you to our party.</p>\n"
        + "    </body>\n"
        + "    </html>");

Crear una solicitud de cita borrador

Para guardar una cita en modo borrador, el Method propiedad del Appointment la clase debe establecerse en Publish. El siguiente ejemplo de código muestra el uso de esta propiedad como ejemplo.

Creación de borrador de cita a partir de texto

Agregar y eliminar adjuntos de elementos del calendario

Aspose.Email proporciona una colección de adjuntos que se puede usar para agregar y recuperar archivos adjuntos asociados a elementos del calendario. Este artículo muestra cómo:

  1. Crear y añadir archivos adjuntos a un Appointment objeto de clase.
  2. Obtener información de los archivos adjuntos de una cita.
  3. Extraer archivos adjuntos de una cita.

Formatear citas

Los ejemplos de programación a continuación demuestran cómo usar el AppointmentFormattingOptions clase para formatear texto y HTML.

Ejemplo de programación - Formateo de texto

Ejemplo de programación - Formateo HTML

Leer varios eventos de un archivo ICS

Escribir varios eventos en un archivo ICS

Establecer el estado de los participantes de los asistentes a la cita

La API de Aspose.Email para .NET le permite establecer el estado de los asistentes a la cita al formular un mensaje de respuesta. Esto añade la propiedad PARTSTAT al archivo ICS.

Personalizar el identificador de producto para iCalendar

La API de Aspose.Email para Java permite obtener o establecer el identificador de producto que creó el objeto iCalendar.

Cómo evitar la validación de direcciones al intentar cargar citas

La API de Aspose.Email para Java permite evitar el error de validación de correo estableciendo el IgnoreSmtpAddressCheck opción en el AppointmentLoadOptions objeto y pasarlo a la llamada de carga.

AppointmentLoadOptions lo = new AppointmentLoadOptions();
lo.setIgnoreSmtpAddressCheck(true);
Appointment appointment = Appointment.load("app.ics", lo);
Trabajando con mensajes MIME Trabajando con elementos de Outlook