参加者のインポート、更新、エクスポート (EX)

参加者のインポート、更新、エクスポートメッセージについて(&A)

参加者ファイルのインポート、更新、エクスポート後に、参加者ファイルのダウンロード結果に関する詳細情報を参照したい場合があります。[参加者] タブの [参加者] セクションから、作成および更新した参加者の数に関する詳細情報、およびアップロードに失敗した参加者に関連するエラー情報を表示することができます。そこで、参加者の変更履歴を確認できます。このページでは、参加者ファイルをインポート、更新、またはエクスポートした後に表示されるさまざまなメッセージについて説明します。

参加者メッセージの表示

インポート、更新、およびエラーメッセージを EX プロジェクトで見つけることができます。

1. 参加者タブを選択します。
   
2. 以下にナビゲートします。 参加者 ［参加者］セクション（まだ選択していない場合）。
3. クリック ツール.
4. 選択 インポート／アップデート／エクスポートを管理.
5. [状況] 列で、[結果の表示] をクリックします。
   
   ヒント：ファイルにエラーが含まれている場合は、［結果を表示］が感嘆符（「!” )。
6. 参加者ファイルの結果を表示します。ここでは、正常終了メッセージ、エラーメッセージ、およびエラーレポートおよびダウンロードを表示することができます。
   

警告: このウィンドウで実行されたジョブは、最初に開始されてから 14 日間のみ保持されます。この時間枠を過ぎると、これらのジョブは削除されます。

正常終了メッセージ

これらのメッセージには、正常にアップロードされた参加者に関する情報が含まれます。

• 階層が正常に更新されました。組織の階層が更新されました。このメッセージには、更新された階層の名前が含まれます。
  ヒント：このメッセージは、階層がすでに作成されている場合にのみ表示されます。
  ヒント：階層を更新するには、アップロードにすべての階層メタデータフィールドを含める必要があります。
• 解析されたユーザー: インポート中に正しく解析されたレコードの数。正しく解析されたということは、Qualtricsシステムがアップロードしたファイルを個別の参加者に正常に分割したことを意味します。この番号がアップロードされた数と一致しない場合は、アップロードしたファイルに問題がある可能性があります (追加のエラーメッセージが表示される可能性があります)。詳細については、エラーメッセージを参照してください)。
• すでにディレクトリに存在する個人: プロジェクトディレクトリにすでに存在しているインポートの参加者数です。この場合、ディレクトリは参加者一覧を参照します。これは、従業員がすでにプロジェクトに存在する場合と同じ通知です。
• プロジェクトにすでに存在する個人: プロジェクトディレクトリにすでに存在しているインポートの参加者数です。これは、すでにディレクトリに存在する個人と同じ通知です。
• Perfully created persons: グローバルディレクトリに新しく作成された参加者の数。これは、新規参加者がグローバルディレクトリに登録されたことを示します。プロジェクトでインポータを使用している場合、このメッセージは、新しい参加者がプロジェクトにも正常に追加されたことを意味します。
• Successfully imported persons ：プロジェクトに正常に追加された参加者の数。
• 合計人数: ファイルアップロードの参加者の合計数。

エラーメッセージ

アップロードしたファイルで参加者の更新に失敗した場合は、エラーメッセージが表示されます。このセクションには、エラーメッセージと、各エラーの解決に役立つトラブルシューティングのヒントが含まれています。

• 新規ユーザーの作成に失敗しました: インポータが作成できなかった参加者の一意の識別子のリストとともに表示されます。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  インポートを再試行してください。問題が解決しない場合は、ファイルを添えてサポートチームに連絡してください。

• 既存ユーザーの個人を作成できませんでした。このユーザーが異なる一意の識別子で既に存在しているかどうかを確認してください。インポートしようとした一意の識別子には、プロジェクトとグローバルディレクトリにすでに存在するユーザー名があります。ただし、これらのユーザー名を持つ既存の参加者には、インポートしようとした参加者とは異なる一意の ID が割り当てられています。このメッセージは、インポータが作成に失敗した一意の ID のリストとともに表示されます。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  このエラーが発生する最も一般的な原因は、インポートとグローバルディレクトリに現在存在する列の間で UniqueIdentifier 列と UserName 列に不一致があるためです。

  例: John Doe は、UniqueIdentifier = X1 および UserName = Y1 のグローバルディレクトリの既存ユーザです。ただし、John Doe をプロジェクトにインポートすると、ファイルの UniqueIdentifier = X2 および UserName = Y1 であることが示されます。プロジェクトとグローバルディレクトリの John の一意 ID が以下のいずれかになるように、データを調整する必要があります。X2または、John の一意 ID が X1 になるようにファイルインポートを調整してください。

