Travailler avec les rendez‑vous

Charger et enregistrer un rendez‑vous au format ICS

Le Appointment La classe dans Aspose.Email pour Java peut être utilisée pour charger un rendez‑vous au format ICS ainsi que pour créer un nouveau rendez‑vous et l’enregistrer sur le disque au format ICS. Dans cet article, nous créons d’abord un rendez‑vous et l’enregistrons sur le disque au format ICS, puis nous le chargeons.

Charger un rendez‑vous au format ICS

Pour charger un rendez‑vous au format ICS, les étapes suivantes sont requises :

  1. Créez une instance de la Appointment classe.
  2. Appelez le Load() méthode en fournissant le chemin du fichier ICS.
  3. Lisez n’importe quelle propriété pour obtenir toute information du rendez‑vous (fichier ICS).

Les extraits de code suivants montrent comment charger un rendez‑vous au format ICS.

Créer un rendez‑vous et l’enregistrer sur le disque au format ICS

Les étapes suivantes sont requises pour créer un rendez‑vous et l’enregistrer au format ICS.

  1. Créez une instance de la Appointment classe et l’initialiser avec ce constructeur.
  2. Passez les arguments suivants dans le constructeur ci‑dessus
    1. Participants
    2. Description
    3. Date de fin
    4. Lieu
    5. Organisateur
    6. Date de début
    7. Résumé
    8. Date de création
    9. Date de dernière modification 
  3. Appelez le Save() méthode et spécifier le nom du fichier ainsi que le format dans les arguments.

Le rendez‑vous peut être ouvert dans Microsoft Outlook ou tout programme capable de charger un fichier ICS. Si le fichier est ouvert dans Microsoft Outlook, il ajoute automatiquement le rendez‑vous dans le calendrier Outlook.

Les extraits de code suivants montrent comment créer et enregistrer un rendez‑vous sur le disque au format ICS.

Enregistrement des rendez‑vous au format MSG

Aspose.Email permet d’enregistrer les rendez‑vous directement dans des fichiers .msg. Les classes publiques suivantes sont disponibles pour personnaliser le processus d’enregistrement des rendez‑vous :

  • AppointmentMsgSaveOptions classe avec des options supplémentaires pour enregistrer les rendez‑vous au format msg.
  • AppointmentIcsSaveOptions classe avec des options supplémentaires pour enregistrer le rendez‑vous au format ics. Elle a été ajoutée pour remplacer l’obsolète IcsSaveOptions.

L’exemple de code ci‑dessous montre comment charger un rendez‑vous depuis un fichier, puis l’enregistrer dans deux formats différents : .ics et .msg.

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

Créer un rendez‑vous avec du contenu HTML

Il est courant d’utiliser l’en‑tête X-ALT-DESC dans le format iCalendar (RFC 5545). Il s’agit d’une propriété étendue qui fournit une description lisible par l’homme, alternative, d’un élément ou d’un événement du calendrier. Cet en‑tête est souvent utilisé pour inclure une représentation en texte simple ou en HTML de la description de l’événement, ce qui peut être utile pour la compatibilité avec d’anciens logiciels de calendrier ou pour fournir une version simplifiée de la description. Dans les cas où la description principale n’est pas prise en charge ou affichée correctement par l’application de calendrier du destinataire, l’en‑tête X-ALT-DESC est utilisé pour fournir une description alternative de l’événement. Il permet à l’expéditeur d’inclure différentes représentations de la description de l’événement afin d’assurer une meilleure compatibilité et accessibilité à travers différents logiciels et plateformes de calendrier. Pour créer un rendez‑vous avec du contenu HTML, définissez le HtmlDescription propriété à ’true’. Essayez l’exemple de code suivant qui montre comment créer et définir un objet rendez‑vous avec des détails et paramètres spécifiques, incluant la date, l’heure, le lieu, l’organisateur, les participants, et une description formatée :

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>");

Créer une demande de rendez‑vous brouillon

Afin d’enregistrer un rendez‑vous en mode brouillon, le Method propriété du Appointment la classe doit être définie sur Publish. L’exemple de code suivant démontre l’utilisation de cette propriété à titre d’exemple.

Création d’un rendez‑vous brouillon à partir du texte

Ajout et suppression de pièces jointes aux éléments du calendrier

Aspose.Email fournit une collection de pièces jointes qui peut être utilisée pour ajouter et récupérer les pièces jointes associées aux éléments du calendrier. Cet article montre comment :

  1. Créer et ajouter des pièces jointes à un Appointment objet de classe.
  2. Récupérer les informations des pièces jointes d’un rendez‑vous.
  3. Extraire les pièces jointes d’un rendez‑vous.

Mise en forme des rendez‑vous

Les exemples de programmation ci‑dessous démontrent comment utiliser le AppointmentFormattingOptions classe pour formater le texte et le HTML.

Exemple de programmation – Mise en forme du texte

Exemple de programmation – Mise en forme HTML

Lire plusieurs événements depuis un fichier ICS

Écrire plusieurs événements dans un fichier ICS

Définir le statut des participants aux rendez‑vous

L’API Aspose.Email pour .NET vous permet de définir le statut des participants d’un rendez‑vous lors de la formulation d’un message de réponse. Cela ajoute la propriété PARTSTAT au fichier ICS.

Personnaliser l’identifiant du produit pour iCalendar

L’API Aspose.Email pour Java permet d’obtenir ou de définir l’identifiant du produit qui a créé l’objet iCalendar.

Comment contourner la validation d’adresse lors du chargement de rendez‑vous

L’API Aspose.Email pour Java permet de contourner l’erreur de validation d’email en définissant le IgnoreSmtpAddressCheck option sur le AppointmentLoadOptions objet et le passer à l’appel load.

AppointmentLoadOptions lo = new AppointmentLoadOptions();
lo.setIgnoreSmtpAddressCheck(true);
Appointment appointment = Appointment.load("app.ics", lo);
Travailler avec les messages MIME Travailler avec les éléments Outlook