---
sourceDocument: Yokohama ビルドのワークフロー
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/build-workflows

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama ビルドのワークフロー

ft:clusterId :

    - crworkflow

bundleId :

    - crworkflow

workflow :

    - Creator


---

# タイマーワークフローアクティビティ

# タイマーワークフローアクティビティ {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年01月30日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：6分

\[タイマー\] アクティビティは、指定された期間ワークフローを一時停止します。{#r_Timer__wf-timer-activity-shortdesc}
この期間は、絶対時間値または定義された[スケジュールの作成と使用](https://www.servicenow.com/docs/access?context=c_UseSchedules&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US)に基づく相対値です。\[期間\] を調整して、ワークフローを適切なタイミングで進行できるようにするのが最良の方法です。条件が満たされるまで無期限にワークフローを一時停止するには、「[条件待ち](https://www.servicenow.com/docs/access?context=r_WaitForCondition&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US)」を参照してください。  
注:  
タイマーアクティビティは、システムスケジューラーがワークフローを進行するため、システムユーザーとして実行されます。

## 結果

{#r_Timer__table_b1r_fgd_lq__entry__2}

| 結果 | 説明 |
|-|-|
| 完了 | アクティビティは指定された期間を正常に完了しました。 |
| キャンセル | アクティビティまたはワークフローは、タイマーが指定された期間を完了する前にキャンセルされました。 |
[表 : 1. タイマーアクティビティの結果]

{#r_Timer__table_b1r_fgd_lq}

## 入力変数

アクティビティの初期動作が、入力変数によって決まります。
{#r_Timer__table_dl4_ngd_lq__entry__2}

| フィールド | 説明 |
|-|-|
| タイマー情報 ||
| タイマー基準： | タイマー期間の計算方法。オプションは次のとおりです。 * \[ユーザー指定の期間\]：期間は、日や時間などの \[期間\] フィールドに基づいています。 * \[相対期間\]：期間は、相対期間 (翌営業日の終了など) および \[待機\] フィールドに基づいています。 * \[日付/時刻または期間フィールド\]：期間は、\[フィールド\] 価値および \[待機\] フィールドに基づいています。 * \[スクリプト\]：期間は、秒数を返すスクリプトに基づいています。 {#r_Timer__ul_ebm_sgd_lq} |
| 期間 \[タイマー基準：\] が \[ユーザー指定の期間\] の場合にのみ表示されます。 | ワークフロー内の次のアクティビティに進むまでの特定の日数と時間。 |
| 相対期間 \[タイマー基準：\] が \[相対期間\] の場合にのみ表示されます。 | 次のワークフローアクティビティに進む前に待機する一般的な営業日の日数と長さ。 |
| 待機 \[タイマー基準：\] が \[相対期間\] または \[日付/時刻または期間フィールド\] の場合のみ表示されます。 | \[タイマー基準：\] が \[相対期間\] または \[日付/時刻または期間フィールド\] の場合の追加タイマー調整。オプションは次のとおりです。 * \[全期間\]：計算された期間の変更はありません。 * \[期間の％\]：期間は、(パーセンテージ/100) で秒数を乗算することにより調整されます。 * \[少し前\]：期間は、\[次の前の時間\] の日と時間により短縮されます。 * \[少し後\]：期間は、\[次の後の時間\] の日と時間により延長されます。 {#r_Timer__ul_q3v_chd_lq} |
| パーセンテージ \[タイマー基準：\] が \[相対期間\] または \[日付/時刻または期間フィールド\] の場合のみ表示されます。 | \[タイマー基準：\] が \[相対期間\] または \[日付/時刻または期間フィールド\] の場合の \[待機\] パーセント値。 |
| 次の前の時間 \[タイマー基準：\] が \[相対期間\] または \[日付/時刻または期間フィールド\] で、\[待機\] が \[少し前\] の場合のみ表示されます。 | \[待機\] が \[少し前\] の場合の修飾子の時間値。 |
| 次の後の時間： \[タイマー基準：\] が \[相対期間\] または \[日付/時刻または期間フィールド\] で、\[待機\] が \[少し後\] の場合のみ表示されます。 | \[待機\] が \[少し後\] の場合の修飾子の時間値。 |
| フィールド \[タイマー基準：\] が \[日付/時刻または期間フィールド\] の場合のみ表示されます。 | 次のワークフローアクティビティに移動するまでの経過待ち時間を含む日付/時刻または期間フィールド。 |
| スクリプト \[タイマー基準：\] が \[スクリプト\] の場合にのみ表示されます。 | 「回答」を継続時間用の秒数に設定するスクリプト。 |
| タイマー スケジュール ||
| スケジュール基準： | タイマーが勤務時間をカウントするために使用する基本スケジュール。スケジュールが指定されると、スケジュールで指定された回数のみ期間が考慮されます。たとえば、期間が 2 時間の場合、午前 8 時から午後 5 時のスケジュールでワークフローが午後 4 時に開始されると、翌日の午前 9 時に終了します。オプションは次のとおりです。 * \[このワークフローのスケジュール\]：スケジュールは、ワークフローのコンテキストの日付、時刻、およびオプションの \[タイムゾーン基準：\] 値を使用します。 * \[特定のスケジュール\]：スケジュールは、事前定義された \[スケジュール\] およびオプションの \[タイムゾーン基準：\] 値を使用します。 * \[スケジュール フィールド\]：スケジュールは、テーブルの値およびオプションの \[タイムゾーン基準：\] 値を使用します。 {#r_Timer__ul_wys_qhd_lq} |
| スケジュール \[スケジュール基準：\] が \[特定のスケジュール\] の場合のみ表示されます。 | リストから事前定義された \[スケジュール\]。 |
| スケジュール フィールド \[スケジュール基準：\] が \[スケジュール フィールド\] の場合のみ表示されます。 | テーブルに関連付けられているスケジュールの日付/時刻または期間フィールド。有効なフィールドは、ツリー ダイアログの \[要素を選択\] に青色で表示されます。 |
| タイマー タイムゾーン ||
| タイムゾーン基準： | 期間を計算するためのタイムゾーン。以下のタイムゾーン基準があります。 * \[タイムゾーンなし\]：デフォルト。ワークフローは GMT タイムゾーンを使用します。 * \[特定のタイムゾーン\]：事前定義された \[タイムゾーン\]。 * \[タイムゾーン フィールド\]：フォーム上のフィールドから継続時間を追跡する \[タイムゾーン フィールド\]。 {#r_Timer__ul_hmv_vhd_lq} |
| タイムゾーン \[タイムゾーン基準：\] が \[特定のタイムゾーン\] の場合にのみ表示されます。 | 事前定義済みのタイムゾーン。 |
| タイムゾーン フィールド \[タイムゾーン基準：\] が \[タイムゾーン フィールド\] の場合にのみ表示されます 。 | テーブルに関連付けられているスケジュールの日付/時刻または期間フィールド。有効なフィールドは、ツリー ダイアログの \[要素を選択\] に青色で表示されます。 |
[表 : 2. タイマーアクティビティの入力変数]

{#r_Timer__table_dl4_ngd_lq}

## 状況

アクティビティ状況は、ワークフロー エンジンがアクティビティを処理する方法を指示します。
{#r_Timer__table_qts_d3d_lq__entry__2}

| 状況 | 説明 |
|-|-|
| 実行 | 初期化中、\[タイマー\] アクティビティは短時間この状態にありますますが、その後すぐに \[待機中\] に変わります。 |
| 待機中 | ワークフロー エンジンは、タイマーが指定された期間を完了するまで待機します。その後、エンジンはワークフローを次のアクティビティに移行します。 |
| 完了 | アクティビティの実行が終了しました。アクティビティの結果については結果値を確認してください。 |
| キャンセル | このアクティビティ、またはこのアクティビティを含むワークフローはキャンセルされました。 |
| エラー | JavaScript エラーが発生しました。エラーの詳細についてログを確認してください。 |
[表 : 3. タイマーアクティビティ状況]

{#r_Timer__table_qts_d3d_lq}

## 例

\[タイマー\] アクティビティを使用して、営業日が終了するまでワークフローを一時停止することができます。  
図 : 1. タイマーの例

この例では、スクリプトは <var class="keyword varname">[now]</var> 変数と <var class="keyword varname">[eod]</var> 変数の間の時間を評価します。<var class="keyword varname">[eod]</var> 変数は、24 時間で午後 4 時に定義されます。スクリプトは、<var class="keyword varname">[回答]</var> 変数を秒単位でこれらの変数の差に設定し、メッセージを記録します。  

    // get now and calc end of day (4:00pm)
     
    var now =new Date();
     
    var eod =new Date();
    eod.setHours(16);
    eod.setMinutes(0);
    eod.setSeconds(0);
     
    answer =(eod.getTime()- now.getTime())/1000;
     
    workflow.debug('Timer will fire @: '+ eod +'  '+(answer/60)+' minutes from now');