基本変換タスク
基本変換タスクについて
基本変換タスクでは、ローデータを編集、検証し、互換性のある簡略化されたドキュメントにすることができます。データ変換は、パートナーやチームへの送信に適した任意の形式にエクスポートできるよう、データセットを自動的に統一化するのに役立ちます。
基本変換タスクの設定
- 左上のナビゲーションメニューをクリックします。
![[ワークフロー]ページでETLワークフローを作成](https://www.qualtrics.com/m/assets/support/wp-content/uploads//2023/06/BasicTransformation_1.png)
- ワークフローを選択します。
- ワークフローを作成するをクリックします。
- データの抽出、変換、読み込み(ETL)をクリックします。
- 必要に応じて、上部にあるワークフロー名をクリックして、ワークフローの名前を変更します。

- 抽出タスクを設定します。このタスクは、このワークフローで変換するデータを提供します。抽出タスクの設定方法については、「ETLワークフローの構築」を参照してください。
- データ変換をクリックします。
- メニューから基本変換を選択します。

- ドロップダウンからデータソースを選択します。

- 次へをクリックします。
- 抽出タスクのフィールドを編集します。各フィールドには主要な要素が4つあります。
- 必須:このデータが必須な場合は、フィールドの横にあるチェックボックスを選択します。ここににチェックが入っていてそのフィールドにデータがない場合はスキップされます。
- ソースフィールド:抽出タスクのファイルに含まれるフィールドすべてです。新しいフィールドを追加したら、どの列からデータを取得するかをドロップダウンで選択します。
- 宛先フィールド名:変換後のデータセットのフィールド名をどうするかを指定します。ソースファイルのフィールド名とは異なるものに変更したい場合は、この列の名前を編集します。
注意フィールド名には100文字までの制限があります。
- フィールドタイプ:変換後のデータセット内で抽出したデータをどう扱うかを指定します。フィールドタイプによって、利用できる変換の操作が決まります。
- 右側にある3点リーダーメニューをクリックすると、データの変換、検証ルールの追加、条件フィールドの追加、データセットからのフィールドの削除を行うことができます。これらのオプションの詳細については、以下のセクションを参照してください。
![強調表示された[データを変換]とデータ変換のオプションを表示する3点リーダーメニュー。[フィールドを追加]も強調表示](https://www.qualtrics.com/m/assets/support/wp-content/uploads//2023/06/BasicTransformation_6.png)
- データセットにフィールドを追加したい場合は、フィールドを追加をクリックします。
- 適用済みの変換タブですべての変換を確認します。各変換の詳細については、変換をクリックしてください。編集または削除するには、3点リーダーメニューをクリックします。
ヒント:[適用済みの変換]タブに表示された順番、つまり設定された順番で操作が実行されます。同じフィールドに複数の操作が設定されている場合、後続の操作は前の操作の結果に基づいて計算されます。 - 検証ルールタブですべての検証ルールを確認します。各検証ルールの詳細については、検証ルールをクリックしてください。編集または削除するには、3点リーダーメニューをクリックします。
- 次へをクリックします。
- 変換と検証の概要を確認します。準備ができたら保存をクリックします。
データ変換
フィールドで利用できる変換操作は、宛先のフィールドタイプによって異なります。

テキスト値、テキストセット、オープンテキストのフィールドでは次の変換を利用できます。
- 接頭辞を追加:各値の先頭にテキストを追加します。
- 接尾辞を追加:各値の末尾にテキストを追加します。
- 連結:複数のフィールドの値を連結します。
- 大文字小文字の形式を設定:フィールド内のすべての値に大文字小文字のある形式(例:UPPERCASE)を適用します。
- マップ値:一致する値に基づいてインプット値を特定のアウトプットにマッピングします。一致しない値についてはオプションでデフォルト値を設定できます。
- 値を置き換え:フィールド内の値を検索して置換します。
- 分割:元のフィールドを区切り文字で分けられた複数のフィールドに分割します。
- 文字数で区切る:先頭または末尾からの文字数を指定して、テキストを2つのフィールドに分割します。
- 部分文字列変換:開始インデックスと終了インデックスを指定して、フィールド内のテキストから部分文字列を作成します。
- 値をトリミング:フィールド内のテキストの先頭、末尾、または両端から指定した文字列または空白を削除します。
複数値のテキストセットフィールドでは、次の変換を利用できます。
- 接頭辞を追加:各値の先頭にテキストを追加します。
- 接尾辞を追加:各値の末尾にテキストを追加します。
- 連結:複数のフィールドの値を連結します。
- 大文字小文字の形式を設定:フィールド内のすべての値に大文字小文字のある形式(例:UPPERCASE)を適用します。
- 値を置き換え:フィールド内の値を検索して置換します。
- 分割:元のフィールドを区切り文字で分けられた複数のフィールドに分割します。
数値と数値セットフィールドでは、次の変換を利用できます。
- 絶対値:フィールドの各数値の絶対値を取得します。
- 加算変換:フィールドの各数値に一定の値を足すか、2つのフィールドを加算します。
- 値の平均:各回答について、選択したフィールドの数値の平均を取ります。
- 除算変換:フィールドの各数値を一定の値で割るか、フィールドを別のフィールドで割ります。
- 整数の除算変換:フィールドの各数値を一定の値で割るか、フィールドを別のフィールドで割ります。返すのは整数(integer)のみです。
- 値の最大値:各回答について、選択したフィールドの最大値を取ります。
- 値の中央値:各回答について、選択したフィールドの中央値を取ります。
- 値の最小値:各回答について、選択したフィールドの最小値を取ります。
- 乗算変換:フィールドの各数値に一定の値を掛けるか、2つのフィールドを掛け合わせます。
- 値を丸める:フィールド内のすべての値を切り上げるか切り捨てます。
- 減算変換:フィールドの各数値から一定の値を引くか、フィールドから別のフィールドを引きます。
- 値の合計:各回答について、選択したフィールドの値の合計を取ります。
日付フィールドでは、次の変換を利用できます。
- 日付計算:現在のソースの日付から別の日付までの経過時間を返します。
- 曜日変換:現在のソースの日付からその曜日を判定します。
- 日付/時刻のオフセット:日付/時刻を、指定した時間の分オフセットする。たとえば、インタラクションから5日後の日付を計算できます。
日付/時刻のカスタム書式を入力する場合、次の書式オプションを利用できます。
- 年:yy、yyyy
- 月M、MM、MMM、MMMM
- 日:d、dd
- 年における曜日:DDD
- 午前/午後の時間:K、KK
- 1日の時間:HH
- 分:m、mm
- 秒:s、ss
- 分数秒:S、SS、SSS
- タイムゾーンオフセット:ZZZZ、ZZ:ZZ(+/-を含むことができる)
- 午前/午後:a
- 曜日:E、EE
- タイムゾーン形式:z
データ検証
検証ルールを追加すると、フィールドのデータが必ず同じ形式となるよう基準や条件を作成することができます。たとえば、無効な電子メールアドレスを持つレコードを削除したいとします。
- 3点リーダーメニューをクリックし、検証ルールの追加をクリックします。
![[検証ルールを追加]が強調表示された3点リーダーメニュー](https://www.qualtrics.com/m/assets/support/wp-content/uploads//2023/06/BasicTransformation_9.png)
- データ検証のオプションを選択します。
- 空ではないレコードのみを含める:選択したフィールドが空の回答を省きたい場合は、このオプションを有効にします。この設定は、変換テーブルの必須の列と同じ機能を果たします。
- 検証ルールが失敗した場合、すべてのレコードをスキップ:いずれかの検証ルールが失敗した場合、すべてのレコードがスキップされます。
- 指定したタイプにキャストできるレコードのみを含むレコードデータタイプを強制:特定のデータ形式を持つレコードのみを含めます。たとえば、テキスト値の場合、そのデータが数値であるべきかテキスト形式であるべきかを選択できます。このオプションを有効にすると、下の2つ目のオプションが利用できるようになります。
- 失敗した場合はスキップする代わりに警告を表示:このオプションを有効にすると、検証基準を満たさないレコードもデータセットに含まれるようになります。行レポートには、回答がこの基準を見たさなかったことを示す警告が表示されます。このチェックを外すと、そのレコードはスキップされ、新しいデータセットには含まれなくなります。[検証ルールが失敗した場合、すべてのレコードをスキップ]を有効にしている場合は、このオプションを選択することはできません。
- データを検証する条件を追加するには、検証ルールを追加をクリックします。ルールの作成の詳細については、以下のセクションを参照してください。
- 適用をクリックします。
検証ルール
検証ルールを追加すると、フィールドのデータを条件に従って検証できます。条件構築の詳細については、「条件構築の基礎」を参照してください。
- 条件を満たさなかった場合にレコードをどうするかを選択します。そのレコードをスキップしてデータセットに含めないか、警告を表示してデータセットに含めるかを選択できます。

- 条件を満たすためには、すべてのルールが真である必要があるのか、いずれかのルールが真である必要があるのかを指定します。
- オペレーターのドロップダウンとテキストボックスを使って条件を作成します。ここで、要件を満たすためにこのフィールドのレコードに必要なものを決定します。
ヒント:別のコンディションを作成したり、既存のコンディションを削除するには、右側の3点リーダーメニューをクリックします。 - 必要であれば、別の検証ルールを追加してください。
ヒント:検証ルールを削除するにはごみ箱をクリックします。
- 適用をクリックします。
条件付きフィールド
条件付きフィールドを作成するには、ほかのフィールドを利用してフィールドの作成方法を指定するロジック条件を設定します。ソースフィールドの右にある3点リーダーメニューから条件フィールドを追加します。条件構築の詳細については、「条件構築の基礎」を参照してください。
条件付きフィールド
条件付きフィールドは、1つの論理条件に基づいて新しいフィールドを作成します。
- 新しいフィールドの名前を入力します。

- 条件に使用する演算子を選びます。
- どうすれば条件が満たされるかを決定する値を入力します。
- 手順2と3で作成したルールが正の場合に返す値を入力します。
- 手順2と3で作成したルールが誤の場合に返す値を入力します。
- 完了したら適用をクリックします。
詳細条件付きフィールド
詳細条件付きフィールドは、複数の論理条件または条件セットに基づいて新しいフィールドを作成します。
- 新しいフィールドの名前を入力します。

- 条件を満たすためには、すべてのルールが正である必要があるのか、いずれかのルールが正である必要があるのかを指定します。
- 条件を作成します。詳細は、上の「条件付きフィールド」のセクションを参照してください。
- 新しい条件セットを作成するには、分岐を追加をクリックします。
Qtip:15分岐までという制限があります。
- 完了したら適用をクリックします。
変換後のファイルとレポート
基本変換タスクは、変換後のデータセットを理解するのに役立つ2つのレポートとともに、変換されたファイルを生成します。ワークフローエディターの実行履歴タブで、ワークフロー実行内の基本変換タスクをクリックすると、右側にファイルが表示されます。これらのファイルは、右側にあるダウンロードアイコンをクリックしてエクスポートすることができます。
- 変換レポート:ソースファイル内のレコードに対して実行されたすべての変換と、その名前、行番号、ステータス、失敗理由などの詳細。
- 変換ファイル:データ変換の結果。すべての変換および検証が適用された、新しいデータセットを含む。
- 検証レポート:実行された検証のレポート。レコードが除外されたかどうか、また不合格だった検証を含みます。
トラブルシューティング
- ファイルサイズの制限:基本変換タスクが生成するファイルが1GBを超えた場合、ワークフローは失敗します。
- 変換によるファイルサイズの増大:データをどのように変換するかによって、基本変換タスクがファイルにより多くのデータを追加する可能性があります。抽出するファイルがすでに1GBの制限に近い場合、変換によってファイルが大きくなりすぎて処理できなくなる可能性があることに注意してください。
- アンケートフィールドの欠落:ETLが、基本変換タスクの前にアンケートから回答を抽出するタスクで始まる場合、アンケートフィールドが欠落していることに気付くことがあります。これは、アンケートに新しいフィールドを追加した場合、抽出タスクを再度保存してから変換タスクにフィールドを追加する必要があるためです。これを解決するには
- アンケートから回答を抽出タスクを開きます。
- アンケートの列で、新しいフィールドを選択します。([すべてのフィールドをダウンロード]を選択している場合は、次の手順に進み、タスクを保存します。)
- ほかの設定はすべて同じままでタスクを保存します。
- 基本変換タスクを開きます。
- フィールドが表示されるはずです。
- データ読み込みタスクにこの新しいフィールドが含まれているかどうかも確認してください。



