埋め込みスケジューラを作成する

このタスクについて

埋め込みスケジューラを使用すると、ユーザーのスケジュールを表示するためのフォームやサブフォームを設計することができます。例えば、部の会議をスケジュールするユーザー用のフォームを作成することができます。フォームにスケジューラを埋め込むと、すべてのユーザーのスケジュールを確認しながら会議の時間を設定することができます。また、埋め込みスケジューラ内でユーザー名をクリックして、そのユーザーのカレンダービューを開くこともできます (ただし、そのユーザーのメールプリファレンスで権限が与えられている場合のみ)。プログラミングにより、カレンダーが別のフレーム内、またはそれ自体のウィンドウで開くように設定できます。埋め込みスケジューラのフォームの例については、[メール (6)] テンプレートの [グループカレンダー] フォームを参照してください。

埋め込みスケジューラの役割には次の 4 つがあります。

親トピック: 埋め込みコントロール

フォームまたはサブフォームで埋め込みスケジューラを作成する

このタスクについて

1 つ以上の埋め込みスケジューラを、フォームまたはサブフォームに埋め込むことができます。

手順

  1. 埋め込みスケジューラのフォームまたはサブフォームを開くか、作成します。
  2. 埋め込みスケジューラを表示する場所にカーソルを移動します。
  3. [作成] - [埋め込み設計要素] - [スケジューラ] を選択します。

タスクの結果

注: フォームまたはサブフォームの設計時には、埋め込みスケジューラはスケジュール情報を表示しません。

埋め込みスケジューラのフィールドを作成する

このタスクについて

埋め込みスケジューラは、誰のスケジュールを表示するにも、まず次の 3 つの情報を必要とします。

  • 誰の情報を表示するか (個人またはグループ)。
  • スケジュール情報をどの週から開始するか。
  • スケジュール情報を 1 日何時間表示するか。

これらのデータを収集する 1 つの方法は、フォーム上に編集可能なフィールドを作成し、ユーザーが表示したい情報を自分で入力できるようにすることです。また、LotusScript® や式言語を使用して、フィールドアイテムを作成することもできます。アクションボタンと式言語を使用してデータを収集する例を、[メール (6)] テンプレートの [GroupScheduler] フォームで参照してください。

フィールドを作成したら、または他のデータ収集手段が整ったら、それらのフィールドを埋め込みスケジューラ属性と関連付けます。

埋め込みスケジューラをプログラミングする

このタスクについて

データ収集用のフィールドを作成後、埋め込みスケジューラがフィールドからデータを取り出せるようプログラミングする必要があります。次の属性を使用して、埋め込みスケジューラをプログラミングできます。

フィールドを属性と関連付けるには:

手順

  1. インフォリストの [オブジェクト] タブから属性を選択します。
  2. プログラムペインのスクリプトエリアに、フィールド名を引用符で囲んで入力します。

    属性

    説明

    Required people items

    複数のアイテム名のテキストリストを評価する式です。実行時に、スケジュールにより必須ユーザーが表示されます。

    この属性のデータを取得するための式を LotusScript で記述する場合は、1 つまたは複数のフィールド名のテキストリストと照らし合わせて評価を行わなくてはなりません。

    Optional people items

    複数のアイテム名のテキストリストを評価する式です。実行時に、スケジュールによりオプションのユーザーが表示されます。

    Rooms items

    複数のアイテム名のテキストリストを評価する式です。実行時に、スケジュールにより一連の会議室が表示されます。

    Resources items

    複数のアイテム名のテキストリストを評価する式です。実行時に、スケジュールにより一連のリソースの会議室が表示されます。

    Interval start time

    任意のアイテム名を評価する式です。実行時に、このアイテムに含まれる日時の値は、会議の開始日時を示します。

    Interval end time

    任意のアイテム名を評価する式です。実行時に、このアイテムに含まれる日時の値は、会議の終了日時を示します。

    Grid Start time

    任意のアイテム名を評価する式です。この属性が指定されていない場合、スケジュールの使用時間のグリッドが現在の日時から始まります。イベントが指定されている場合、このアイテムに含まれる日時が検証されます。

    日時の値の時刻の部分が ALLDAY に設定されていると、使用時間のグリッドに指定した日付と現在の時刻が使用されます。日時の値の時刻の部分が ANYDAY に設定されていると、使用時間のグリッドに現在の日付と指定した時刻が使用されます。

    このフィールドの値は、日時でなくてはなりません。値が日付と時刻ではない場合は、ユーザーのシステムの現在の日時がデフォルトになります。値が日付だけの場合は、その日付とユーザーのシステムの現在の時刻がデフォルトになります。値が時刻だけの場合は、その時刻とユーザーのシステムの現在の日付がデフォルトになります。

    ユーザーがフォームにアクセスすると、スケジュール情報は指定された日付から始まります。ユーザーは、矢印キーをクリックすることで、表示される週を変えることができます。 毎日が指定の時刻から始まります。時刻は、分単位以下が切り捨てられ、時間単位で表示されます。

    スケジュールは、ユーザーの地方時間帯に依存します。例えば、太平洋時間帯で 9 時から 5 時が空き時間のユーザーは、EST ユーザーにとっては 12 時から 8 時の間が空き時間として表示されます。

    Display hours per day

    任意のアイテム名を評価する式です。実行時に、このアイテムに含まれる数値は、日付ごとの使用時間のグリッドが表示される時間帯を示します。

    この属性は、各個人のスケジュールを何時間表示するかを判断するのに使用されます。このフィールドの値は 1 から 24 の整数のいずれかでなくてはなりません。1 未満の値はデフォルトで 1 とされ、24 より大きい値はデフォルトで 12 とされます。

    Schedule Detail items

    複数のアイテム名のテキストリストを評価する式です。スケジュールによりスケジューリングデータが取り出された場合、これらのアイテムの詳細なデータが要求されます。

