AbstractTimelineSchedulePage - グローバル

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：12分

    • AbstractTimelineSchedulePage スクリプトインクルードは、タイムラインに表示されるデータの操作を容易にするヘルパークラスです。

    タイムラインに表示されるデータの処理は、指定されたスクリプトインクルードの対応する関数を実行することから始まります。他のスクリプトインクルードと同様に、言語構文は JavaScript であり、このタイプのリソースのデフォルトのセキュリティ制約に従います。ただし、さまざまなタイプの表示オプションは複雑であるため、ヘルパー クラスが作成されました。タイムラインを表示するには、 AbstractTimelineSchedulePage クラスを拡張し、対応するスケジュールページとペアリングします。少なくとも、拡張クラスは getItems() メソッドをオーバーライドする必要があります。これは、クライアントに表示されるアイテムを返すためのプライマリイベントハンドラーであるためです。

    クライアントは、 AbstractTimelineSchedulePage が返すデータを 2 つのフェーズで処理します。最初のフェーズでは、タイムラインを実際に更新します。その直後、設定されている場合、2 番目のフェーズに成功メッセージボックス、エラーメッセージボックス、またはダイアログメッセージプロンプトが表示されます。フェーズ 1 では、データを操作するためのオプションは次のとおりです。

    • アイテムを更新しない:これはデフォルトの動作です。フェーズ 1 の残りの手順は実行しないでください。
    • 特定のアイテムで更新: これはadd()を使用して行われます。
    • getItems() 関数を使用してタイムラインをレンダリングします。これは setDoReRenderTimeline(true) を使用して行われます。
    注:
    両方の TimelineItems が返され、setDoReRenderTimeline が true に設定されている場合、システムは setDoReRenderTimeline プロパティを無視し、add() 関数によって追加された TimelineItems のみを明示的に表示します。

    フェーズ 2 で利用可能なオプションは次のとおりです。

    • メッセージボックスを表示しない:これはデフォルトの動作です。
    • 成功ダイアログボックスの表示: これは setStatusSuccess() を使用して行います。
    • エラーダイアログボックスの表示: これは、setStatusError() を使用して行います。
    • ダイアログ確認ボックスを表示: これは setStatusPrompt() を使用して行います。
    注:

    AbstractTimelineSchedulePage を拡張するスクリプトインクルードクラスは、プリフィックスが sysparm_timeline_ で始まる元の URL からすべての URI パラメーターを自動的に受け取ります。これらの値にアクセスするには、拡張クラス内で this.getParameter("sysparm_timeline_VARIABLE"); を使用します。

    これは、リストのコンテキストメニューなど、動的要素からスケジュールページを表示する必要がある場合に便利です。URL を介して動的データを渡すことで、スケジュールページはこれらのパラメーターを Ajax 呼び出し内に自動的に含めるため、 AbstractTimelineSchedulePage スクリプトインクルード内でアクセスできるようになります。

    AbstractTimelineSchedulePage - add(オブジェクト ObjTimeline)

    クライアントに返され、タイムラインに適切に表示される TimelineItem オブジェクトを追加します。

    表 : 1. パラメーター
    名前 タイプ 説明
    Objタイムライン オブジェクト タイムラインに追加する TimelineItem オブジェクト。
    表 : 2. 返される内容
    タイプ 説明
    なし

    AbstractTimelineSchedulePage:addSeparator()

    タイムラインアイテムのリストに水平フレームセパレーターを追加します。add() を介して追加される以降のアイテムはすべて、後続のタイムラインフレームに追加されます。

    add() メソッドを使用して追加される以降のアイテムはすべて、後続のタイムラインフレームに追加されます。

    表 : 3. パラメーター
    名前 タイプ 説明
    なし
    表 : 4. 返される内容
    タイプ 説明
    なし

    次のコード例は、このメソッドを呼び出す方法を示しています。

    // Inside of a script include that extends AbstractTimelineSchedulePage
      this.addSeparator();

    AbstractTimelineSchedulePage - elementMoveX(String spanSysId, String newStartDateTimeMs)

    タイムラインスパンが水平方向に移動するときのイベントハンドラー。

    表 : 5. パラメーター
    名前 タイプ 説明
    spanSysId 文字列 調整中の現在のスパンの sys ID。
    newStartDateTimeM 文字列 スパンの新しい開始時間 (ミリ秒単位)。数値比較を実行する前に、 必ず parseInt() を使用して文字列を解析してください。
    表 : 6. 返される内容
    タイプ 説明
    なし

    AbstractTimelineSchedulePage - elementMoveXY(String spanSysId, String itemSysId, String itemSysId, String newItemSysId, String newStartDateTimeMs)

    タイムラインスパンが水平方向と垂直方向の両方に移動するときのイベントハンドラー。

    表 : 7. パラメーター
    名前 タイプ 説明
    spanSysId 文字列 調整中の現在のスパンの sys ID。
    itemSysId 文字列 現在のスパンに関連付けられているタイムラインアイテムの Sys ID。
    新しいアイテム SysID 文字列 現在のスパンがドラッグされたタイムラインアイテム (行) の Sys ID。
    newStartDateTimeM 文字列 スパンの新しい開始時間 (ミリ秒単位)。数値比較を実行する前に、 必ず parseInt() を使用して文字列を解析してください。
    表 : 8. 返される内容
    タイプ 説明
    なし

    AbstractTimelineSchedulePage - elementMoveY(文字列 spanSysId, 文字列 itemSysId, 文字列 newItemSysId)

    タイムラインスパンが垂直方向に移動するときのイベントハンドラー。

    表 : 9. パラメーター
    名前 タイプ 説明
    spanSysId 文字列 調整中の現在のスパンの sys ID。
    itemSysId 文字列 現在のスパンに関連付けられているタイムラインアイテムの Sys ID。
    新しいアイテム SysID 文字列 現在のスパンがドラッグされたタイムラインアイテム (行) の Sys ID。
    表 : 10. 返される内容
    タイプ 説明
    なし

    AbstractTimelineSchedulePage - elementSuccessor(文字列 spanSysId, 文字列 newSuccSpanId)

    2 つのスパン間にタイムライン関係が作成されたときのイベントハンドラー。

    表 : 11. パラメーター
    名前 タイプ 説明
    spanSysId 文字列 新しく作成された関係の先行処理となる、現在のスパンの sys ID。
    newSuccSpanId 文字列 作成された関係からの後続の Sys ID。
    表 : 12. 返される内容
    タイプ 説明
    なし 戻り値

    AbstractTimelineSchedulePage - elementTimeAdjustEnd(文字列 spanSysId, 文字列 newEndDateTimeMs)

    タイムラインスパンの終了日が変更されたときのイベントハンドラー。

    表 : 13. パラメーター
    名前 タイプ 説明
    spanSysId 文字列 調整中の現在のスパンの Sys ID。
    newEndDateTimeM 文字列 スパンの新しい終了時間 (ミリ秒単位)。数値比較を実行する前に、 必ず parseInt() を使用して文字列を解析してください。
    表 : 14. 返される内容
    タイプ 説明
    なし

    AbstractTimelineSchedulePage - elementTimeAdjustStart(文字列 spanSysId, 文字列 newStartDateTimeMs)

    タイムラインスパンの開始日が変更されたときのイベントハンドラー。

    表 : 15. パラメーター
    名前 タイプ 説明
    spanSysId 文字列 調整中の現在のスパンの Sys ID。
    newStartDateTimeM 文字列 スパンの新しい開始時間 (ミリ秒単位)。数値比較を実行する前に、 必ず parseInt() を使用して文字列を解析してください。
    表 : 16. 返される内容
    タイプ 説明
    なし

    AbstractTimelineSchedulePage - getItems()

    タイムラインに表示するスケジュールアイテムを返すためのイベントハンドラー。

    表 : 17. パラメーター
    名前 タイプ 説明
    なし
    表 : 18. 返される内容
    タイプ 説明
    なし

    AbstractTimelineSchedulePage - inputBox(文字列 strInputText)

    左ペインの入力ボックスに文字列が入力されたときのイベントハンドラー。

    表 : 19. パラメーター
    名前 タイプ 説明
    strInputText 文字列 左ペインの入力ボックスに入力されたテキスト。
    表 : 20. 返される内容
    タイプ 説明
    なし

    AbstractTimelineSchedulePage - itemMove(文字列 itemSysId, 文字列 newItemSysId)

    タイムラインの行アイテムが移動され、別の行アイテムにドラッグされたときのイベントハンドラー。

    表 : 21. パラメーター
    名前 タイプ 説明
    itemSysId 文字列 現在のスパンに関連付けられているタイムラインアイテムの Sys ID。
    新しいアイテム SysID 文字列 現在のスパンがドラッグされたタイムラインアイテム (行) の Sys ID。
    表 : 22. 返される内容
    タイプ 説明
    なし

    AbstractTimelineSchedulePage - setDoReRenderTimeline(ブール b)

    getItems() 関数を使用して、すべてのタイムラインアイテムを再レンダリングするかどうかを指定します。

    表 : 23. パラメーター
    名前 タイプ 説明
    b ブーリアン true の場合、サーバーの getItems() ハンドラーに新しいイベント呼び出しを行い、タイムラインを再レンダリングします。
    表 : 24. 返される内容
    タイプ 説明
    なし

    AbstractTimelineSchedulePage:setPageTitle(文字列 strTitle)

    タイムラインのタイトルとして表示するテキストを指定します。

    ページタイトルは、任意のインタラクティブイベントから設定(および更新)できます。ただし、 getItems() イベント中に設定することをお勧めします。

    表 : 25. パラメーター
    名前 タイプ 説明
    strTitle 文字列 タイムラインタイトルに表示されるテキスト。
    表 : 26. 返される内容
    タイプ 説明
    なし

    AbstractTimelineSchedulePage - setStatusError(文字列 strTitle, 文字列 strMessage)

    GlideTimeline イベント処理のフェーズ 2 で表示するタイトルとメッセージを指定して、現在のイベント要求をエラーステータスに設定します。

    表 : 27. パラメーター
    名前 タイプ 説明
    strTitle 文字列 ダイアログボックスのタイトルに表示されるテキスト。
    strメッセージ 文字列 ダイアログボックス内に表示されるテキスト。テキストには HTML の書式設定を含めることができます。
    表 : 28. 返される内容
    タイプ 説明
    なし

    AbstractTimelineSchedulePage - setStatusPrompt(文字列 strTitle, 文字列 strOkFunction, 文字列 strCancelFunction, 文字列 strCloseFunction)

    GlideTimeline イベント処理のフェーズ 2 中に確認ダイアログボックスに表示する、指定されたタイトルとメッセージを使用して、現在のイベント要求をプロンプトエラーステータスに設定します。 確認ボックスには [ OK ] ボタンと [キャンセル ] ボタンが表示され、それぞれがパラメーター引数で指定された関数を呼び出す新しいイベントを生成します。OK、キャンセル、およびクローズのカスタム定義関数は、現在のイベントと同じパラメーター引数を受け取ります。

    確認ボックスには [ OK ] ボタンと [キャンセル ] ボタンが表示され、それぞれがパラメーター引数で指定された関数を呼び出す新しいイベントを生成します。
    注:
    OK、キャンセル、およびクローズのカスタム定義関数は、現在のイベントと同じパラメーター引数を受け取ります。
    表 : 29. パラメーター
    名前 タイプ 説明
    strTitle 文字列 ダイアログボックスに表示するテキスト。テキストには HTML の書式設定を含めることができます。
    strOkFunction 文字列 ユーザーが [OK ] ボタンをクリックした場合に現在のスクリプトインクルードクラスを呼び出す関数。
    strCancelFunction 文字列 ユーザーが [キャンセル ] ボタンをクリックした場合に現在のスクリプトインクルードクラスを呼び出す関数。
    strCloseFunction 文字列 ユーザーが [閉じる] ボタンをクリックした場合に現在のスクリプトインクルードクラスを呼び出す関数。
    表 : 30. 返される内容
    タイプ 説明
    なし 
    var MyTimelineScriptIncludeClass = Class.create();
      MyTimelineScriptIncludeClass.prototype = Object.extendsObject(AbstractTimelineSchedulePage, {
      
      getItems: function() {
      //...
      },
      
      elementTimeAdjustEnd: function(spanSysId, newEndDateTimeMs) {
      // Display a status prompt dialog box
      this.setStatusPrompt('Confirm Action', 'Are you sure you want to do that?',
      'this._myOkHandlerFunction',  
      'this._myCancelHandlerFunction',
      'this._myCloseHandlerFunction');
      },
      
      _myOkHandlerFunction: function(spanSysId, newEndDateTimeMs) { // ... },
      
      _myCancelHandlerFunction: function(spanSysId, newEndDateTimeMs) { // ... },
      
      _myCloseHandlerFunction: function(spanSysId, newEndDateTimeMs) { // ... }
      };

    AbstractTimelineSchedulePage - setStatusSuccess(文字列 strTitle, 文字列 strMessage)

    GlideTimeline イベント処理のフェーズ 2 で表示するタイトルとメッセージを指定して、現在のイベント要求を成功ステータスに設定します。

    表 : 31. パラメーター
    名前 タイプ 説明
    strTitle 文字列 ダイアログボックスのタイトルに表示されるテキスト。
    strメッセージ 文字列 ダイアログボックス内に表示されるテキスト。テキストには HTML の書式設定を含めることができます。
    表 : 32. 返される内容
    タイプ 説明
    なし