ワークフロー実行および改訂履歴

ワークフロー実行と改訂履歴について(&A)

ワークフローの設定後、ワークフローのステータスをチェックし、それらのワークフローに加えられた変更を評価することが必要になる場合があります。ワークフローの実行履歴セクションと改訂履歴セクションでは、ワークフローの過去の実行、それらの実行に関する詳細、およびワークフローに対して行われた変更を確認することができます。このセクションは、ワークフローが失敗した理由を評価する場合に特に役立ちます。レポートには、ワークフローが失敗した理由や変更が行われたかどうかに関する情報が含まれており、問題の特定と修正に役立ちます。

ワークフローをクリックし、関心のあるセクションに移動することで、特定のワークフローの実行履歴および改訂履歴を表示することができます。

プロジェクトのワークフロータブから実行履歴に直接移動して、プロジェクト内のすべてのワークフローの実行履歴を表示することもできます。

実行履歴

実行履歴ページでは、トリガーしたワークフロー実行の追加情報を見ることができます。このページでは、ワークフローをモニタし、問題を診断し、正常に完了したワークフローと失敗したワークフローの概要を把握することができます。

ワークフローの実行履歴を表示する際、ページ上部のドロップダウンメニューを使用することで、2つの異なるレポートビューを切り替えることができます：

1. タスクが実行され、正常に開始されました：正常にトリガーされたワークフローを表示します。
2. トリガー後に開始できませんでした：トリガーに失敗したワークフローを表示します。

ワークフローがトリガーされるたびに、ワークフロー実行履歴ページに新しいエ ントリとして追加されます。このページには、ワークフロー実行に関する以下の情報が表示されるテーブルが含まれています。

• 開始日付: ワークフローの実行が開始された日時。
• ワークフロー名: ワークフローの名前です。
  ヒント：「削除されたワークフロー」という名前のワークフローのステータスが表示される場合は、添付されたワークフローが削除されている可能性があります。これを行う場合は注意してください。レコードはまだ存在しますが、ワークフロー自体は復元できません。
  ヒント：特定のワークフローの実行履歴にアクセスする場合、この列を除外します。
• オーナー: ワークフローを作成したユーザーのユーザー名。
• ステータス：ワークフローのステータス。

各ワークフロー実行に関する詳細情報を表示することができます。ワークフロー実行をクリックして展開し、ワークフローの各コンポーネントに関する情報を確認します。

ワークフローを開始するイベントは “トリガー “とラベル付けされ、ワークフロー内の異なるタスクは、最初のタスクは “T-ID 1″、2番目のタスクは “T-ID 2 “とラベル付けされる。タスクの順序とラベルの詳細については、ワークフロー内のタスクの順序を参照してください。

ワークフローの各コンポーネントをクリックすると、その詳細を見ることができます。利用可能な情報やアクションは、ワークフローコンポーネントのタイプや、 ワークフローが成功したか否かによって異なります。詳細は以下のセクションを参照のこと：

• 正常にトリガーされたワークフロー実行の表示：正常にトリガーされたワークフロー。タスクは成功することも失敗することもある。
• 失敗したワークフロー実行の表示： イベントトリガーの問題または誤ったワークフロー条件により、正常にトリガーされなかったワークフロー。タスクがトリガーされなかったため、実行されなかった。

実行履歴の検索

実行履歴には、関心のあるワークフローを簡単に見つけることができる事前設定されたフィルタが用意されています。検索バーを使用して、タスク出力値を検索することもできます。

1. オーナーシップと共有ドロップダウンを使用して、ユーザが所有するワークフロー、自分と共有されているワークフロー、またはユーザがアクセス権を持つすべてのワークフロー別にフィルタリングします。
   ヒント：このフィルタは、アンケートプロジェクトで実行履歴を表示している場合は除外されます。
2. ワークフロー名ドロップダウンを使用して、ワークフロー名でフィルタリングします。
   ヒント：特定のワークフローの実行履歴を表示する場合、このフィルターは除外されます。
3. 開始者ドロップダウンを使用して、ワークフローを開始する内容 (スケジュールまたは特定のワークフローイベント) でフィルタリングします。
4. [含まれるタスク] プルダウンリストを使用して、ワークフローから生じるタスク別にフィルタリングします。
5. タスク出力データ検索バーを使用して、ワークフロー内のタスク出力値を検索します。検索バーに特定のキーワードまたは値を入力すると、ワークフロー実行の一覧には、そのキーワードまたは値を含む実行のみが表示されます。
   ヒント：このフィルターは、［含まれるタスク］ドロップダウンから特定のタスクを選択した場合にのみ使用できます。
   注意: 現在、このフィルタはすべてのタスクタイプで使用できるわけではありません。
6. [タスクの状況] プルダウンリストを使用して、ワークフロータスクの状況別にフィルタリングします。
7. [ワークフローの開始日] フィールドと [終了日] フィールドを使用して、ワークフローがトリガされた日時でフィルタリングします。カレンダアイコンをクリックしてカレンダを表示し、日付を選択します。
   
