Arbeiten mit Terminen

Termin im ICS-Format laden und speichern

Die Appointment Die Klasse in Aspose.Email für Java kann verwendet werden, um einen Termin im ICS-Format zu laden sowie einen neuen Termin zu erstellen und ihn auf der Festplatte im ICS-Format zu speichern. In diesem Artikel erstellen wir zunächst einen Termin, speichern ihn auf der Festplatte im ICS-Format und laden ihn anschließend.

Termin im ICS-Format laden

Um einen Termin im ICS-Format zu laden, sind die folgenden Schritte erforderlich:

  1. Erstellen Sie eine Instanz von dem Appointment Klasse.
  2. Rufen Sie die Load() Methode, indem Sie den Pfad der ICS‑Datei angeben.
  3. Lesen Sie beliebige Eigenschaften, um Informationen aus dem Termin (ICS‑Datei) zu erhalten.

Die folgenden Code‑Snippets zeigen, wie ein Termin im ICS‑Format geladen wird.

Einen Termin erstellen und auf der Festplatte im ICS-Format speichern

Die folgenden Schritte sind erforderlich, um einen Termin zu erstellen und im ICS-Format zu speichern.

  1. Erstellen Sie eine Instanz von dem Appointment Klasse und initialisieren Sie sie mit diesem Konstruktor.
  2. Geben Sie die folgenden Argumente im obigen Konstruktor an
    1. Teilnehmer
    2. Beschreibung
    3. Endedatum
    4. Ort
    5. Organisator
    6. Startdatum
    7. Zusammenfassung
    8. Erstellungsdatum
    9. Datum der letzten Änderung 
  3. Rufen Sie die Save() Methode und geben Sie den Dateinamen sowie das Format in den Argumenten an.

Der Termin kann in Microsoft Outlook oder jedem anderen Programm, das eine ICS-Datei laden kann, geöffnet werden. Wird die Datei in Microsoft Outlook geöffnet, fügt sie den Termin automatisch dem Outlook-Kalender hinzu.

Die folgenden Codeausschnitte zeigen, wie man einen Termin erstellt und auf der Festplatte im ICS-Format speichert.

Termine im MSG-Format speichern

Aspose.Email ermöglicht das direkte Speichern von Terminen in .msg-Dateien. Die folgenden öffentlichen Klassen stehen zur Anpassung des Speicherprozesses von Terminen zur Verfügung:

  • AppointmentMsgSaveOptions Klasse mit zusätzlichen Optionen zum Speichern von Terminen im msg-Format.
  • AppointmentIcsSaveOptions Klasse mit zusätzlichen Optionen zum Speichern von Terminen im ics-Format. Sie wurde hinzugefügt, um die veraltete IcsSaveOptions zu ersetzen.

Das untenstehende Codebeispiel zeigt, wie man einen Termin aus einer Datei lädt und ihn anschließend in zwei verschiedenen Formaten speichert: .ics und .msg.

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

Einen Termin mit HTML-Inhalt erstellen

Es ist gängige Praxis, den X-ALT-DESC-Header im iCalendar-Format (RFC 5545) zu verwenden. Es handelt sich dabei um eine erweiterte Eigenschaft, die eine alternative menschenlesbare Beschreibung eines Kalendereintrags oder Ereignisses liefert. Dieser Header wird häufig verwendet, um eine Klartext- oder HTML-Darstellung der Ereignisbeschreibung einzuschließen, was für die Kompatibilität mit älterer Kalendersoftware oder zur Bereitstellung einer vereinfachten Beschreibungsversion nützlich sein kann. In Fällen, in denen die primäre Beschreibung von der Kalenderanwendung des Empfängers nicht unterstützt oder korrekt angezeigt wird, wird der X-ALT-DESC-Header verwendet, um eine alternative Beschreibung des Ereignisses bereitzustellen. Er ermöglicht es dem Absender, verschiedene Darstellungen der Ereignisbeschreibung beizufügen, um eine bessere Kompatibilität und Zugänglichkeit über verschiedene Kalenderprogramme und Plattformen hinweg zu gewährleisten. Um einen Termin mit HTML-Inhalt zu erstellen, setzen Sie den HtmlDescription Eigenschaft auf ’true’ setzen. Versuchen Sie das folgende Codebeispiel, das zeigt, wie man ein Terminobjekt mit spezifischen Details und Einstellungen erstellt und definiert, einschließlich Datum, Uhrzeit, Ort, Organisator, Teilnehmer und einer formatierten Beschreibung:

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

Entwurf einer Terminanfrage erstellen

Um einen Termin im Entwurfsmodus zu speichern, muss die Method Eigenschaft des Appointment Die Klasse sollte auf Publish gesetzt werden. Das folgende Codebeispiel demonstriert die Verwendung dieser Eigenschaft als Beispiel.

Entwurf einer Terminerstellung aus Text

Hinzufügen und Entfernen von Anhängen zu Kalenderelementen

Aspose.Email stellt eine Anhangssammlung bereit, die zum Hinzufügen und Abrufen von Anhängen zu Kalenderelementen verwendet werden kann. Dieser Artikel zeigt, wie man:

  1. Erstellen und Hinzufügen von Anhängen zu einem Appointment Klassenobjekt.
  2. Informationen zu Anhängen aus einem Termin abrufen.
  3. Anhänge aus einem Termin extrahieren.

Termine formatieren

Die nachfolgenden Programmierbeispiele zeigen, wie man die AppointmentFormattingOptions Klasse zum Formatieren von Text und HTML.

Programmierbeispiel – Textformatierung

Programmierbeispiel – HTML-Formatierung

Mehrere Ereignisse aus einer ICS-Datei lesen

Mehrere Ereignisse in eine ICS-Datei schreiben

Status der Termin-Teilnehmer festlegen

Aspose.Email für .NET API ermöglicht es, den Status von Termin-Teilnehmern beim Verfassen einer Antwortnachricht festzulegen. Dies fügt die PARTSTAT-Eigenschaft zur ICS-Datei hinzu.

Produktkennung für iCalendar anpassen

Aspose.Email für Java API ermöglicht das Abrufen oder Setzen der Produktkennung, die das iCalendar-Objekt erstellt hat.

Umgehen der Adressvalidierung beim Laden von Terminen

Aspose.Email für Java API ermöglicht das Umgehen des E‑Mail‑Validierungsfehlers, indem man die IgnoreSmtpAddressCheck Option für das AppointmentLoadOptions Objekt und übergeben es an den Ladeaufruf.

AppointmentLoadOptions lo = new AppointmentLoadOptions();
lo.setIgnoreSmtpAddressCheck(true);
Appointment appointment = Appointment.load("app.ics", lo);
E‑Mail via MailGun und SendGrid in Java senden Arbeiten mit Outlook‑Elementen