• ユーザーを作成できませんでした。ユーザー名はすでに使用されています。インポートしようとした一意の識別子には、グローバルディレクトリ内にすでに存在しているユーザー名がありますが、プロジェクトには存在しません。ただし、既存のプロジェクト参加者には、インポートを試行した参加者とは異なる一意の ID があります。このメッセージは、登録に失敗した一意 ID の一覧とともに表示されます。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  このエラーが発生する最も一般的な原因は、インポートとグローバルディレクトリに現在存在する列の間で UniqueIdentifier 列と UserName 列に不一致があるためです。

  例: John Doe は、UniqueIdentifier = X1 および UserName = Y1 のグローバルディレクトリの既存ユーザです。ただし、John Doe をプロジェクトにインポートすると、ファイルの UniqueIdentifier = X2 および UserName = Y1 であることが示されます。プロジェクトとグローバルディレクトリの John の一意 ID が以下のいずれかになるように、データを調整する必要があります。X2または、John の一意 ID が X1 になるようにファイルインポートを調整してください。

• 新しいユーザーのユーザーを更新できませんでした。ユーザー名は既に使用されています: ファイルからの新しい一意 ID にユーザー名が既に存在するため、一意の識別子は更新されませんでした。つまり、ユーザー名はグローバルディレクトリとプロジェクトにすでに存在しますが、それぞれ異なる一意の ID にアタッチされているため、アップロードしようとした参加者は、すでに異なるメタデータに関連付けられています。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  このエラーが発生する最も一般的な原因は、インポートとグローバルディレクトリに現在存在する列の間で UniqueIdentifier 列と UserName 列に不一致があるためです。

  例: John Doe は、UniqueIdentifier = X1 および UserName = Y1 であるグローバルディレクトリの既存ユーザです。Sara は、UniqueIdentifier = X3 および UserName = Y3 のグローバルディレクトリおよびプロジェクトに存在する別の参加者です。ただし、John Doe をプロジェクトにインポートすると、ファイルに UniqueIdentifier = X2 および UserName =Y3 と表示されます。インポートで以下の 2 つを調整する必要があります。

  1. グローバルディレクトリの John の一意 ID が X1 になるように参加者を調整するか、参加者一覧の一意 ID が X2 になるようにファイルインポートを調整します。
  2. プロジェクトとグローバルディレクトリ (Y1) にすでに存在するユーザ名と一致するように John のユーザ名を調整するか、Sara の UserName を新しいユーザ名に変更して、John が Y3 になるようにします。

• 既存のユーザーのユーザーを更新できませんでした。ユーザー名はすでに使用されています。一意の識別子は、プロジェクトとグローバルディレクトリにすでに存在しますが、ユーザー名が異なるため更新されませんでした。一意の ID は、プロジェクトにすでに存在する別の参加者に添付されます。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  このエラーが発生する最も一般的な原因は、インポートとグローバルディレクトリに現在存在する項目との間で UniqueIdentifier 列と UserName 列に不一致があるためです。

  例: John Doe は、UniqueIdentifier = X1 および UserName = Y1 のグローバルディレクトリの既存ユーザです。ただし、John Doe をプロジェクトにインポートすると、ファイルの UniqueIdentifier = X2 および UserName = Y1 であることが示されます。グローバルディレクトリの John の一意 ID が X2 になるように参加者を調整するか、参加者一覧の一意 ID が X1 になるように参加者一覧を調整する必要があります。インポートは、グローバルディレクトリの内容と一致する必要があります。

• ユーザー、名、姓、メールアドレス、またはユーザー名を作成できませんでした: プロジェクトにまだ含まれていない参加者の新しい一意の識別子の [名]、[姓]、[メールアドレス]、または [ユーザー名] フィールドに無効なエントリが含まれています。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  このメッセージの一般的な理由:

  • ユーザーに関連付けられている電子メールまたはユーザー名の形式が正しくありません。多くの場合、電子メールまたはユーザー名内にスペースがあるか (“jane doe@test.com” など)、”at” 記号 (” @ ” ) がありません。
  • アンパサンド ( ” & ” ) が誤ってこれらの項目の 1 つに含まれています
  • ファイルに長すぎるメールアドレスまたは名前フィールドがあります。

  ヒント：現在、［メールアドレス］フィールドと［名前］フィールドの最大値は50バイトですが、その他のメタデータフィールドの最大値は1000バイトです。(通常、1 バイトは 1 文字と等しくなります。ただし、一部の中国語、韓国語、および日本語の文字は最大 3 バイトにすることができます)。