8. 開始者 (ID) ドロップダウンを使用して、特定のワークフローのトリガ ID でフィルタリングします。トリガ ID の取得の詳細については、以下のトリガ ID の検索セクションを参照してください。

ヒント：結果の数は、ページ下部の［ページあたりのレコード数］オプションを使用して調整できます。

正常にトリガーされたワークフロー実行の表示

正常に開始されたタスクの実行ページには、正常にトリガーされたワークフローが表示されます。これらのワークフローには、成功したタスクも失敗したタスクもある。これらのワークフローを表示する際、タスクのいずれかをクリックすると、タスクの詳細情報を含む並列パネルを開くことができる：

• ステータス：タスクのステータス。
• ワークフロー実行 ID: ワークフローが実行されるたびに、ワークフローの各側面に一意の実行 ID が割り当てられます。このIDを使用してワークフローをフィルタリングしたり、ワークフローが失敗した理由のトラブルシューティングについてサポートが必要な場合はQualtricsサポートに提供したりできます。
• スケジュール対象：ワークフローの実行予定日時。これはスケジュールされたワークフローにのみ表示されます。
• 開始時刻: ワークフローの実行が開始された日付と時刻。
• 終了時刻: ワークフローの実行が終了した日時。
• 期間: ワークフローの実行にかかった合計時間。
• 設定：ワークフロー実行時の再実行と失敗の設定。
• ファイル: タスクでファイルが処理された場合は、このセクションでファイルをダウンロードすることができます。詳細については、データファイルのダウンロードを参照してください。
  ヒント：選択したタスクがファイルを処理しない場合、このフィールドは非表示になります。

上記の情報
に加えて、JSON 表示をクリックしてタスクの JSON ペイロードを表示することができます。
JSON ペイロード

は、ワークフロー (特に ETL ワークフロー) のトラブルシューティングに役立ちます。入力タブにはタスクが受け取った情報とデータが表示され、出力タブにはタスクの結果が表示される。

視聴条件

ワークフローの条件がどのように評価されたかを見ることもできます。これには、ワークフ ロートリガー後の条件や、個々のタスク間の条件が含まれます。条件をクリックすると、その条件の詳細が表示されます。

各条件がこのウィンドウに表示される。その条件が何であったか、その条件を評価するために使われた値、そしてその条件がどのように評価されたかを見ることができる。

条件は以下のいずれかとして評価される：

• 真と評価された：条件が満たされ、真と評価された。
• 偽と評価された：条件が満たされず、偽と評価された。
• 評価されなかった：any “ロジックで区切られた条件の場合）ロジックがワークフロー内の別の条件によって既に渡されたため、条件は評価されませんでした。

失敗したワークフローの表示

Failed to start after triggered］ページには、トリガーに失敗したワークフローが表示されます。これには、イベントは正常にトリガーされたものの、条件が満たされずワークフローが失敗したワークフローも含まれます。

失敗したトリガー条件

ワークフローの条件ロジックがどのように評価されたかを見ることができます。実行履歴ページには、真の条件も偽の条件も表示される。

トリガーは成功したが、トリガーに続く条件が満たされていないために実行されなかったワークフローについては、ワークフローの条件をクリックして、各条件を評価するために使用された値を正確に確認することができます。

条件ロジックと、条件の評価に使用される実際の値を表示するウィンドウが開きます：

1. 成功裏に満たされた条件には評価者trueのラベルが付けられる。
   例上のスクリーンショットでは、”Medium “という答えが選択されていないので、条件は真です。
2. 満たされなかった条件には評価者falseのラベルが付けられる。
   例上のスクリーンショットでは、”Bad “という答えが選択されていないので、条件は偽です。

ワークフローステータス

ワークフロータスクには、ワークフローの進捗を確認できるさまざまなステータスがあります。

• 待機中: タスクは次に実行されるようにスケジュールされています。
• 進行中: タスクは現在実行中です。
  例: ワークフローで順次実行される 2 つのタスクがあります。実行前に、最初のタスクが “待機中” に設定されます。実行中は、最初のタスクのステータスは “処理中” になり、2 番目のタスクは表示されません。最初のタスクが完了すると、2 番目のタスクは “Queued” と表示されます。
• 成功: タスクが実行されました。メールタスクの場合、これはクアルトリクスサーバーから退出したことを意味します。
• 失敗: タスクはトリガされませんでした。通常、これはタスクの設定時のエラーによって発生します。たとえば、電子メールタスクに無効な電子メールを入力した場合などです。
  ヒント：ETL 以外のワークフローには 60 秒のタイムアウトがあります。つまり、実行に 60 秒以上かかるとワークフローが失敗します。
  ヒント：ワークフロー内の1つ以上のタスクが失敗した場合にワークフローを再試行できます。詳細については、「ワークフローの再試行」セクションを参照してください。
• 自動再試行: ワークフロー内の 1 つまたは複数のタスクが失敗し、再試行中です。詳細については、「ワークフローとタスクの失敗」を参照してください。
• 開始遅延:開始設定の適用が遅れたため、ワークフローは実行されませんでした。ワークフローがトリガされ、期間が終了するまでキューに保持されるインスタンスが 1 つ以上あります。
• 未実行：ワークフローはトリガーされたが、ワークフローの条件を満たさなかったため、実行されなかった。