凡例を表示する

手順

埋め込みスケジューラが含まれるフォーム上に予約フィールドを作成し、ユーザーが凡例の表示をオフまたはオンに切り替えられるように設定できます。予約フィールドの名前は「$GroupScheduleShowLegend」です。有効な値は、「0 - 凡例表示をオフにする」と、「1 - 凡例表示をオンにする」です。

埋め込みスケジューラのプロパティを設定する

手順

  1. [埋め込みスケジューラのプロパティ] インフォボックスを開きます。
  2. [情報] タブでは、埋め込みスケジューラの次のプロパティを指定できます。
    • 名前 -- スケジュール要素の名前です。この名前は、スケジュールコントロールの LotusScript オブジェクトの取得に使用されます。
    • 対象フレーム -- グループメンバーのカレンダービューと予定文書を表示するフレームを指定します。
    • 間隔の表示 -- 予定のインジケータを表示するかどうか指定します (予定インジケータはドラッグできます)。
    • 色の説明を表示 -- このプロパティをチェックすると、使用時間のカラー凡例が表示されます。
    • 三角アイコンの表示 -- このプロパティをチェックすると、必須ユーザーとオプションユーザーの三角アイコンが表示され、ユーザーはこれらのユーザーのリストを展開または省略表示できます。
    • チェックボックスの表示 -- このプロパティをチェックすると、スケジューラに登録されているユーザーの名前の左側にチェックボックスが表示され、スケジューラを表示している任意のユーザーが登録ユーザーの選択を解除できます。

    • アイテムの値で初期化 -- このプロパティをチェックすると、スケジュールコントロールにより、以前に指定したアイテムの値に基づき表示される参加者が決定されます (上の属性の表を参照)。このフィールドのチェックを解除して、R5 のグループスケジュールとの互換性を持たせることもできます。
    • アイテムの値で更新 -- このプロパティをチェックすると、スケジュールコントロールにより、以前に指定したアイテムの値に基づきデータを更新できます。DocRecalc イベントが発生していて、この属性がチェックされている場合、スケジュールコントロールはすべての参加者データを破棄して、フォームのアイテムの値に基づいて参加者リストを新規に生成します。また、会議の開始と終了時刻や表示時刻、表示の開始時刻なども更新されます。NotesUIScheduler オブジェクトを使用して参加者の追加や削除を行うと問題が発生するため、NotesUIScheduler オブジェクトを使用して AddAttendee または RemoveAttendee の呼び出しを行う場合には、このフィールドのチェックを解除できます。
    • フィルターを許可 -- このフィールドをチェックすると、参加者名の前に表示される [フィルター] ボタンが有効になります。
    • 上タイトル、中央タイトル、下タイトル -- 埋め込みスケジューラの先頭、中央、末尾のタイトルを指定できます。各タイトルの式の記号をクリックして、タイトルを評価する式を入力できます。
  3. 埋め込みスケジューラのプロパティインフォボックスの [色] タブでは、前景色と背景色をカスタマイズできます。
  4. 埋め込みスケジューラのプロパティインフォボックスの [レイアウト] タブでは、埋め込みスケジューラの幅や高さのプロパティを設定できます。