• 既存のユーザーのユーザーを更新できませんでした: 名、姓、メールアドレス、またはユーザー名が無効です: [名]、[姓]、[メールアドレス]、または [ユーザー名] フィールドに無効なエントリがある、プロジェクト内の既存の一意の識別子の一覧とともに表示されます。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  このメッセージの一般的な理由:

  • ユーザーに関連付けられている電子メールまたはユーザー名の形式が正しくありません。多くの場合、電子メールまたはユーザー名内にスペースがあるか (“jane doe@test.com” など)、”at” 記号 (” @ ” ) がありません。
  • アンパサンド ( ” & ” ) が誤ってこれらの項目の 1 つに含まれています
  • ファイルに長すぎるメールアドレスまたは名前フィールドがあります。

  ヒント：現在、［メールアドレス］フィールドと［名前］フィールドの最大値は50バイトですが、その他のメタデータフィールドの最大値は1000バイトです。(通常、1 バイトは 1 文字と等しくなります。ただし、一部の中国語、韓国語、および日本語の文字は最大 3 バイトにすることができます)。

• 新しいユーザーのユーザーを更新できませんでした: 名、姓、メールアドレス、またはユーザー名が無効です: ファイルの名、姓、またはメールアドレスのいずれかに無効なエントリが含まれています。一意の識別子には既存のユーザー名がありますが、プロジェクトにはまだ存在しません。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  このメッセージの一般的な理由:

  • ユーザーに関連付けられている電子メールまたはユーザー名の形式が正しくありません。多くの場合、電子メールまたはユーザー名内にスペースがあるか (“jane doe@test.com” など)、”at” 記号 (” @ ” ) がありません。
  • アンパサンド ( ” & ” ) が誤ってこれらの項目の 1 つに含まれています
  • ファイルに長すぎるメールアドレスまたは名前フィールドがあります。

  ヒント：現在、［メールアドレス］フィールドと［名前］フィールドの最大値は50バイトですが、その他のメタデータフィールドの最大値は1000バイトです。(通常、1 バイトは 1 文字と等しくなります。ただし、一部の中国語、韓国語、および日本語の文字は最大 3 バイトにすることができます)。

• ディレクトリへの挿入に失敗しました: このメッセージは、多数の参加者をプロジェクトディレクトリまたは参加者一覧 (もしくはその両方) に追加できなかった場合に表示されます。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  ドキュメントで以下の問題を検索します。

  • ユーザーに関連付けられている電子メールまたはユーザー名の形式が正しくありません。多くの場合、電子メールまたはユーザー名内にスペースがあるか (“jane doe@test.com” など)、”at” 記号 (” @ ” ) がありません。
  • アンパサンド ( ” & ” ) が誤ってこれらの項目の 1 つに含まれています
  • ファイルに長すぎるメールアドレスまたは名前フィールドがあります。

  ヒント：現在、［メールアドレス］フィールドと［名前］フィールドの最大値は50バイトですが、その他のメタデータフィールドの最大値は1000バイトです。(通常、1 バイトは 1 文字と等しくなります。ただし、一部の中国語、韓国語、および日本語の文字は最大 3 バイトにすることができます)。

  ファイルにこれらの問題が含まれておらず、このエラーメッセージが引き続き表示される場合は、Qualtricsサポートに連絡し、チームがファイルをトラブルシューティングできるようにしてください。

• プロジェクトに挿入できませんでした: 多数の参加者をプロジェクトに追加できませんでした。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  ドキュメントで以下の問題を検索します。

  • ユーザーに関連付けられている電子メールまたはユーザー名の形式が正しくありません。多くの場合、電子メールまたはユーザー名内にスペースがあるか (“jane doe@test.com” など)、”at” 記号 (” @ ” ) がありません。
  • アンパサンド ( ” & ” ) が誤ってこれらの項目の 1 つに含まれています
  • ファイルに長すぎるメールアドレスまたは名前フィールドがあります。

  ヒント：現在、［メールアドレス］フィールドと［名前］フィールドの最大値は50バイトですが、その他のメタデータフィールドの最大値は1000バイトです。(通常、1 バイトは 1 文字と等しくなります。ただし、一部の中国語、韓国語、および日本語の文字は最大 3 バイトにすることができます)。

  ファイルにこれらの問題が含まれておらず、このエラーメッセージが引き続き表示される場合は、Qualtricsサポートに連絡し、チームがファイルをトラブルシューティングできるようにしてください。

• フィールドセットのリフレッシュに失敗しました: インポート中に最新表示できなかったフィールドセット ID の一覧が表示されます。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  このエラーが表示された場合は、Qualtricsサポートに連絡し、チームが問題を解決できるようにファイルを用意してください。

• 外部/回答者を更新できませんでした: インポート中に更新できなかった新規ユーザーの一意の識別子が表示されます。このメッセージは、項目 “外部” および “回答者” がインポートに含まれており、かつこれらの項目に入力した値が多数失敗した場合にのみ表示されます。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  インポートを再試行してください。問題が解決しない場合は、Qualtricsサポートに連絡し、チームが問題を解決できるようにファイルを用意してください。

