To download the app, visit: [widget](https://library.tulip.co/apps/scheduling-custom-<span translate=)">Library
目的
スケジューリングカスタムウィジェットは、タスク管理のための革新的なソリューションとして機能します。このスケジューリングウィジェットは、Tulipアプリ内で使用されることを想定して設計されており、データベースから、それぞれ固有の所要時間を伴うタスクやジョブを取得します。
ウィジェットの左側に表示されるタスクは、縦に並んだリストとして表示されます。タスクを「スケジューリング」ウィジェットの右側にあるリソースのいずれかにドラッグ&ドロップすることで、タイムライン上にタスクやジョブをスケジュールできます。この割り当てにより、タスクやジョブが特定のリソースに関連付けられ、そのリソースがいつ対応するかが示されます。
要するに、このカスタムウィジェットは、直感的なドラッグ&ドロップ機能を通じてタスクとリソースの視覚的な関連付けを容易にし、タスク割り当てのプロセスを効率化することで、Tulipインターフェース内での効果的な管理とスケジューリングを可能にします。

設定
ウィジェットを設定する際、必須のパラメータもあれば、デフォルト値が設定されたオプションのパラメータもあります。
クライアントのシステムとの接続を確立するには、ウィジェットに以下が必要です:
- クライアントのインスタンスURL
- ログイン認証情報の代わりに使用する認証トークン
- クライアントが「DEFAULT」ワークスペースを使用していない場合は、ワークスペースIDも指定する必要があります。
認証が成功した後、スケジューリングウィジェットはリソースにアクセスする必要があります。リソースはリストから取得されます。リソースは、変数またはテーブルクエリから取得できます。
スケジューリングウィジェットのタスクは、テーブルIDとそのフィールドに基づいてTulipテーブルから取得されます。これらはカスタマイズ可能であるため、別のテーブルが使用されている場合でも、スケジューリングウィジェットはさらなる柔軟性を提供します。
スケジューリングウィジェットには、以下の設定パラメータがあります:
必須パラメータ
**リソース:**テキストリストです。テーブルから取得することも可能ですが、この場合はアプリ変数として管理されます。**列名:**フィールドIDはタスクテーブルレベルで確認できますので、1つずつ追加してください。
「Task」テーブルは以下の方法で確認できます:
フィールドIDは以下の方法で確認できます:
- タスクID
- タスク名
- ステータス列名
- 開始日列名
- 終了列名
- 期間列名
- リソース列名
**Basic Auth トークン:**右上隅のプロフィールをクリックし、「アカウント設定」を選択します。左側のパネルで「Tulip API」をクリックし、指示に従ってサービスアカウントを作成してください。**アカウント URL:**例:your-account.tulip.**co タスクテーブル ID:**テーブル ID は、テーブルレベルで確認できます。
**スケジュール設定日:**どの日を予定に組み込みますか?これは日時フィールドです。
オプションのパラメータ
**日の開始時刻:**タイムラインの開始時刻。デフォルト値は 06:00です。**日の終了時刻:タイムラインの終了時刻。 デフォルト値は 21:00です。時間単位(時間内):デフォルト値は 10(分単位)です。これは、タイムライン上でタスクを移動する際、例えば 07:10 や 07:20 などを選択でき、各ステップが 10 分間隔になることを意味します。 これを30に変更すると、07:00、07:30……といった選択が可能になり、各ステップは30分単位となります。単位幅:1ステップの幅(px)。このパラメータでウィジェットの幅を設定できます。 デフォルト値は 13 です。リソース名の幅:リソース列の幅(px)。デフォルト値は220です。オーバーラップ:ウィジェットはタスクの重なりに対応しています。デフォルト値は false です。インフォボックス:タスク名が切り取られた場合に、タスク名を確認するためのポップアップウィンドウです。 デフォルト値はfalseです。ステータス(このオプションは、インフォボックスが有効になっている場合に利用可能です):**スケジューリングウィジェットは、「Scheduled」と「Unscheduled」という 2 つの固定ステータスで動作します。さらに、「Completed」や「Cancelled」などの追加ステータスを定義する機能も提供しています。 カスタムステータスについては、色を指定できるほか、デフォルトの動作(ShowByDefault)を設定することも可能です。ShowByDefaultパラメータの設定に基づき、ShowByDefaultが「no」の場合はウィジェットがタスクを自動的に非表示にし、「yes」の場合はタスクを表示します。
カスタムステータスはインフォボックスで確認できます。
**現在のタイムスロットをハイライト表示:**リアルタイムの進行状況を示す縦線を表示し、タイムライン上の現在の位置を示します。デフォルト値は false です。
トリガー
スケジューリングウィジェットでは、以下のイベントが利用可能です:
タスクのスケジュール設定:****タイムラインにタスクが追加された場合 タスクのスケジュール解除:タイムラインからタスクが削除された場合 タスクの移動:****タスクのスケジュールが変更された直後タスクステータスの更新:****カスタムステータスを使用している場合**タスクの選択:**スケジュールされたタスクがクリックされた場合

「タスクが選択された」および「タスクステータスの更新」を除くすべてのトリガーでは、以下の結果が得られます:

「タスクが選択された」の結果は、タスクのIDです。これは、例えばレコードの読み込みなどに使用できます。
仕組み
データベース内のタスクテーブルからAPI呼び出しによってタスクを取得し、リソースはウィジェットのパラメータから取得されます。タスクはスケジューリングウィジェットの左側に表示され、リソースは右側に縦方向に一覧表示されます。各リソースには、タスクを配置できる日ごとのタイムラインがあります。 以前に割り当てられたタスクは、ウィジェットを再読み込みするとタイムラインに自動的に再表示されます。タスクがリソースにリンクされると、予定日の開始時刻と終了時刻が割り当てられ、その特定の日のスケジュールウィジェットのタイムラインにのみ表示されるようになります。スケジューリングウィジェットは、データベース内のCDMタスクテーブルと連携し、新しいスケジュールの登録、タスクの時間軸上またはリソース間の移動、およびダブルクリックによるリソースのタイムラインからのタスク削除(タスクを未スケジュール状態に設定)を記録します。これらのバックグラウンド処理は、組み込みのfireEvent関数を使用して実行されます。 fireEvent関数に関する詳細情報は、こちら{target=_blank}をご覧ください。追加機能:
- 「Overlap」パラメータをtrueに設定することでタスクの重複をサポートします。これは、同じリソース上で並行して実行されるタスクを処理する際に役立ちます。
- 「Infobox」パラメータをtrueに設定することでインフォボックスを有効化できます。タイムライン上にタスク名が収まらない場合があるため、クリックするとタスクの完全な名前が表示される小さなウィンドウが表示されます。
サービスアカウントの作成方法
Prior to r383, Service Accounts were called "API Tokens".
こちら{target=_blank}で、サービスアカウントの作成に関する詳細情報をご覧いただけます。
関連情報
custom widgets についてさらに詳しく知りたい場合は、以下のサイトをご覧ください:Custom Widgets 概要{target=_blank}
