Appointment の操作

ICS形式で予定を読み込み・保存

この Appointment Aspose.Email for Java のクラスは、ICS形式で予定を読み込むだけでなく、新しい予定を作成してディスクにICS形式で保存するために使用できます。この記事では、まず予定を作成し、ディスクにICS形式で保存し、次にそれを読み込みます。

ICS形式で予定を読み込む

ICS形式で予定を読み込むには、次の手順が必要です：

  1. インスタンスを作成します Appointment クラス。
  2. 呼び出す Load() メソッドは ICS ファイルのパスを指定します。
  3. アポイントメント (ICS ファイル) から任意のプロパティを読み取り、情報を取得します。

以下のコードスニペットは、ICS 形式のアポイントメントをロードする方法を示しています。

予定を作成し、ICS形式でディスクに保存

予定を作成し、ICS形式で保存するには、次の手順が必要です。

  1. インスタンスを作成します Appointment クラスをこのコンストラクタで初期化します。
  2. 上記コンストラクタに次の引数を渡します
    1. 参加者
    2. 説明
    3. 終了日
    4. 場所
    5. 主催者
    6. 開始日
    7. 概要
    8. 作成日
    9. 最終更新日 
  3. 呼び出す Save() メソッドで、引数としてファイル名と形式を指定します。

この予定は、Microsoft Outlook またはICSファイルを読み込める任意のプログラムで開くことができます。ファイルを Microsoft Outlook で開くと、予定は自動的に Outlook カレンダーに追加されます。

以下のコードスニペットは、予定を作成し、ディスクにICS形式で保存する方法を示しています。

予定を MSG 形式で保存

Aspose.Email を使用すると、予定を直接 .msg ファイルに保存できます。以下のパブリッククラスは、予定の保存プロセスをカスタマイズするために利用可能です：

  • AppointmentMsgSaveOptions MSG形式で予定を保存するための追加オプションを持つクラスです。
  • AppointmentIcsSaveOptions ICS形式で予定を保存するための追加オプションを持つクラスです。旧式の IcsSaveOptions の代わりに追加されました。

以下のコードサンプルは、ファイルから予定を読み込み、.ics と .msg の2つの異なる形式で保存する方法を示しています。

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

HTML コンテンツで予定を作成

iCalendar（RFC 5545）形式で X-ALT-DESC ヘッダーを使用することは一般的な慣習です。これは、カレンダー項目やイベントの代替の人間が読める説明を提供する拡張プロパティです。このヘッダーは、イベントの説明をプレーンテキストまたは HTML で表現するために使用され、古いカレンダーソフトウェアとの互換性や説明の簡易版を提供する際に役立ちます。受信側のカレンダーアプリケーションが主説明をサポートしない、または正しく表示できない場合、X-ALT-DESC ヘッダーは代替説明を提供します。送信者はイベント説明の異なる表現を含めることで、さまざまなカレンダーソフトウェアやプラットフォーム間の互換性とアクセシビリティを向上させます。HTML コンテンツで予定を作成するには、 HtmlDescription プロパティを ’true’ に設定します。以下のコードサンプルは、日付、時間、場所、主催者、参加者、および書式設定された説明を含む、特定の詳細と設定で予定オブジェクトを作成・定義する方法を示しています。

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

ドラフト予定リクエストを作成

予定をドラフトモードで保存するには、 Method プロパティ（ Appointment クラスは Publish に設定する必要があります。以下のコードサンプルは、このプロパティの使用例を示しています。

テキストからドラフト予定の作成

カレンダー項目への添付ファイルの追加と削除

Aspose.Email は、カレンダー項目に関連付けられた添付ファイルを追加および取得できる添付ファイルコレクションを提供します。本記事では、次の方法を示します：

  1. 添付ファイルを作成し、追加する Appointment クラスオブジェクト。
  2. 予定から添付ファイル情報を取得します。
  3. 予定から添付ファイルを抽出します。

予定の書式設定

以下のプログラミングサンプルは、 AppointmentFormattingOptions テキストと HTML をフォーマットするクラスです。

プログラミングサンプル - テキスト書式設定

プログラミングサンプル - HTML 書式設定

ICS ファイルから複数のイベントを読み取る

ICS ファイルへ複数のイベントを書き込む

予定参加者のステータスを設定

Aspose.Email for .NET API は、返信メッセージを作成する際に予定参加者のステータスを設定できるようにします。これにより、ICS ファイルに PARTSTAT プロパティが追加されます。

iCalendar の製品識別子をカスタマイズ

Aspose.Email for Java API は、iCalendar オブジェクトを作成した製品識別子を取得または設定できます。

予定を読み込む際のアドレス検証エラー回避方法

Aspose.Email for Java API は、次の設定によりメール検証エラーを回避できます。 IgnoreSmtpAddressCheck オプションは AppointmentLoadOptions オブジェクトを作成し、load 呼び出しに渡します。

AppointmentLoadOptions lo = new AppointmentLoadOptions();
lo.setIgnoreSmtpAddressCheck(true);
Appointment appointment = Appointment.load("app.ics", lo);
MIME メッセージの操作 Outlook アイテムの操作