• 組織階層の更新に失敗しました。インポートジョブ中に更新できなかった組織階層 ID のリストが表示されます。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  この失敗の最も一般的な理由は、アップロードする組織階層のメタデータのエラーです。たとえば、ファイル内に循環依存関係を生じさせるメタデータを追加した場合 (つまり、階層内でその下に表示されている誰かにレポートする参加者がいる場合)、更新は却下されます。

• 人を更新できませんでした。既存の参加者のメールアドレスまたは名前を更新しようとしてエラーが発生しました。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  このエラーメッセージの最も一般的な原因は、アップロードされたファイルに長すぎる電子メールまたは名前フィールドが含まれていることです。

  ヒント：現在、メールアドレスと名前のフィールドは最大50バイトですが、通常のメタデータフィールドの最大は1000バイトです（通常、1バイトは1文字です）。ただし、一部の中国語、韓国語、および日本語の文字は最大 3 バイトにすることができます)。メールアドレスと名前のフィールドの両方がこの制限未満である場合は、インポートを再試行するか、クアルトリクスサポートにお問い合わせください。

• 一意の識別子、名、または姓のいずれかが不足しているレコードの合計数: これら 3 つのフィールドにデータが入力されていないレコードの合計数が表示されます。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  インポートファイルを確認し、これら 3 つのフィールドのいずれかで空白の行を検索します。空白の項目が見つかったら、その項目を入力し、インポートを再試行します。

• 名または姓の未入力者: これらのフィールドがないレコードの数。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  インポートファイルをレビューしてこれらのフィールドが入力されていることを確認してから、インポートを再試行してください。

• 一意の識別子のないレコードの合計数: 一意の識別子が欠落しているレコードの数が表示されます。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  インポートファイルをレビューし、すべてのレコードに一意の識別子が入力されていることを確認します。

  ヒント：これは、一意の識別子に移行した組織にのみ関連します。

• ヘッダ長の不一致レコード数: インポート中にヘッダ長が一致しなかったレコード数。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  通常、このエラーは CSV ファイルの書式が正しくないために発生します。たとえば、10 個のヘッダーを含む CSV ファイルがあり、そのうちの 1 つの行に 9 列しか含まれていない場合に、このような状況が発生する可能性があります。通常、データを新しいシートにコピーして CSV ファイルとして保存すると、この問題は解決されます。

• 関連ユーザの不足: 参加者はディレクトリに存在しますが、ユーザタブには存在しません。そのため、参加者をプロジェクトに追加することはできません。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  個人がグローバルディレクトリに存在することを確認し、インポートを再試行します。

• 無効なユーザータイプの人：インポートに含まれる無効なユーザータイプの参加者数です。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  このメッセージは、参加者一覧がユーザタイプ列で更新され、”UT_BRANDADMIN” ユーザタイプが追加されたためによく表示されます。この値が含まれている参加者から “UT_BRANDADMIN” を削除し、ファイルを再アップロードします。

• 無効な文字を含むレコードの合計数: 無効な文字を含むレコードの数が表示されます。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  ファイルを検索し、無効な文字を置き換えて、アップロードを再試行してください。

  ヒント：最も一般的な無効な文字は、中括弧（「{ }」）の使用です。

• 人のメタデータの更新に失敗しました：このエラーは、インポートジョブ中に更新に失敗したメタデータのある参加者の一意のIDのリストを表示します。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  メタデータ値が 1000 文字を超える参加者をアップロードすると、このエラーメッセージの一般的な理由の 1 つが発生します。

  もう1つのよくある理由は、参加者をアップロードしようとするユーザーが、そのメタデータを編集するのに必要なデータアクセスロールを持っていないことです。

  いずれの方法でも解決しない場合は、Qualtricsサポートまでお問い合わせください。

• Failure_FailedToUpdatePerson_CannotUpdateHigherThanEXAdmin: このエラーは、インポータが更新に失敗したブランド管理者の一意の識別子のリストを表示します。

  クリックすると、このエラーの解決方法に関する詳細情報が表示されます。

  このエラーメッセージは、EX管理者やその他のプロジェクト管理者によく表示されます。自分がブランド管理者でない場合、インポートによって他のブランド管理者の個人データ（名前、メールアドレス、ユーザータイプなど）を更新することはできません。ファイルのブランド管理者の個人データが［参加者］タブに表示されるものと一致していることを確認してから、インポートをやり直してください。

エラーレポートおよびダウンロード

インポートしようとしているファイルにエラーがある場合があります。これらはファイル自体内に存在する問題であり、グローバルディレクトリには接続しません。このようなエラーについて質問がある場合は、エンゲージメントおよびライフサイクル参加者のインポートを参照してください。