--- 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年05月15日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：13分 現在のステータス、実行されたアイテム、生成された値など、設計環境からアクションまたはフローに関するランタイム情報を直接表示します。埋め込まれた Now Platform エディターまたは新しいタブから関連レコードを開きます。 フローをテストするたびに、フロー実行の詳細として生成された構成値とランタイム値に関する情報が生成されます。フロー実行の詳細は、ワークフロースタジオ の \[操作\] タブから表示できます。関連する実行の詳細ページを開くには、フロー実行を選択します。 図 : 1. 今日の実行に関するフロー実行の詳細の例 それぞれの実行の詳細ページには、フローに関するランタイム情報が表示されます。 * フローの名前 * フローデータをリフレッシュ * フロー状態 * 関連レコードのオプション * フロー統計情報 {#flow-execution-details__ul_qxc_l1c_tbb} 図 : 2. 実行の詳細の例 ## レポートレベル {#flow-execution-details__section_iyg_vhq_wsb} レポートレベルは、通常の操作中にフロー、サブフロー、またはアクションが生成する実行の詳細を決定します。デフォルトでは、ワークフロースタジオ は通常の操作中に実行の詳細を生成しません。ワークフロースタジオ は、個々のフロー、サブフロー、またはアクションをテストするときは、フロー実行の詳細を生成します。インスタンスがより多くの実行の詳細を生成して保存すると、レポートによって、インスタンスに対するより大きなパフォーマンス上の影響が生じます。 各レポートレベルでは、さらにフロー実行の詳細が段階的に生成されます。 {#flow-execution-details__flow-reporting-level-off}オフ{#flow-execution-details__flow-reporting-off-dt} : フロー実行の詳細は生成されません。テストの実行時にのみ、実行の詳細が生成されます。 注: アクションまたはフローをテストすると、トレースレベルで実行の詳細が生成されます。{#flow-execution-details__flow-reporting-off-dd} {#flow-execution-details__flow-reporting-off-dd} {#flow-execution-details__flow-reporting-level-basic}ベーシック：ランタイム状況と期間のみ{#flow-execution-details__flow-reporting-basic-dt} : フロー、サブフロー、およびアクションが実行されるたびに、ランタイム実行の詳細が生成されます。これらの基本的なアイテムについて、ランタイムステータスと期間を確認できます。また、フロートリガー、サブフロー入力、サブフロー出力について、構成とランタイム値の確認もできます。{#flow-execution-details__flow-reporting-basic-dd} {#flow-execution-details__flow-reporting-basic-dd} {#flow-execution-details__flow-reporting-level-full}完全：アクションの構成とランタイム値 (デバッグのみ){#flow-execution-details__flow-reporting-full-dt} : フロー、サブフロー、アクションが実行されるたびに、構成とランタイム実行の詳細が生成されます。すべてのアイテムについて、ランタイムステータス、期間、入力値、および出力値を確認できます。カスタムアクションの場合は、ステップのランタイムステータス、期間、入力値、および出力値を確認できます。また、フロートリガー、サブフロー、アクション、およびカスタムアクションの一部になっているステップについて、構成値の確認もできます。 重要: fd_read_operations_all ロールを持つユーザーのみが、フロー実行の詳細でレコード値などの構成およびランタイム情報を表示できます。このロールを持たないユーザーには、ステータスと期間に関する基本的な詳細のみが表示されます。{#flow-execution-details__flow-reporting-full-dd} {#flow-execution-details__flow-reporting-full-dd} {#flow-execution-details__flow-reporting-level-trace}トレース：すべての値 (テストとサポートのみ){#flow-execution-details__flow-reporting-trace-dt} : フロー、サブフロー、アクション、およびステップが実行されるたびに、構成とランタイム実行の詳細が生成されます。すべてのアイテムについて、ランタイムステータス、期間、入力値、および出力値を確認できます。また、フロートリガー、サブフロー、アクション、およびステップについて、構成値の確認もできます。 重要: fd_read_operations_all ロールを持つユーザーのみが、フロー実行の詳細でレコード値などの構成およびランタイム情報を表示できます。このロールを持たないユーザーには、ステータスと期間に関する基本的な詳細のみが表示されます。アクションまたはフローをテストすると、トレースレベルで実行の詳細が生成されます。{#flow-execution-details__flow-reporting-trace-dd} {#flow-execution-details__flow-reporting-trace-dd} レポートがオフになっている場合にフローが実行されると、レポートレベルが後で変更されても、フローの過去の実行の詳細は使用できません。レポートがオンの場合にフローが実行されると、レポートレベルが変更されても、フローの実行の詳細は使用できます。レポートレベルはコンテキストおよびログレコードには影響しません。 フローが実行されるたびに実行の詳細の生成に使用されるデフォルトのレポートレベルを設定できます。詳細については、「[フローのレポートの有効化](https://servicenow-prod.fluidtopics.net/E7NBmM38Yn8IXdVbQKBiuQ#enable-flow-reporting "実行の詳細の生成を、実行されたすべてのフローとアクションに対して行うか、個々のフローとアクションに対してのみ行うか、またはフローまたはアクションのテスト時にのみ行うかを選択します。実行の詳細に含まれる詳細のレベルを指定します。")」を参照してください。 ## フローデータをリフレッシュ {#flow-execution-details__section_v13_cjf_q5b} 必要に応じてフローのランタイムデータを更新します。フロー設定を、テストの実行時にフローデータを自動的に更新するように設定します。「[フローのユーザー設定](https://servicenow-prod.fluidtopics.net/ZnWov0uGoMaMo5S3Mh9UYQ "ワークフロースタジオで利用可能なオプションを変更するには、フローのユーザー設定を有効または無効にします。")」を参照してください。 ## フロー状態 {#flow-execution-details__section_xpk_4bc_tbb} すべての有効なフローは次のいずれかの状況になります。 完了 : フローはすべてのアクションを正常に実行しました。フロー統計情報には、アクションごとの構成とランタイムの詳細が表示されます。 キャンセル : フローの実行時間がフローのタイムアウト値を超えたために、フローが停止したか、手動でフローがキャンセルされました。 待機中 : 続行する前に条件が満たされるのを待っているアクションで、フローが一時停止しました。フロー統計情報には、完了したアクションおよび条件が満たされるのを待機しているアクションの構成とランタイムの詳細が表示されます。待機状態でのフローでは、ヘッダーに \[フローのキャンセル\] UI アクションが表示されます。 一時停止 : 優先度の高いフローの実行または正常なノードのシャットダウンを可能にするために、フローが一時停止されました。フロー統計情報には、完了したアクションの構成とランタイムの詳細が表示されます。 中断と推定 : フローが 15 分以上実行されていて、現在のノードに有効なトランザクション ID がなくなりました。または、フローが別のノードで 8 時間を超えて実行されています。トランザクションの終了やノードの再起動などの予期しない中断が原因で、フローが停止した可能性があります。 エラー : フローはエラーで停止しました。フロー統計情報には、完了したアクションの構成とランタイムの詳細、およびエラーを生成したアクションの構成の詳細が表示されます。エラー状態のフローでは、ヘッダーに \[エラーに移動\] UI アクションが表示されます。 注: アクションによってエラーが発生すると、フローはその時点で実行を停止し、エラーステータスになります。 ## 関連レコードのオプション {#flow-execution-details__section_lgg_vdc_tbb} \[実行の詳細\] ページから、現在のフローに関連するレコードにアクセスできます。 フローを開く : 構成を変更してフローの新しいインスタンスを公開するには、このオプションを使用します。フローの構成を変更しても、現在有効なフローは変更されません。 コンテキスト レコードを開く : 標準のフォーム ビューから、フロー状態、実行時間、および関連するログ エントリーを表示するには、このオプションを使用します。このオプションでは、新しいタブにコンテキスト レコードが開きます。 フロー ログを開く : 各アクションに関する詳細なログ情報を表示するには、このリンクを使用します。このリンクをクリックすると、新しいタブにログ エントリーの一覧が表示されます。 現在のレコードを開く : レコードベースのトリガーを持つフローの場合は、このリンクを使用して、ポップアップ ウィンドウにトリガーとなるレコードを表示します。 アクションを開く : このリンクを使用して、構成の変更を行い、アクションの新しいインスタンスを公開します。アクションの構成を変更しても、現在有効なフローは変更されません。ServiceNow が提供するコアアクションでは、このリンクは利用できません。 ## フロー統計情報 {#flow-execution-details__section_rkp_p3c_tbb} フロー統計情報を使用して、各フローコンポーネントの構成の詳細とランタイム値を確認します。トリガーまたはアクションを選択すると、行が展開され、その行に関する構成とランタイムの詳細が表示されます。 図 : 3. フロー統計情報の例 次のタイプの実行の詳細が利用できます。 コール ソース : フロー、サブフロー、またはアクションを開始したコールソースを表示します。 実行方法 : フローの \[実行方法\] が、システムなのか、フローをトリガーしたユーザーなのかを識別します。 ロールを使用して実行します : フローをトリガーしたユーザーに付与されたロールを識別します。 統合メタデータ : 使用している接続と資格情報、使用している MID サーバー、ターゲットホスト、ペイロードサイズなどのトランザクションデータを表示します。データ連携メタデータは統合ステップでのみ表示されます。また、統合ハブ のサブスクリプションが別途必要です。詳細については、「[統合ステップ](https://www.servicenow.com/docs/access?context=integration-steps&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US)」を参照してください。 構成詳細 : 入力変数のリストを表示して、アクションの構成エラーを特定します。各変数には、名前、データタイプ、構成設定、およびランタイム値を表示する独自の行があります。構成設定では、動的な値がピルとして表示されます。ランタイム値には、生成されたレコードがリンクとして表示されます。 注: 変換機能を持つ変数では、ランタイム値が 1 つだけ表示されます。これはすべての変換の結果です。 出力データ : 出力変数のリストを表示して、アクションの構成エラーを特定します。 ログ : ログ エントリーを使用して、処理やパフォーマンスの潜在的な問題を特定します。各ログ エントリーには、作成日、ログ レベル、およびログ メッセージを表示する独自の行があります。アクションによってログが生成されない場合、統計情報には「ログがありません」という文字列が表示されます。 注: ログは UTC 形式で表示されます。これは、インスタンスが複数のノード間でログデータを共有できるように、ログを文字列として保存する必要があるためです。各ノードは異なるタイムゾーンに存在する可能性があるため、正しい時間の値を保持するための一般的な形式として UTC 形式が使用されます。 ステップ : ステップのリストを使用して、アクションの構成エラーを特定します。各ステップには、変数名、データタイプ、構成設定、およびランタイム値を表示する独自の行があります。コアアクションについては、構成を変更できないため、ステップが表示されません。 com.snc.process_flow.reporting.serialized.val_size_limit システムプロパティを変更して、フロー実行の詳細のステップ構成でランタイム値を切り捨てます。詳細については、「[ワークフロースタジオ フローシステムプロパティ](https://servicenow-prod.fluidtopics.net/5qzZ4Jrkm0wnPZQPh4hfUQ "フローの処理方法を設定します。")」を参照してください。 開始時間 : アクションが開始された現地時間を表示します。 実行期間 : 実行時間を使用して、処理やパフォーマンスの潜在的な問題を特定します。実行時間はミリ秒単位で測定されます。Washington DC リリースの時点では、実行時間にはアイテム実行の合計時間が一覧表示されます。合計時間には、以下の項目が含まれます。 * イベントキュー内の時間 * ECC キュー内の時間 * イベントの処理時間 * フローエンジンでの実行時間 * MID サーバーとの通信時間 {#flow-execution-details__ul_vzh_mt3_ldc} 再試行情報 : \[再試行情報\] セクションを使用して、再試行ポリシーの詳細を確認します。詳細には、再試行戦略のタイプ、経過時間、次のスケジュールされた再試行要求が含まれます。\[再試行情報\] セクションは、ステップで再試行ポリシーが有効になっている場合にのみ表示されます。詳細については、「[再試行ポリシー](https://servicenow-prod.fluidtopics.net/28vchUEtiyDd1gZWVGdXaw#retry-policy "ステップでネットワーク障害や要求レート制限などの断続的な問題が発生した際は、失敗した要求を自動で再試行します。ステップを手動で再トリガーする必要がないように、再試行ポリシーを設定します。")」を参照してください。 ## コール ソース {#flow-execution-details__section_lpq_wdt_ycb} コールソースには、フロー、サブフロー、またはアクションの開始元が一覧表示されます。 {#flow-execution-details__table_cjr_h2t_ycb__entry__2} | ソース | 説明 | |-|-| | ワークフロースタジオ のテスト | 誰かがワークフロースタジオのインターフェイスから \[テスト\] オプションを選択したためにフローが開始されました。フローのトリガー条件は無視されました。 | | CRUD トリガー | レコードベースのトリガー条件が満たされたときにフローが開始されました。 | | 日付トリガー | スケジュールベースのトリガー条件が満たされたときにフローが開始されました。 | | Metric トリガー | メトリックベースが次の条件をトリガーしたときにフローが開始されました [メトリックベース](https://www.servicenow.com/docs/access?context=metricbase&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US) 満たされました。 | | サービスカタログ トリガー | サービスカタログアイテムが要求されたときにフローが開始されました。 | | スクリプト | ビジネスルールなど、スクリプト内のメソッド呼び出しからフローが開始されました。 | | バックグラウンド スクリプト | \[スクリプト - バックグラウンド\] モジュール内のメソッド呼び出しからフローが開始されました。 | [ ] {#flow-execution-details__table_cjr_h2t_ycb} ## 埋め込みテキスト ビューアー {#flow-execution-details__section_t44_dms_tbb} ワークフロースタジオ では、埋め込みテキストビューアーを使用して、メール出力、XML ペイロード、スクリプトステップなど、大規模なテキストベースの構成およびランタイムの出力レコードが表示されます。埋め込みテキスト ビューアーでは、テキストを HTML、プレーン テキスト、または色分けされた JavaScript として書式設定できます。スクリプト ステップについては、テキスト ビューアーではエラーを含むコード行が強調表示されます。 図 : 4. スクリプト ステップのテキスト表示の例 ## フロー ロジックの各アイテムの結果の表示 {#flow-execution-details__section_q2n_4j3_vbb} ワークフロースタジオ には、フローロジックによって処理された各アイテムの構成とランタイムの結果を表示するためのセレクターコントロールが表示されます。レコード番号を選択すると、その構成と実行時の詳細が表示されます。 図 : 5. フロー ロジックの各アイテムのフロー統計情報のサンプル ## サブフロー実行の詳細 {#flow-execution-details__section_wvh_ncp_rnb} プロセスアナリストは、複数の場所からサブフロー実行の詳細を表示できます。 親フロー : 親フローは、インライン要素として呼び出される各サブフローのフロー実行の詳細をリストします。サブフローのステップを展開して、サブフロー実行の詳細を表示します。 サブフロー : サブフローが実行されるたびにフロー実行の詳細が生成されます。フロー実行のリストからサブフロー実行の詳細を直接表示します。 ## ユーザーロールのサポート {#flow-execution-details__section_jnp_vm3_ldc} ユーザーロールを付与することで、フロー実行の詳細へのアクセスを制御できます。ワークフロースタジオ のユーザーロールの詳細については、「[ワークフロースタジオ フローへのユーザーアクセス](https://servicenow-prod.fluidtopics.net/~toXwRPl1RjHom~X8pPz8w "アドミニストレーターは、委託開発権限をアサインするかユーザーロールを直接アサインして、ユーザーにワークフロースタジオフローに対するアクセス権を付与できます。また、アドミニストレーターは、ユーザーのロールに基づいて、ユーザーがアクセスできる機能とコンテンツを指定することもできます。アプリケーション開発者は、フロー、サブフロー、アクションの API を介して ワークフロースタジオ の機能にアクセスできます。")」を参照してください。 {#flow-execution-details__table_utq_v2r_nnb__entry__3} | ロールタイトル \[名前\] | 説明 | ロールを含む | |-|-|-| | flow_operator | ユーザーがフロー実行の詳細、ダッシュボード、およびログを表示できるようにします。アドミニストレーターは、実行結果を表示する必要はあるじぇが、実行結果の作成、変更、テストは行わないユーザーに対して、このロールを付与できます。 | なし | | fd_read_operation | ユーザーが基本フローおよびアクションの実行の詳細を表示できるようにします。レポートが有効になっている場合、このロールを持つユーザーは、ランタイムの状況や期間などの基本的な実行の詳細のみを表示できます。レポートレベルで追加の詳細が生成された場合、このロールを持つユーザーはそれらを表示できません。アドミニストレーターは、基本的な実行の結果を表示する必要はあるがフローおよびアクションの作成、変更、テストは行わないユーザーに対して、このロールを付与できます。 注: 読み取り専用ロールは、書き込みアクセスを提供するロールと互換性がありません。同じユーザーに読み取り専用アクセスロールと書き込みアクセスロールの両方を付与することは避けてください。 | なし | | fd_read_operations_all | ユーザーが生成されたすべてのフローおよびアクションの実行の詳細を表示できるようにします。レポートが有効になっている場合、このロールを持つユーザーは利用可能なすべての実行の詳細を表示できます。ユーザーは、レポートレベルのシステムプロパティで定義されている詳細のみを表示できます。アドミニストレーターは、すべてのフローの結果を表示する必要はあるがフローおよびアクションの作成、変更、テストは行わないユーザーに対して、このロールを付与できます。 注: 読み取り専用ロールは、書き込みアクセスを提供するロールと互換性がありません。同じユーザーに読み取り専用アクセスロールと書き込みアクセスロールの両方を付与することは避けてください。 | fd_read_operation | [表 : 1. ワークフロースタジオ の実行の詳細のロール] {#flow-execution-details__table_utq_v2r_nnb} ## ロールサポートを使用して実行 {#flow-execution-details__section_npm_5jm_3fc} フローが 1 つ以上の特権ロールで実行されている場合、フロー実行の詳細を表示するには、ユーザーにこれらの特権ロールも必要です。たとえば、フローをシステムとして実行する場合、ユーザーがそのフロー実行の詳細を表示するには、admin ロールが必要です。さらに、フィールド暗号化にアクセスできるロールでフローを実行する場合、フロー実行の詳細を表示するには、ユーザーにそのロールも必要です。フィールド暗号化とロールの詳細については、「 [Field Encryption](https://www.servicenow.com/docs/access?context=field-encryption&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)」を参照してください。