ウィジェットの設定

ウィジェットのモード

Scheduling Calendar ウィジェットには、読み取り専用と動的の2つのモードがあります。デフォルトでは、変更を加えずにデータを表示、分析するための読み取り専用モードで起動します。動的モードに切り替えると、ウィジェット内でスケジュールオブジェクトを直接追加、編集、削除できます。

入力データ（パック）

• スケジュール名： 設定時にレイヤーを区別するための名前です。この値はウィジェット自体には表示されません。

• スケジュールオブジェクトセット： Scheduling Calendar ウィジェットへの入力変数で、表示するデータを決定します。このオブジェクトセットに選択するオブジェクトタイプには、開始時間と終了時間を表すプロパティが必要です。

• 開始時間： イベントの開始時間として使用する日付またはタイムスタンプのプロパティを選択します。

• 終了時間： イベントの終了時間として使用する日付またはタイムスタンプのプロパティを選択します。

• タイトル： ウィジェット内のオブジェクトパックに表示するラベル値として使用するプロパティを選択します。

• 色： グラフにイベントを表示するときに使用する色を選択します。

  • 静的： すべてのパックに使用する単一の色を選択します。
  • セグメント分け： プロパティを選択すると、選択したプロパティの値に基づいてウィジェットがパックを自動的に色分けします。
  • 動的： グラフ内のパックに適用する条件付き書式設定のルールを設定します。

• ポップオーバーのプロパティ： このセクションでは、ユーザーがカレンダー上のパックにカーソルを合わせたときに、ポップオーバーカードに表示するプロパティを指定します。

• 保存ハンドラーアクション（動的モード）： ドラッグアンドドロップのインタラクションに使用するアクションを選択します。このアクションは、スケジュールオブジェクトの開始時間と終了時間のプロパティを編集する変更アクションである必要があります。

  • アクションには、スケジュールオブジェクトの開始時間と終了時間を変更するためのパラメーターが必要です。
  • アクションのパラメーターIDは、開始時間と終了時間に選択したプロパティIDと完全に一致する必要があります。たとえば、次のようになります。
    • 開始時間のプロパティが start_time の場合、アクションのパラメーターIDも start_time である必要があります。
    • 終了時間のプロパティが end_time の場合、アクションのパラメーターIDも end_time である必要があります。
  • すべてのパラメーターを任意に指定する必要があります。

• ドラッグによる作成を有効化（動的モード）： エンドユーザーがカレンダーの空き領域をドラッグして新しいスケジュールオブジェクトを作成できるようにするアクションを選択します。設定と使用方法の詳細については、ドラッグして作成するを参照してください。

表示設定

• 週の開始日： グラフが週表示または月表示の場合に、週の始まりとする曜日を選択します。

• 間隔のサイズ（動的モードのみ）： デフォルトでは、ユーザーは Scheduling Calendar ウィジェット上の任意の時間に、分単位でオブジェクトを割り当てられます。スナップ動作により、ビルダーはオブジェクトを割り当てられる時間の間隔を設定できます。グラフ内の新しい位置にパックをドロップすると、最も近い間隔の開始位置にパックがスナップします。

• 開始時間： 日表示または週表示でグラフを開始する時間を選択します。

• 終了時間： 日表示または週表示でグラフを終了する時間を選択します。

ドラッグして作成する

Calendar ウィジェットでは、エンドユーザーが修飾キーを押しながらカレンダー上をドラッグして、新しいスケジュールオブジェクトを作成できます。

ドラッグによる作成の動作を設定する

1. Ontology Manager で、カレンダーレイヤーに表示されるオブジェクトタイプの作成アクションを作成します。このアクションには、次のパラメーターが必要です。

   • オブジェクトの開始時間プロパティ
   • オブジェクトの終了時間プロパティ
   • オブジェクトの作成時にユーザーに入力してもらう追加のプロパティ（任意）。

   開始時間と終了時間のパラメーターの型は、オブジェクトタイプの対応するプロパティに合わせて、タイムスタンプまたは日付のいずれかに設定できます。

2. Workshop で、入力データ (パック) > [カレンダーレイヤー] > インタラクション > ドラッグによる作成を有効化に移動します。

3. 設定した作成アクションを選択します。

4. 設定するパラメーターを選択を選択し、ローカルのデフォルト値で開始時間と終了時間のパラメーターをバインドします。

   • 開始時間のパラメーターには、選択した開始タイムスタンプ（パラメーターが日付型の場合は選択した開始日）を選択します。これにより、ドラッグして作成するときに、ドラッグを開始した時間がウィジェットから渡されます。
   • 終了時間のパラメーターには、選択した終了タイムスタンプ（または選択した終了日）を選択します。これにより、ドラッグして作成するときに、ドラッグを終了した時間がウィジェットから渡されます。

使用方法

新しいオブジェクトを作成するには、オペレーティングシステムに応じた修飾キーを押しながら、カレンダーの空き領域をドラッグします。

• macOS: Cmd (⌘) を押しながらドラッグします。
• Windows: Windows キーを押しながらドラッグします。

ドラッグを終了すると、ドラッグの開始時間と終了時間に基づいて、新しいオブジェクトの提案がウィジェットにすぐに表示されます。デフォルトでは、最大限の設定ができるよう、作成のたびにフォームがポップアップ表示されます。有効な場合はフォームを非表示にしてすぐに適用の設定を選択すると、このフォームが非表示になります。新しいオブジェクトがオントロジー内に作成されるのは、変更を保存したときのみです。

設定に関する一般的な問題

エラー：「アクションのパラメーターIDは、選択したプロパティの ID と一致する必要があります」

このエラーは、保存ハンドラーアクションのパラメーターIDが、ウィジェットの設定で使用されているプロパティIDと完全に一致していない場合に発生します。

原因： ウィジェットでは、次の ID が完全に一致している必要があります。

• 開始時間と終了時間のプロパティのプロパティID
• 保存ハンドラーアクションのパラメーターID

解決方法：

1. Ontology Manager でプロパティIDを確認します。
   • スケジュールオブジェクトタイプに移動します。
   • 正確なプロパティID（たとえば、start_time、end_time）を控えます。
2. アクションのパラメーターIDを確認します。
   • Ontology Manager で保存ハンドラーアクションを開きます。
   • アクションのパラメーター設定で、パラメーターIDがプロパティIDと完全に一致していることを確認します。
   • パラメーター名は異なっていてもかまいませんが、_パラメーターID_はプロパティIDと同一である必要があります。
3. 必要に応じて、プロパティIDと一致するようにアクションのパラメーターIDを編集します。