改訂履歴

改訂
履歴では、アクセス権のあるワークフローに対して行われた変更を表示することができます。つまり、ワークフローがいつ正確に無効化/有効化されたか、条件変更がいつ行われたか、およびワークフローを編集したユーザを表示することができます。

改訂履歴は、特定のワークフローとプロジェクト内のすべてのワークフローの両方で使用することができます。以下に、1つのアンケートのリビジョン履歴のスクリーンショットを表示し、ワークフローのすべての編集を順番に表示しています。

改訂履歴には、ワークフローに関する以下の情報が含まれています。

• ワークフロー名: 編集されたワークフローの名前。プロジェクト全体の改訂履歴を参照している場合にのみ表示されます。
• ユーザ名: 編集を行ったユーザのユーザ名。
• 変更内容: ワークフローに対して行われた編集の説明。
• 最終更新日: ワークフローが編集された日時。
• 詳細表示: 変更前および変更後のワークフローの JSON ペイロードを表示します。

改訂履歴の検索

実行履歴には、ワークフローに対する特定の変更を簡単に見つけることができる事前設定されたフィルタが用意されています。

• ユーザ名ドロップダウンを使用して、変更を行ったユーザでフィルタリングします。
• [変更内容] プルダウンリストを使用して、ワークフローに対して行われた編集の種類でフィルタリングします。
• [最終更新日 (範囲)] フィルタを使用して、編集が行われた日付範囲を選択します。カレンダアイコンをクリックしてカレンダを表示し、日付を選択します。
  

ワークフローの再実行

実行履歴ページから、ワークフローを再実行して再度完了することができます。再実行するワークフローを選択し、［ワークフローを再実行］をクリックします。

失敗したワークフローを再実行する場合、最初の失敗したタスクから開始するか、ワークフローの最初から開始するかを尋ねられます。

ワークフローは、以下のシナリオでは実行できません。

• ワークフローおよびタスク失敗設定では、ワークフローを再試行したり、特定の期間外にワークフローを再試行したりすることはできません。
• 再実行対象として選択されたワークフローは、現在処理中、待機中、またはすでに再実行中です。
• ワークフローは、最初に実行されたときに開始が遅れていました。
• 選択したワークフローを再実行すると、実行できるワークフローの最大制限を超えます。

ワークフローの再試行

ワークフロー内のタスクが失敗し、ワークフロー全体を再試行
する場合は、［再試行］をクリックします。再試行ボタンは、タスクが失敗した場合にのみ表示されます。再試行ボタンをクリックすると、ワークフロー全体が再実行されます。

ワークフローを再試行すると、初期実行とまったく同じ設定でタスクが再実行されます。ワークフローは以下の場合に再試行する必要があります。

• クアルトリクスの内部エラーにより、タスクがタイムアウトしました。
• サードパーティシステムで発生する問題が原因でタスクが失敗します。
  例：SuccessFactors から社員をインポートしようとしていますが、正しい権限で SuccessFactors アカウントを設定していません。SuccessFactors アカウントに社員データを表示する権限がないため、Qualtrics でワークフローを実行すると失敗します。ただし、SuccessFactorsの権限を更新すると、Qualtricsでタスクを再試行でき、タスクは成功します。

設定エラーが原因で失敗したタスクを再試行すると、再試行が再度失敗します。代わりに、設定エラーを修正した後、新しいワークフロー実行を開始する必要があります。

トリガ ID の検索

ワークフローが実行されるたびに、そのワークフローのすべてのタスクコンポーネントに一意のトリガ ID が割り当てられます。このIDを使用して、ワークフローの特定の実行を検索したり、ワークフローが失敗した理由のトラブルシューティングをサポートする必要がある場合は、Qualtricsサポートに提供できます。

1. 目的のワークフローの［実行履歴］セクションに移動します。
2. 特定のタスクをクリックし、のトリガ ID を検索するを実行します。
3. JSON 表示をクリックします。
4. 「uniqueId」のテキスト検索を実行します。Mac では CMD + F、PC では CTRL + F です。Web ブラウザに検索可能なボックスが表示されます。
   
5. uniqueId (トリガ ID とも呼ばれます) の値をコピーします。

トリガ ID を使用して、レポートで特定のワークフロー実行を検索することができます。

データファイルのダウンロード

特定のワークフロータスクでは、処理したデータのファイルをダウンロードすることができます。これは、トラブルシューティングや、Qualtricsと他のサードパーティーのシステム間で渡されるデータを理解するのに役立ちます。データファイルをダウンロード

するには、特定のタスクを表示しているときにファイルセクションのダウンロードボタンをクリックします。データがコンピュータに CSV ファイルとしてダウンロードされ、スプレッドシート編集ソフトウェアを使用して開くことができます。

以下のような一部の ETL タスクのデータファイルをダウンロードすることができます。

• SFTP ファイルからのデータ抽出タスク
• SFTPタスクにデータをロード
• Google ドライブタスクからデータを抽出
• アンケートタスクから回答を抽出
• XMDタスクへの連絡先とトランザクションの追加

FAQ