記事テンプレート

ワークフローからの実行履歴レポートの抽出について

クアルトリクスでは、作成したワークフローごとに実行履歴が残ります。この実行履歴には、ワークフローのトリガーとタスクに関する情報が含まれます。ワークフローから実行履歴レポートを抽出タスクを使用して、選択したワークフローの実行履歴をエクスポートできます。エクスポートされたワークフローの実行履歴は、社内の記録として保存することができます。

ワークフローからの実行履歴抽出タスクの設定

1. ETLワークフローを作成する。
2. データソース（ETL抽出器）を選択します。
   
3. ワークフローから実行履歴レポートを抽出する タスクを選択します。
4. エクスポートに含めるワークフローを選択します：
   
   • X ロケーションのすべてのワークフロー：このオプションは、このワークフローを作成した場所にあるすべてのワークフローをエクスポートします（例えば、スタンドアロンワークフローページでワークフローを作成した場合、”スタンドアロンワークフローの場所にあるワークフローを許可する “と表示されます）。同様に、このワークフローをプロジェクトで作成した場合、このオプションはそのプロジェクトを代わりにリストします）。
   • すべてのプロジェクトとロケーションのすべてのワークフロー：このオプションは、アクセス可能なすべてのワークフローをエクスポートします。
   • 特定のプロジェクト、ロケーション、ワークフローを選択します：このオプションでは、エクスポートするワークフローを選択できます。詳しくは「特定のワークフローをエクスポートする」を参照してください。
5. エクスポートするワークフローの種類を選択します。成功したワークフロー、失敗したワークフロー、またはすべてのワークフローを選択できます。
6. エクスポートのタイミングを選択します：過去 24 時間、7 日間、15 日間、30 日間、またはワークフローが最後に実行されてから（前回のエクスポート以降に実行されたすべての実行が含まれます）。
7. エクスポート時に日付とタイミングをどのようにフォーマットするかを選択します。
8. フィルターの区切り文字を選択します。デリミタは、ファイル内の値を区切る文字である。
9. すべてのデータを引用符で囲むか、選択した区切り文字と一致する文字を含むフィールドのみを囲むかを選択します。このオプションは、フィールドが意図せず複数のフィールドに分割されるのを防ぐためのものである。
10. 保存をクリックする。
11. Add a data destinationをクリックします。
12. 追加 Sftpにデータを読み込む タスクを使用して、エクスポートした実行履歴をSftpサーバーに保存します。タスク設定の詳細については、リンク先のページをご覧ください。

特定のワークフローのエクスポート

このセクションでは、エクスポートに含める特定のワークフローを選択する方法について説明します。

1. タスクを設定する際、Choose specific projects, locations, and workflowオプションを選択します。
2. プロジェクトまたはロケーションのドロップダウンメニューから、ワークフローを含むプロジェクトまたはプラットフォームのロケーションを選択します。オプションは次のとおりです。
   • プロジェクト：ワークフローを含むプロジェクトを選択します。
   • スタンドアロンワークフロー：スタンドアロンページのワークフロー（つまり、アンケート調査プロジェクトの「ワークフロー」タブにはない）。
3. ワークフロー・ドロップダウンでワークフローを選択します。このメニューでは複数のワークフローを選択できます。
4. 別の場所のワークフローを追加したい場合は、[別のワークフローを追加] をクリックし、希望のワークフローがすべてタスクに追加されるまで、ステップ 2 と 3 を繰り返します。
5. ワークフローをエクスポートから削除したい場合は、ワークフローの右側にあるマイナス記号（-）をクリックしてください。

実行履歴エクスポートに含まれるデータ

このセクションでは、ワークフロー実行履歴エクスポートのデータフィールドについて説明します。実行履歴がエクスポートされると、ワークフロー実行の各イベントとタスクはそれぞれ独自の行を持つことになります。

• 完了タイムスタンプ：ワークフローの実行終了日時。タスクの設定時に日付と時間のフォーマットをカスタマイズできる。
• コンポーネント実行ステータス：ワークフローのトリガーまたはタスクのステータスを示します。値にはSUCCEEDEDまたはFAILEDが含まれる。
• コンポーネントID：トリガーまたはタスクの一意の ID。
• コンポーネント入力：タスクに渡される入力値 (テキストの差し込み、フィールドマッピングなど)。トリガーは入力を持たない。タスクによっては、この情報がまだ入手できないものもある。
• コンポーネントキー：コンポーネント名に基づく一意のキー (メールタスクなど)。
• コンポーネント名：ワークフロートリガーまたはタスクのローカライズされた名前（例：メールタスク）。
• コンポーネント出力：タスクから渡される出力値（返されるフィールドなど）。トリガーは出力を持たない。タスクによっては、この情報がまだ入手できないものもある。
• コンポーネントタイプ：ワークフローコンポーネント（トリガーまたはタスク）を記述する。
• 再試行：ワークフローが再試行されたかどうかを示す。値にはTRUEまたはFALSEがある。
• 即座に実行Run Immediately：ワークフローが「Run Immediately」ボタンでトリガーされたかを示します。値にはTRUEまたはFALSEがある。
• 開始タイムスタンプ：ワークフローコンポーネントが処理を開始した日時。タスクの設定時に日付と時間のフォーマットをカスタマイズできる。
• トリガーID：ワークフローを開始したトリガーのID。トリガー ID は、特定のワークフロー実行内のすべてのコンポーネントで同じになります。
• ユーザーID：ワークフローを作成したユーザーのクアルトリクスユーザーID。
• ワークフロー実行 ID：クアルトリクスが割り当てた、この特定のワークフロー実行の ID 番号。同じワークフロー実行のすべてのコンポーネントは、同じワークフロー実行 ID を持ちます。
• ワークフロー実行ステータス：ワークフローのステータスを示します。値にはSUCCEEDEDまたはFAILEDが含まれる。
• ワークフロー名：ワークフロー名：ワークフローエディタに表示されるワークフロー名。
• ワークスペース ID：ワークフローを含むワークスペースの ID。
• ワークスペース名：ワークフローを含むワークスペース名。これは、ワークフローを含むプロジェクトの名前か、スタンドアロンワークフローページ内の場合は「global」となります。