参加者メッセージのインポート、更新、エクスポート(EX)
Qtip:このページでは、エンゲージメント、ライフサイクル、およびアドホック従業員調査プロジェクトで使用できる機能について説明します。それぞれの詳細については、「Employee Experienceプロジェクトのタイプ」を参照してください。この機能はパルスでも利用可能だが、いくつかの違いがある。
参加者メッセージのインポート、アップデート、エクスポートについて
参加者ファイルをインポート、更新、またはエクスポートした後、参加者ファイルのダウンロード結果に関する詳細情報を確認したい場合があります。参加者]タブの[参加者]セクションから、作成および更新された参加者数の詳細情報や、アップロードに失敗した参加者に関するエラー情報を確認できます。そこで、参加者の変更履歴を見ることができます。このページでは、参加者ファイルをインポート、更新、またはエクスポートした後に表示されるさまざまなメッセージについて説明します。
参加者メッセージの閲覧
EXプロジェクトでは、インポート、アップデート、エラーメッセージを確認できます。
- 参加者タブを選択します。
- に移動する。 参加者 のセクションをご覧ください。
- [有効化]を ツール。
- 選択 インポート/アップデート/エクスポートを管理。
- ステータス] 列で、[結果を表示]をクリックします。
Qtip:ファイルにエラーが含まれている場合、View Resultsは赤色で表示され、感嘆符( “!” )が表示されます。 - 参加者ファイルを見る結果. ここでは、成功レポート、エラーメッセージ、エラーレポート、ダウンロードをご覧いただけます。
警告このウィンドウでパフォーマンスされたジョブは、最初に開始されてから14日間しか保持されません。この期間が過ぎると、それらのジョブは削除される。
成功のメッセージ
これらのメッセージには、正常にアップロードされた参加者に関する情報が含まれています。
- 階層の更新に成功しました:組織階層は正常に更新された。このメッセージには、更新された階層名が含まれる。
Qtip:このメッセージは、すでに階層が作成されている場合にのみ表示されます。
- 解析された人:インポート中に正しく解析されたレコードの数。正しく解析されたということは、クアルトリクスシステムがアップロードされたファイルを参加者ごとに分けることに成功したということです。この番号がアップロードされたものと一致しない場合は、アップロードしたファイルに問題がある可能性があります(つまり、追加のエラーメッセージが表示される可能性があります)。詳細はエラーメッセージを参照)。
- ディレクトリに既に存在する人:プロジェクトディレクトリに既に存在するインポート参加者の数。この場合、ディレクトリとは参加者リストを指す。これは、すでにプロジェクトに参加しているPersonsと同じ通知である。
- プロジェクトに既に存在する人:プロジェクトディレクトリに存在するインポートの参加者数。これは、すでにディレクトリにあるPersonsと同じ通知である。
- 作成に成功した参加者:グローバルディレクトリに新規作成された参加者の数。これは、グローバルディレクトリに新しい参加者が作成されたことを示す。プロジェクトでインポーターを使用している場合、このメッセージは、新しい参加者がプロジェクトにも正常に追加されたことを意味します。
- インポートに成功した人数:プロジェクトに正常に追加された参加者の数。
- 総人数:ファイルアップロードの参加者総数。
エラーメッセージ
アップロードしたファイルが参加者の更新に失敗した場合は、エラーメッセージが表示されます。このセクションでは、エラーメッセージと、各エラーの解決に役立つトラブルシューティングのヒントを紹介します。
- 新規ユーザの作成に失敗しました:インポーターが作成に失敗した参加者の一意の識別子のリストが表示されます。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- インポートを再試行してください。それでも問題が解決しない場合は、お手数ですがサポートチームまでご連絡ください。
- 既存のユーザのパーソンの作成に失敗しました。このパーソンが別の一意の識別子で既に存在するかどうかを確認してください:インポートしようとした一意の識別子は、プロジェクトとグローバル・ディレクトリにすでに存在するユーザ名を持っています。しかし、これらのユーザ名を持つ既存の参加者は、インポートしようとした参加者とは異なる一意のIDを持っています。このメッセージは、インポーターが作成に失敗したユニークIDのリストとともに表示されます。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- このエラーが発生する最も一般的な理由は、UniqueIdentifier列とUserName列が、インポートしたものと現在グローバルディレクトリに存在するものとで不一致であるためです。
例John Doeはグローバルディレクトリの既存ユーザーで、UniqueIdentifier =X1、UserName = Y1です。しかし、John Doeをプロジェクトにインポートすると、ファイルにUniqueIdentifier =X2、UserName = Y1と表示されます。プロジェクトとグローバルディレクトリにあるジョンのユニークIDが次の ようになるように、データを調整する必要がある。 X2または、ジョンの固有IDがX1になるようにファイルのインポートを調整する。
- ユーザの作成に失敗しました。ユーザ名は既に使用されています: インポートしようとした一意の識別子は、グローバル・ディレクトリにはすでに存在しますが、プロジェクトには存在しません。しかし、既存のプロジェクト参加者は、インポートを試みた参加者とは異なる固有のIDを持っています。このメッセージは、作成に失敗したユニークIDのリストとともに表示される。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- このエラーが発生する最も一般的な理由は、UniqueIdentifier列とUserName列が、インポートしたものと現在グローバルディレクトリに存在するものとで不一致であるためです。
例John Doeはグローバルディレクトリの既存ユーザーで、UniqueIdentifier =X1、UserName = Y1です。しかし、John Doeをプロジェクトにインポートすると、ファイルにUniqueIdentifier =X2、UserName = Y1と表示されます。プロジェクトとグローバルディレクトリにあるジョンのユニークIDが次の ようになるように、データを調整する必要がある。 X2または、ジョンの固有IDがX1になるようにファイルのインポートを調整する。
- 新しいユーザーの更新に失敗しました:ファイルの新しい一意 ID が既存のユーザ名を持つため、一意 ID が更新されませんでした。これは、グローバルディレクトリとプロジェクトにユーザー名がすでに存在していることを意味しますが、それぞれ異なる一意のIDに添付されているため、アップロードしようとした参加者は、すでに異なるメタデータに関連付けられています。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- このエラーが発生する最も一般的な理由は、UniqueIdentifier列とUserName列が、インポートしたものと現在グローバルディレクトリに存在するものとで不一致であるためです。
例John Doe は、グローバルディレクトリとプロジェクトに存在するユーザで、UniqueIdentifier =X1、UserName =Y1 です。Saraは、グローバルディレクトリとプロジェクトに、UniqueIdentifier =X3、UserName =Y3で存在する別の参加者です。しかし、John Doeをプロジェクトにインポートすると、ファイルにUniqueIdentifier =X2、UserName =Y3と表示されます。インポートで2つのことを調整する必要がある:
- グローバルディレクトリ内のジョンの固有IDがX1になるように参加者を調整するか、参加者リスト内のジョンの固有IDがX2になるようにファイルのインポートを調整してください。
- あるいは、サラのユーザー名を新しいものに変更して、ジョンのユーザー名をY3にする。
- ユーザ名が既に使用されているため、既存ユーザの更新に失敗しました:一意な識別子が更新されませんでした。プロジェクトおよびグローバル・ディレクトリに既に存在しますが、ユーザー名が異なるためです。固有のIDは、すでにプロジェクトに参加している別の参加者に付けられます。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- このエラーが発生する最も一般的な理由は、UniqueIdentifierカラムとUserNameカラムに、インポートしたものと現在グローバルディレクトリに存在するものとの不一致があるためです。
例John Doeはグローバルディレクトリの既存ユーザーで、UniqueIdentifier =X1、UserName = Y1です。しかし、John Doeをプロジェクトにインポートすると、ファイルにUniqueIdentifier =X2、UserName = Y1と表示されます。グローバルディレクトリ内のジョンのユニークIDがX2になるように参加者を調整するか、参加者リスト内のジョンのユニークIDがX1になるように参加者リストを調整する必要があります。インポートはグローバルディレクトリにあるものと一致しなければならない。
- ユーザの作成に失敗しました。姓、名、電子メール、またはユーザ名が無効です: プロジェクトにまだ参加していない参加者の新しい一意の識別子が、姓、名、電子メール、またはUserNameフィールドのいずれかに無効なエントリを含んでいます。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- このメッセージが表示される一般的な理由
- ユーザーに関連付けられている電子メールまたはユーザー名の書式が正しくありません。Eメールやユーザー名にスペースが入っていたり(例えば “jane doe@test.com “など)、”at “の記号(”@“)が入っていないことがよくあります。
- アンパサンド( “&” )が誤ってこれらのフィールドの1つに含まれています。
- ファイルのEメールまたはフィールド名が長すぎます。
Qtip:現在、Eメールとフィールド名の最大バイト数は50バイトですが、その他のメタデータフィールドの最大バイト数は1000バイトです。(一般に、1バイトは1文字に等しい。ただし、一部の中国語、韓国語、日本語の文字は3バイトまで)。
- 姓、名、電子メール、またはユーザー名が無効です:First Name、Last Name、Email、UserNameフィールドのいずれかに無効なエントリがある、プロジェクト内の既存の一意識別子のリストが表示されます。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- このメッセージが表示される一般的な理由
- ユーザーに関連付けられている電子メールまたはユーザー名の書式が正しくありません。Eメールやユーザー名にスペースが入っていたり(例えば “jane doe@test.com “など)、”at “記号(”@“)がなかったりすることがよくあります。
- アンパサンド( “&” )が誤ってこれらのフィールドの1つに含まれています。
- ファイルのEメールまたはフィールド名が長すぎます。
Qtip:現在、Eメールとフィールド名の最大バイト数は50バイトですが、その他のメタデータフィールドの最大バイト数は1000バイトです。(一般に、1バイトは1文字に等しい。ただし、一部の中国語、韓国語、日本語の文字は3バイトまで)。
- 新しい人のユーザ更新に失敗しました: 姓、名、電子メール、またはユーザ名が無効です:ファイルには、姓、名、電子メールのいずれかに無効なエントリが含まれています。一意な識別子は既存のユーザー名を持っていますが、プロジェクトにはまだありません。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- このメッセージが表示される一般的な理由
- ユーザーに関連付けられている電子メールまたはユーザー名の書式が正しくありません。Eメールやユーザー名にスペースが入っていたり(例えば “jane doe@test.com “など)、”at “記号(”@“)がなかったりすることがよくあります。
- アンパサンド( “&” )が誤ってこれらのフィールドの1つに含まれています。
- ファイルのEメールまたはフィールド名が長すぎます。
Qtip:現在、Eメールとフィールド名の最大バイト数は50バイトですが、その他のメタデータフィールドの最大バイト数は1000バイトです。(一般に、1バイトは1文字に等しい。ただし、一部の中国語、韓国語、日本語の文字は3バイトまで)。
- ディレクトリへの挿入に失敗しました:このメッセージは、多数の参加者がプロジェクトディレクトリおよび/または参加者リストへの追加に失敗した場合に表示されます。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- 以下の項目について文書を検索してください:
- ユーザーに関連付けられている電子メールまたはユーザー名の書式が正しくありません。Eメールやユーザー名にスペースが入っていたり(例えば “jane doe@test.com “など)、”at “記号(”@“)がなかったりすることがよくあります。
- アンパサンド( “&” )が誤ってこれらのフィールドの1つに含まれています。
- ファイルのEメールまたはフィールド名が長すぎます。
Qtip:現在、Eメールとフィールド名の最大バイト数は50バイトですが、その他のメタデータフィールドの最大バイト数は1000バイトです。(一般に、1バイトは1文字に等しい。ただし、一部の中国語、韓国語、日本語の文字は3バイトまで)。ファイルにこれらの問題が含まれていないにもかかわらず、このエラーメッセージが表示される場合は、クアルトリクスサポートに連絡し、チームがトラブルシューティングを行えるようにファイルをご用意ください。
- プロジェクトへの挿入に失敗: 多数の参加者をプロジェクトに追加できませんでした。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- 以下の項目について文書を検索してください:
- ユーザーに関連付けられている電子メールまたはユーザー名の書式が正しくありません。Eメールやユーザー名にスペースが入っていたり(例えば “jane doe@test.com “など)、”at “記号(”@“)がなかったりすることがよくあります。
- アンパサンド( “&” )が誤ってこれらのフィールドの1つに含まれています。
- ファイルのEメールまたはフィールド名が長すぎます。
Qtip:現在、Eメールとフィールド名の最大バイト数は50バイトですが、その他のメタデータフィールドの最大バイト数は1000バイトです。(一般に、1バイトは1文字に等しい。ただし、一部の中国語、韓国語、日本語の文字は3バイトまで)。ファイルにこれらの問題が含まれていないにもかかわらず、このエラーメッセージが表示される場合は、クアルトリクスサポートに連絡し、チームがトラブルシューティングを行えるようにファイルをご用意ください。
- フィールドセットの更新に失敗しました:インポート中に更新に失敗したフィールドセットIDのリストが表示されます。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- このエラーが表示された場合は、クアルトリクスサポートに連絡し、チームがトラブルシューティングできるようにファイルをご用意ください。
- 外部/回答者の更新に失敗しました:インポート中に更新に失敗した新規ユーザーの一意の識別子が表示されます。このメッセージが表示されるのは、「外部」と「回答者」のフィールドがインポートに含まれており、これらのフィールドに入力した値の多くが失敗した場合のみです。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- インポートを再試行してください。それでも問題が解決しない場合は、クアルトリクスサポートにご連絡の上、チームがトラブルシューティングできるようにファイルをご用意ください。
- 組織階層の更新に失敗しました:インポート・ジョブ中に更新に失敗した組織階層IDのリストを表示します。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- この失敗の最も一般的な原因は、アップロードする組織階層メタデータのエラーです。例えば、ファイル内に循環依存関係を作成するメタデータを追加した場合(すなわち、参加者が階層でその下にリストされている者にレポートする場合)、更新は拒否されます。
- 参加者の更新に失敗しました:既存の参加者のEメールまたは名前のいずれかを更新しようとしたときにエラーが発生しました。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- このエラーメッセージの最も一般的な原因は、アップロードされたファイルのEメールまたはフィールド名が長すぎることです。
Qtip:現在、Eメールと名フィールドは最大50バイトですが、通常のメタデータフィールドは最大1000バイトです(一般的に、1バイトは1文字に相当します)。ただし、一部の中国語、韓国語、日本語の文字は3バイトまで)。Eメールとフィールド名の両方がこの制限を下回っている場合は、インポートを再試行するか、クアルトリクスサポートに連絡してください。
- Unique Identifier、First Name、Last Nameのいずれかが欠落しているレコードの総数:これらの3つのフィールドにデータが入力されていないレコードの総数が表示されます。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- インポートファイルを評価し、これら3つのフィールドのいずれかが空白になっている行を探します。空白のフィールドを見つけたら、そのフィールドに入力し、インポートを再試行します。
- 姓または名が欠けている人:これらのフィールドが欠落しているレコード数。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- インポートファイルを評価し、これらのフィールドに入力されていることを確認してから、インポートを再試行してください。
- 一意な識別子が見つからないレコードの総数:一意識別子が欠落しているレコード数が表示されます。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- インポートファイルを評価し、すべてのレコードに一意の識別子が入力されていることを確認してください。
Qtip:これは一意な識別子に移行した組織にのみ関係する。
- ヘッダー長が不一致だったレコードの合計:インポート時にヘッダー長が不一致だったレコード数。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- このエラーは通常、CSVファイルのフォーマットミスが原因です。例えば、10個のヘッダーを持つCSVファイルがあったとして、そのうちの1行が9列しかなかった場合、このようなことが起こり得る。通常、データを新しいシートにコピーし、CSVファイルとして保存すれば、この問題は解決します。
- 関連するユーザが見つからない:参加者はディレクトリに存在しますが、[ユーザー]タブには存在しません。そのため、参加者をプロジェクトに加えることはできない。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- グローバルディレクトリに個体が存在することを確認し、インポートを再試行してください。
- 無効なユーザータイプを持つ参加者:無効なユーザータイプを持つインポートの参加者数。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- このメッセージが最もよく表示されるのは、参加者リストがユーザタイプ列で更新され、「UT_BRANDADMIN」ユーザタイプが追加されたためです。この値が含まれている参加者から「UT_BRANDADMIN」を削除し、ファイルを再アップロードしてください。
- 無効な文字を含むレコードの総数:無効な文字を含むレコード数が表示されます。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- ファイルを検索し、無効な文字を置換して、アップロードを再試行してください。
Qtip:最も一般的な無効文字は、中括弧 ( “{ }” ) の使用です。
- メタデータの更新に失敗しました:このエラーは、インポートジョブ中に更新に失敗したメタデータを持つ参加者の一意のIDのリストを表示します。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- このエラーメッセージが表示される一般的な理由の1つは、1000文字を超えるメタデータ値を持つ参加者をアップロードした場合に起こります。
もう1つのよくある理由は、参加者をアップロードしようとしているユーザーが、そのメタデータを編集するのに必要なデータアクセスロールを持っていないことです。
いずれの方法でも解決しない場合は、クアルトリクスサポートまでお問い合わせください。
- Failure_FailledToUpdatePerson_CannnotUpdateHigerThanEXAdmin:このエラーは、インポーターが更新に失敗したブランド管理者の一意の識別子のリストを表示します。
- このエラーの解決方法の詳細については、こちらをクリックしてください。
- このエラーメッセージは、EX管理者やその他のプロジェクト管理者によく表示されます。自分がブランド管理者でない場合、インポートによって他のブランド管理者の個人データ(名前、Eメール、ユーザータイプなど)を更新することはできません。ファイル内のブランド管理者の個人データが、[参加者]タブに表示されているものと一致していることを確認してから、インポートを再試行してください。
エラーレポートとダウンロード
インポートしようとしたファイルにエラーがある場合があります。これらはファイル自体に存在する問題であり、グローバルディレクトリに接続するものではない。この種のエラーに関するご質問は、ENGAGE & Lifecycle参加者のインポートをご覧ください。