---
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) 所要時間：4分

フロー API から特定のメッセージを受信するまでフローを一時停止します。フローの実行を再開する文字列メッセージを指定します。またオプションで、特定の時間が経過してもメッセージが受信されない場合にフローを再開するタイムアウト値を指定します。

## ロールと可用性 {#wait-for-message-action__section_wmr_fkc_mcc}

ワークフロースタジオ ServiceNow コアアクションとして利用可能です。flow_designer または admin ロールを持つユーザーは、アクションをフローに追加し、構成の詳細を定義できます。

## 入力 {#wait-for-message-action__section-inputs}

アクションに必要な各入力の値を指定します。動的な値を追加するには、\[データ\] パネルからピルをドラッグするか、ピルピッカーから選択します。{#wait-for-message-action__inputs-description}

メッセージ
:   データタイプ：String

    フローが sendMessage() API からの受信を待機しているテキスト文字列。アクションでこのメッセージを使用してフローの実行を再開します。sendMessage() API の詳細については、「[FlowAPI - sendMessage(String contextSysID, String message, String payload)](https://www.servicenow.com/docs/access?context=ScriptableFlowAPI&version=yokohama&pubname=yokohama-api-reference&section=FlowAPI-sendMessage_S_S_S&ft:locale=en-US)」を参照してください。

タイムアウト有効化
:   データタイプ：True/False  
    フローが続行する前にアクションの完了を待機する時間を制限するオプション。  
    注:  
    \[タイムアウトを有効化\] オプションを使用して、フローが無限に待機しないようにします。メッセージが受信されない場合、システムが \[メッセージを待機\] アクションをスキップしてフロー内の次のアイテムに進むことができるタイミングを、タイムアウト値で指定します。タイムアウトを有効にするには、 \[期間\] の値を設定する必要があります。

期間
:   データタイプ：Duration

    \[タイムアウト有効化\] オプションが選択されている場合にフローが続行する前に待機する時間。待機時間を時、分、秒単位で入力します。このフィールドを空白のままにすると、フローは待機しません。

## 出力 {#wait-for-message-action__section-outputs}

これらの出力は \[データ\] パネルに表示されます。フローの他の場所で入力として使用できます。{#wait-for-message-action__outputs-description}  

ペイロード
:   データタイプ：String

    sendMessage() API によって返されるテキスト文字列。親フローは、ペイロード値を他のアクションまたはフローロジックの入力として使用できます。

状況
:   データタイプ：Choice  
    アクションの完了ステータス (数値)

    * 0 (成功)
    * 1 (エラー)
    {#wait-for-message-action__ul_x5y_hjs_qlb}

## 一般的なガイドライン {#wait-for-message-action__section_jkh_zbd_mcc}

メッセージを待機するフローを作成するときは、次の一般的なガイドラインに従います。

このアクションを使用して、ワークフローイベント待ちアクティビティを変換する
:   \[WF イベント待ち\] アクティビティを使用するクラシックワークフローを、\[メッセージを待機\] アクションを使用するフローに変換します。イベント名は、フローを再開するメッセージテキストとして使用できます。

sendMessage() メソッドを使用してメッセージを作成する
: sendMessage() メソッドを使用して、待機中のフローのメッセージを作成します。フローでメッセージを生成して実行を再開する場合は、メッセージを生成するスクリプトステップを使用してカスタムアクションを作成します。または、メッセージを生成するイベントなど、フローの外部で実行されるスクリプトロジックを作成します。sendMessage() API の詳細については、「[FlowAPI - sendMessage(String contextSysID, String message, String payload)](https://www.servicenow.com/docs/access?context=ScriptableFlowAPI&version=yokohama&pubname=yokohama-api-reference&section=FlowAPI-sendMessage_S_S_S&ft:locale=en-US)」を参照してください。  

## Go back to フローロジックを実行するメッセージを待機する {#wait-for-message-action__example_z1k_rkr_c2c}

このフローの例では、承認ステータスによって \[メッセージを待機\] アクションを実行するかどうかが決定されます。承認ステータスがスキップまたは却下された場合、フローは sendMessage() API からのメッセージを待ってから続行されます。このロジックを使用して、却下された承認要求を修正し、承認のために再送信できます。

この例では、Fred Luddy が承認を却下し、詳細情報を要求しています。フローを再開するには、誰かが Fred のコメントに対応し、sendMessage() API を実行して適切なメッセージ「`Resume Flow`」を送信する必要があります。

変更要求を修正した後、誰かが sendMessage() API を実行して「`Resume Flow`」というメッセージを送信し、また「`Resubmitted for approval`」のペイロード値をフローに送信しました。sendMessage() API の詳細については、「[FlowAPI - sendMessage(String contextSysID, String message, String payload)](https://www.servicenow.com/docs/access?context=ScriptableFlowAPI&version=yokohama&pubname=yokohama-api-reference&section=FlowAPI-sendMessage_S_S_S&ft:locale=en-US)」を参照してください。

API メッセージ値が \[メッセージを待機\] アクションの条件と一致したため、フローの実行が再開されました。この場合、フローは Go back to フローロジックブロックを使用して \[承認を求める\] アクションを再実行しました。

こちらは、変更要求のアクティビティログです。ペイロード値 `Resubmitted for approval` が \[追加コメント\] フィールドに追加されました。