--- sourceDocument: オーストラリア API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference Release : - australia ft:locale : - ja-JP ft:publication_title : - オーストラリア API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # AbstractTimelineSchedulePage - グローバル # AbstractTimelineSchedulePage - グローバル {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：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) {#ariaid-title2} クライアントに返され、タイムラインに適切に表示される TimelineItem オブジェクトを追加します。 {#r_ATSP-add_O__table_efq_q14_15__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | Objタイムライン | オブジェクト | タイムラインに追加する TimelineItem オブジェクト。 | [表 : 1. パラメーター] {#r_ATSP-add_O__table_efq_q14_15} {#r_ATSP-add_O__table_ffq_q14_15__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 2. 返される内容] {#r_ATSP-add_O__table_ffq_q14_15} ## AbstractTimelineSchedulePage:addSeparator() {#ariaid-title3} タイムラインアイテムのリストに水平フレームセパレーターを追加します。add() を介して追加される以降のアイテムはすべて、後続のタイムラインフレームに追加されます。 add() メソッドを使用して追加される以降のアイテムはすべて、後続のタイムラインフレームに追加されます。 {#r_ATSP-addSeparator__table_gfq_q14_15__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 3. パラメーター] {#r_ATSP-addSeparator__table_gfq_q14_15} {#r_ATSP-addSeparator__table_hfq_q14_15__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 4. 返される内容] {#r_ATSP-addSeparator__table_hfq_q14_15} 次のコード例は、このメソッドを呼び出す方法を示しています。 // Inside of a script include that extends AbstractTimelineSchedulePage this.addSeparator(); ## AbstractTimelineSchedulePage - elementMoveX(String spanSysId, String newStartDateTimeMs) {#ariaid-title4} タイムラインスパンが水平方向に移動するときのイベントハンドラー。 {#r_ATSP-elementMoveX_S_S__table_x3f_tc4_15__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | spanSysId | 文字列 | 調整中の現在のスパンの sys ID。 | | newStartDateTimeM | 文字列 | スパンの新しい開始時間 (ミリ秒単位)。数値比較を実行する前に、 必ず parseInt() を使用して文字列を解析してください。 | [表 : 5. パラメーター] {#r_ATSP-elementMoveX_S_S__table_x3f_tc4_15} {#r_ATSP-elementMoveX_S_S__table_y3f_tc4_15__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 6. 返される内容] {#r_ATSP-elementMoveX_S_S__table_y3f_tc4_15} ## AbstractTimelineSchedulePage - elementMoveXY(String spanSysId, String itemSysId, String itemSysId, String newItemSysId, String newStartDateTimeMs) {#ariaid-title5} タイムラインスパンが水平方向と垂直方向の両方に移動するときのイベントハンドラー。 {#r_ATSP-elementMoveXY_S_S_S_S_S__table_bjf_tc4_15__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | spanSysId | 文字列 | 調整中の現在のスパンの sys ID。 | | itemSysId | 文字列 | 現在のスパンに関連付けられているタイムラインアイテムの Sys ID。 | | 新しいアイテム SysID | 文字列 | 現在のスパンがドラッグされたタイムラインアイテム (行) の Sys ID。 | | newStartDateTimeM | 文字列 | スパンの新しい開始時間 (ミリ秒単位)。数値比較を実行する前に、 必ず parseInt() を使用して文字列を解析してください。 | [表 : 7. パラメーター] {#r_ATSP-elementMoveXY_S_S_S_S_S__table_bjf_tc4_15} {#r_ATSP-elementMoveXY_S_S_S_S_S__table_cjf_tc4_15__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 8. 返される内容] {#r_ATSP-elementMoveXY_S_S_S_S_S__table_cjf_tc4_15} ## AbstractTimelineSchedulePage - elementMoveY(文字列 spanSysId, 文字列 itemSysId, 文字列 newItemSysId) {#ariaid-title6} タイムラインスパンが垂直方向に移動するときのイベントハンドラー。 {#r_ATSP-elementMoveY_S_S_S__table_z3f_tc4_15__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | spanSysId | 文字列 | 調整中の現在のスパンの sys ID。 | | itemSysId | 文字列 | 現在のスパンに関連付けられているタイムラインアイテムの Sys ID。 | | 新しいアイテム SysID | 文字列 | 現在のスパンがドラッグされたタイムラインアイテム (行) の Sys ID。 | [表 : 9. パラメーター] {#r_ATSP-elementMoveY_S_S_S__table_z3f_tc4_15} {#r_ATSP-elementMoveY_S_S_S__table_ajf_tc4_15__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 10. 返される内容] {#r_ATSP-elementMoveY_S_S_S__table_ajf_tc4_15} ## AbstractTimelineSchedulePage - elementSuccessor(文字列 spanSysId, 文字列 newSuccSpanId) {#ariaid-title7} 2 つのスパン間にタイムライン関係が作成されたときのイベントハンドラー。 {#r_ATSP-elementSuccessor_S_S__table_djf_tc4_15__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | spanSysId | 文字列 | 新しく作成された関係の先行処理となる、現在のスパンの sys ID。 | | newSuccSpanId | 文字列 | 作成された関係からの後続の Sys ID。 | [表 : 11. パラメーター] {#r_ATSP-elementSuccessor_S_S__table_djf_tc4_15} {#r_ATSP-elementSuccessor_S_S__table_ejf_tc4_15__entry__2} | タイプ | 説明 | |-|-| | なし | 戻り値 | [表 : 12. 返される内容] {#r_ATSP-elementSuccessor_S_S__table_ejf_tc4_15} ## AbstractTimelineSchedulePage - elementTimeAdjustEnd(文字列 spanSysId, 文字列 newEndDateTimeMs) {#ariaid-title8} タイムラインスパンの終了日が変更されたときのイベントハンドラー。 {#r_ATSP-elementTimeAdjustEnd_S_S__table_qbb_3g4_15__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | spanSysId | 文字列 | 調整中の現在のスパンの Sys ID。 | | newEndDateTimeM | 文字列 | スパンの新しい終了時間 (ミリ秒単位)。数値比較を実行する前に、 必ず parseInt() を使用して文字列を解析してください。 | [表 : 13. パラメーター] {#r_ATSP-elementTimeAdjustEnd_S_S__table_qbb_3g4_15} {#r_ATSP-elementTimeAdjustEnd_S_S__table_rbb_3g4_15__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 14. 返される内容] {#r_ATSP-elementTimeAdjustEnd_S_S__table_rbb_3g4_15} ## AbstractTimelineSchedulePage - elementTimeAdjustStart(文字列 spanSysId, 文字列 newStartDateTimeMs) {#ariaid-title9} タイムラインスパンの開始日が変更されたときのイベントハンドラー。 {#r_ATSP-elementTimeAdjustStart_S_S__table_obb_3g4_15__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | spanSysId | 文字列 | 調整中の現在のスパンの Sys ID。 | | newStartDateTimeM | 文字列 | スパンの新しい開始時間 (ミリ秒単位)。数値比較を実行する前に、 必ず parseInt() を使用して文字列を解析してください。 | [表 : 15. パラメーター] {#r_ATSP-elementTimeAdjustStart_S_S__table_obb_3g4_15} {#r_ATSP-elementTimeAdjustStart_S_S__table_pbb_3g4_15__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 16. 返される内容] {#r_ATSP-elementTimeAdjustStart_S_S__table_pbb_3g4_15} ## AbstractTimelineSchedulePage - getItems() {#ariaid-title10} タイムラインに表示するスケジュールアイテムを返すためのイベントハンドラー。 {#r_ATSP-getItems__table_v3f_tc4_15__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 17. パラメーター] {#r_ATSP-getItems__table_v3f_tc4_15} {#r_ATSP-getItems__table_w3f_tc4_15__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 18. 返される内容] {#r_ATSP-getItems__table_w3f_tc4_15} ## AbstractTimelineSchedulePage - inputBox(文字列 strInputText) {#ariaid-title11} 左ペインの入力ボックスに文字列が入力されたときのイベントハンドラー。 {#r_ATSP-inputBox_S__table_sbb_3g4_15__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | strInputText | 文字列 | 左ペインの入力ボックスに入力されたテキスト。 | [表 : 19. パラメーター] {#r_ATSP-inputBox_S__table_sbb_3g4_15} {#r_ATSP-inputBox_S__table_tbb_3g4_15__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 20. 返される内容] {#r_ATSP-inputBox_S__table_tbb_3g4_15} ## AbstractTimelineSchedulePage - itemMove(文字列 itemSysId, 文字列 newItemSysId) {#ariaid-title12} タイムラインの行アイテムが移動され、別の行アイテムにドラッグされたときのイベントハンドラー。 {#r_ATSP-itemMove_S_S__table_ubb_3g4_15__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | itemSysId | 文字列 | 現在のスパンに関連付けられているタイムラインアイテムの Sys ID。 | | 新しいアイテム SysID | 文字列 | 現在のスパンがドラッグされたタイムラインアイテム (行) の Sys ID。 | [表 : 21. パラメーター] {#r_ATSP-itemMove_S_S__table_ubb_3g4_15} {#r_ATSP-itemMove_S_S__table_vbb_3g4_15__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 22. 返される内容] {#r_ATSP-itemMove_S_S__table_vbb_3g4_15} ## AbstractTimelineSchedulePage - setDoReRenderTimeline(ブール b) {#ariaid-title13} getItems() 関数を使用して、すべてのタイムラインアイテムを再レンダリングするかどうかを指定します。 {#r_ATSP-setDoReRenderTimeline_B__table_kfq_q14_15__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | b | ブーリアン | true の場合、サーバーの getItems() ハンドラーに新しいイベント呼び出しを行い、タイムラインを再レンダリングします。 | [表 : 23. パラメーター] {#r_ATSP-setDoReRenderTimeline_B__table_kfq_q14_15} {#r_ATSP-setDoReRenderTimeline_B__table_lfq_q14_15__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 24. 返される内容] {#r_ATSP-setDoReRenderTimeline_B__table_lfq_q14_15} ## AbstractTimelineSchedulePage:setPageTitle(文字列 strTitle) {#ariaid-title14} タイムラインのタイトルとして表示するテキストを指定します。 ページタイトルは、任意のインタラクティブイベントから設定(および更新)できます。ただし、 getItems() イベント中に設定することをお勧めします。 {#r_ATSP-setPageTitle_S__table_ifq_q14_15__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | strTitle | 文字列 | タイムラインタイトルに表示されるテキスト。 | [表 : 25. パラメーター] {#r_ATSP-setPageTitle_S__table_ifq_q14_15} {#r_ATSP-setPageTitle_S__table_jfq_q14_15__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 26. 返される内容] {#r_ATSP-setPageTitle_S__table_jfq_q14_15} ## AbstractTimelineSchedulePage - setStatusError(文字列 strTitle, 文字列 strMessage) {#ariaid-title15} GlideTimeline イベント処理のフェーズ 2 で表示するタイトルとメッセージを指定して、現在のイベント要求をエラーステータスに設定します。 {#r_ATSP-setStatusError_S_S__table_mfq_q14_15__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | strTitle | 文字列 | ダイアログボックスのタイトルに表示されるテキスト。 | | strメッセージ | 文字列 | ダイアログボックス内に表示されるテキスト。テキストには HTML の書式設定を含めることができます。 | [表 : 27. パラメーター] {#r_ATSP-setStatusError_S_S__table_mfq_q14_15} {#r_ATSP-setStatusError_S_S__table_nfq_q14_15__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 28. 返される内容] {#r_ATSP-setStatusError_S_S__table_nfq_q14_15} ## AbstractTimelineSchedulePage - setStatusPrompt(文字列 strTitle, 文字列 strOkFunction, 文字列 strCancelFunction, 文字列 strCloseFunction) {#ariaid-title16} GlideTimeline イベント処理のフェーズ 2 中に確認ダイアログボックスに表示する、指定されたタイトルとメッセージを使用して、現在のイベント要求をプロンプトエラーステータスに設定します。 確認ボックスには \[ OK \] ボタンと \[キャンセル \] ボタンが表示され、それぞれがパラメーター引数で指定された関数を呼び出す新しいイベントを生成します。OK、キャンセル、およびクローズのカスタム定義関数は、現在のイベントと同じパラメーター引数を受け取ります。 確認ボックスには \[ OK \] ボタンと \[キャンセル \] ボタンが表示され、それぞれがパラメーター引数で指定された関数を呼び出す新しいイベントを生成します。 注: OK、キャンセル、およびクローズのカスタム定義関数は、現在のイベントと同じパラメーター引数を受け取ります。 {#r_ATSP-setStatusPrompt_S_S_S_S__table_t3f_tc4_15__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | strTitle | 文字列 | ダイアログボックスに表示するテキスト。テキストには HTML の書式設定を含めることができます。 | | strOkFunction | 文字列 | ユーザーが \[OK \] ボタンをクリックした場合に現在のスクリプトインクルードクラスを呼び出す関数。 | | strCancelFunction | 文字列 | ユーザーが \[キャンセル \] ボタンをクリックした場合に現在のスクリプトインクルードクラスを呼び出す関数。 | | strCloseFunction | 文字列 | ユーザーが \[閉じる\] ボタンをクリックした場合に現在のスクリプトインクルードクラスを呼び出す関数。 | [表 : 29. パラメーター] {#r_ATSP-setStatusPrompt_S_S_S_S__table_t3f_tc4_15} {#r_ATSP-setStatusPrompt_S_S_S_S__table_u3f_tc4_15__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 30. 返される内容] {#r_ATSP-setStatusPrompt_S_S_S_S__table_u3f_tc4_15} 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) {#ariaid-title17} GlideTimeline イベント処理のフェーズ 2 で表示するタイトルとメッセージを指定して、現在のイベント要求を成功ステータスに設定します。 {#r_ATSP-setStatusSuccess_S_S__table_ofq_q14_15__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | strTitle | 文字列 | ダイアログボックスのタイトルに表示されるテキスト。 | | strメッセージ | 文字列 | ダイアログボックス内に表示されるテキスト。テキストには HTML の書式設定を含めることができます。 | [表 : 31. パラメーター] {#r_ATSP-setStatusSuccess_S_S__table_ofq_q14_15} {#r_ATSP-setStatusSuccess_S_S__table_pfq_q14_15__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 32. 返される内容] {#r_ATSP-setStatusSuccess_S_S__table_pfq_q14_15}