ワークフロータスクからの実行履歴レポートの抽出
ワークフローからの実行履歴レポートの抽出について
クアルトリクスは、作成した各ワークフローの実行履歴を保持します。この実行履歴には、ワークフローのトリガとタスクに関する情報が含まれます。ワークフロータスクからの抽出実行履歴レポートを使用して、選択したワークフローの実行履歴をエクスポートすることができます。その後、独自の内部レコード保持のために、エクスポートされたワークフロー実行履歴を保存することができます。
注意: 実行履歴をエクスポートするには、エクスポートされたデータを保存するための SFTP サーバが組織にある必要があります。SFTP サーバの設定についてサポートが必要な場合は、IT チームに連絡してください。
ワークフロータスクからの抽出実行履歴の設定
ヒント:初期設定が完了したテンプレートのスケジュール ワークフローテンプレートで、SFTPサーバーへのエクスポートワークフロー実行履歴を確認します。
- ETL ワークフローを作成します。
- データソース (ETL 抽出機能) を選択します。
- ワークフローから実行履歴レポートを抽出タスクを選択します。
- エクスポートに含めるワークフローを選択:
- X ロケーションのすべてのワークフロー: このオプションでは、このワークフローを作成した場所のすべてのワークフローがエクスポートされます (たとえば、スタンドアロンワークフローページでワークフローを作成すると、”スタンドアロンワークフローロケーションでのワークフローを許可” と表示されます)。同様に、このワークフローをプロジェクトで作成すると、代わりにこのオプションにそのプロジェクトがリストされます)。
- すべてのプロジェクトおよび場所にわたるすべてのワークフロー: このオプションでは、アクセス権のあるすべてのワークフローがエクスポートされます。
- 特定のプロジェクト、場所、ワークフローを選択:このオプションでは、エクスポートで特定のワークフローを選択できます。詳細については、特定のワークフローのエクスポートを参照してください。
- エクスポートに含めるワークフローのタイプを選択します。成功したワークフロー実行、失敗したワークフロー実行、またはすべてのワークフロー実行を選択することができます。
- エクスポートの時間枠として、過去 24 時間、7 日、15 日、30 日間、またはワークフローが最後に実行された時点以降 (前回のエクスポート以降に発生したすべての実行を含む) を選択します。
- エクスポートでの日付と時刻の書式を選択します。
- フィルタの区切り文字を選択します。区切り文字は、ファイル内の値を区切る文字です。
- すべてのデータを引用符で囲むか、選択した区切り文字に一致する文字を含むフィールドのみを囲むかを選択します。このオプションは、意図しない項目の複数項目への分割を防ぐためのものです。
- 保存をクリックします。
- [データの出力先の追加] をクリックします。
- 追加 SFTP へのデータのロード エクスポートした実行履歴を SFTP サーバに保存するタスク。タスクの設定の詳細については、リンク先のページを参照してください。
特定のワークフローのエクスポート
このセクションでは、エクスポートに含める特定のワークフローを選択する方法について説明します。
- タスクの設定時に、[特定のプロジェクト、場所、およびワークフローを選択] オプションを選択します。
- プロジェクトまたは場所のドロップダウンを使用して、関心のあるワークフローを含むプロジェクトまたはプラットフォームの場所を選択します。オプションは次のとおりです。
- プロジェクト: ワークフローを含むプロジェクトを選択します。
- スタンドアロンワークフロー:スタンドアロンページのワークフロー(アンケートプロジェクトの[ワークフロー]タブ以外)。
- Workflows ドロップダウンを使用して、関心のあるワークフローを選択します。このメニューでは、複数のワークフローを選択できます。
- 別の場所からのワークフローを含める場合は、[さらに追加]をクリックし、目的のワークフローがすべてタスクに追加されるまでステップ2と3を繰り返します。
- エクスポートからワークフローを削除する場合は、その右側にあるマイナス記号(–)をクリックします。
実行履歴エクスポートに含まれるデータ
ヒント:ワークフローが実行され、エクスポートする実行履歴がない場合、ワークフローではヘッダーのみを含む空のCSVファイルが生成されます。
このセクションでは、ワークフロー実行履歴のエクスポートに含まれるデータフィールドについて説明します。実行履歴をエクスポートすると、特定のワークフロー実行の各イベントおよびタスクに独自の行が含まれます。
例:アンケート回答イベント、チケットタスク、メールタスクを含むワークフローがあるとします。このタスクの実行履歴をエクスポートすると、各ワークフロー実行にコンポーネントごとに 1 行ずつ、3 行が含まれます。
- 完了タイムスタンプ: ワークフローの実行が終了した日時。日付および時刻の書式は、タスクの設定時にカスタマイズすることができます。
- コンポーネント実行ステータス: ワークフロートリガまたはタスクのステータスを示します。値には SUCCEDED または FAILED が含まれます。
- コンポーネント ID: トリガまたはタスクの一意 ID。
- コンポーネント入力:タスクに渡される入力値(テキストの差し込み、フィールドマッピングなど)。トリガには入力がありません。一部のタスクでは、まだこの情報を利用できません。
- コンポーネントキー: コンポーネント名に基づく一意のキー (電子メールタスクなど)。
- コンポーネント名: ワークフロートリガまたはタスクのローカライズされた名前 (電子メールタスクなど)。
- コンポーネント出力: タスクから渡された出力値 (返された項目など)。トリガには出力がありません。一部のタスクでは、まだこの情報を利用できません。
- コンポーネントタイプ: ワークフローコンポーネント (トリガまたはタスク) を記述します。
- 再試行: ワークフローが再試行されたかどうかを示します。値には TRUE または FALSE が含まれます。
- 即時実行: ワークフローが即時実行ボタンを使用してトリガされたかどうかを示します。値には TRUE または FALSE が含まれます。
- 開始タイムスタンプ: ワークフローコンポーネントが処理を開始した日時。日付および時刻の書式は、タスクの設定時にカスタマイズすることができます。
- トリガ ID: ワークフローを開始したトリガの ID。トリガ ID は、特定のワークフロー実行内のすべてのコンポーネントで同じになります。
- ユーザーID:ワークフローを作成したユーザーのQualtricsユーザーID。
- ワークフロー実行 ID:クアルトリクスがこの特定のワークフロー実行に割り当てた ID 番号。同じワークフロー実行のすべてのコンポーネントのワークフロー実行 ID が同じになります。
- ワークフロー実行ステータス: ワークフローのステータスを示します。値には SUCCEDED または FAILED が含まれます。
- ワークフロー名: ワークフローエディタに表示されるワークフローの名前。
- ワークスペース ID: ワークフローを含むワークスペースの ID。
- ワークスペース名: ワークフローを含むワークスペースの名前。これは、ワークフローを含むプロジェクトの名前になります。スタンドアロンのワークフローページ内にある場合は、「グローバル」になります。
ヒント:すべてのタスクとトリガーに上記のフィールドのデータがあるわけではありません。