ファイル ルールと検証エラー
この記事では、アップロード ファイルの形式を説明し、高度な分析情報アプリにデータを取り込むときに発生する可能性のあるエラーを提供します。
ファイルルールとフィールドルール
任意のデータ行または列に属性に無効な値がある場合、詳細構成で無効なデータを含む有効な行をアップロードして除外するかどうかに応じて、アップロード全体が失敗するか、警告が生成される可能性があります。
[詳細な構成] で無効なデータを含む有効な行をアップロードし、無効なデータを含む行を除外する場合は、ソース ファイルが固定されるまで検証エラーが原因でアップロード全体が失敗します (または、マッピングによって属性の検証の種類が変更され、値が有効になります)。
[詳細な構成] で無効なデータを含む有効な行をアップロードし、無効なデータを含む行を除外する場合は、有効な値を含む行のみがアップロードされ、エラーが原因で取り込まれなかった行に対する警告が表示されます。 この設定は既定ではオフになっています。
ファイルの規則
データ ファイルは .csv UTF-8 形式である必要があり、空にすることはできません。
ソースフィールドヘッダーとターゲットフィールドヘッダーのルール
すべてのソースおよびターゲット フィールド ヘッダーまたは列名は、次の必要があります。
- ASCII 英数字 ( Date1 など、文字と数字)、またはアンダースコア (_) のみが含まれます。 @、#、%、& などの特殊な英数字以外の文字はサポートされていません。
- 値を含めます。
- 一意である。
ユーザー設定のターゲット フィールド ヘッダーの規則
すべてのユーザー設定ターゲット フィールド ヘッダーまたは列名は、次の必要があります。
- 先頭、中間、または末尾に空白がありません。
- 次のシステム フィールドが含まれています。
- PeopleHistoricalId
- StartDate
- EndDate
- ドメイン
- PopulationType
- TimeZone
- StandardTimeZone
- WorkdayStart
- WorkDayEnd
- WeekendDays
- InferredTeamSize
- ObjectId
- IsActive
- "Microsoft_" 以降
- MetricDate
- PrimaryCollaborator_PersonId
- SecondaryCollaborator_PersonId
必須フィールドには、すべての行の値が必要です。
ファイルをアップロードした後は、各Viva Insightsデータ フィールドに 1 つの列ヘッダーのみをマップできます。
フィールドの値のルール
フィールド値は、正しいデータ型で指定する必要があります。 「 属性リファレンス」を参照してください。
フィールドの値の文字のルール
- 行のフィールド値の文字数は 128 KB を超えることはできません。これは約 1024 x 128 文字です。
- フィールド値では、"新しい行" (\n) 文字は使用できません。
注:
フィールド値には、日本語文字などの 2 バイト文字を使用できます。
[ManagerId] フィールドの値の規則
各 PersonId には、一意の ManagerId が必要です。 つまり、1 人に複数のマネージャーを設定することはできません。
次の場所にループを使用することはできません。
- マネージャーと従業員が互いに報告します。
- マネージャーは従業員に報告します。
ディランがクリスのマネージャーだとします。 組織のデータを表示できませんでした。
- クリスはディランに報告し、ディランはクリスに報告します。
- クリスに報告するディラン。
次の階層の両方で、エンド ユーザー エクスペリエンスでエラーが発生します。
.csv エクスポート ファイルの例
有効な .csv エクスポート ファイルのスニペットの例を次に示します。
PersonId,EffectiveDate,HireDate,ManagerId,LevelDesignation,Organization,Layer,Area Emp1@contoso.com,12/1/2020,1/3/2014,Mgr1@contoso.com,Junior IC,Sales,8,Southeast Emp2@contoso.com,11/1/2020,1/3/2014,Mgr1@contoso.com,Junior IC,Sales,8,Southeast Emp3@contoso.com,12/1/2020,1/3/2014,Mgr2@contoso.com,Manager,Sales,7,Northeast Emp4@contoso.com,10/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest Emp5@contoso.com,11/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest Emp6@contoso.com,12/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest
データが不足している従業員のログをダウンロードする
[ データ品質] ページでは、組織のデータ ファイルに測定されたユーザーが見つからないかどうかを確認できます。 その場合は、"{number} 測定されたユーザーに組織データが見つからないというメッセージが表示されます。 組織のデータが不足しているユーザーをダウンロードし、より高品質な分析情報を得るためのデータをアップロードします。
ダウンロード ログには、Domain および TimeZone システム フィールド 以外 のデータ フィールドがない測定ユーザーが表示されます。
検証エラーと警告
高度な分析情報アプリへのデータのアップロード中に発生する可能性がある検証エラーを次に示します。 ほとんどの場合、エラーを修正し、ファイルをもう一度アップロードする必要があります。 データをフォーマットしてアップロードする準備をする方法については、組織データの 準備 に関する記事を参照してください。
| カテゴリ | 関連ルール | メッセージ | 適用対象 |
|---|---|---|---|
| ファイルとファイル拡張子 | データ ファイルは .csv UTF-8 形式である必要があり、空にすることはできません。 | ファイルが空です。 別のファイルを選択し、もう一度アップロードします。 | アップロードのみ .csv |
| このファイルの拡張子が '{0}' です。 .csv ファイルを選択し、もう一度アップロードします。 | アップロードのみ .csv | ||
| API ベースのインポートと Azure BLOB インポートのデータ ファイルは、.zip ファイル形式である必要があり、UTF-8 形式の 1 つの .csv ファイルと 1 つの.json マッピング ファイルが含まれている必要があります。 ファイルを空にすることはできません。 | .zip ファイル内のファイルに問題があります。 .zip ファイルに 1 つの.json ファイルと 1 つの .csv ファイルのみが含まれていることを確認し、もう一度アップロードします。 | API ベースのインポートと Azure BLOB のインポート | |
| .zip ファイル内の .csv ファイルが空です。 空でない .csv ファイルを追加し、.zip ファイルをもう一度アップロードします。 | API ベースのインポートと Azure BLOB のインポート | ||
| .zip ファイル内の.json ファイルが空です。 空でない.json ファイルを追加し、.zip ファイルをもう一度アップロードします。 | API ベースのインポートと Azure BLOB のインポート | ||
| .json ファイルが無効です。 有効な.json ファイルを使用し、.zip ファイルをもう一度アップロードします。 | API ベースのインポートと Azure BLOB のインポート | ||
| 列ヘッダー | すべてのフィールド ヘッダーまたは列名は一意である必要があります。 | ファイル内の 2 つ以上の列ヘッダーは同じです。 列ごとに一意のヘッダーを含めます。 | すべて |
| すべてのフィールド ヘッダーまたは列名に値を含める必要があります。 | 列 {J} にヘッダーがありません。 選択したファイルにヘッダー名を含めて、もう一度アップロードします。 | すべて | |
| .csv ファイルは、.json ファイル内の null または空のフィールドにマップされます。 空でないフィールドにマップし、.zip ファイルをもう一度アップロードします。 | API ベースのインポートと Azure BLOB のインポート | ||
| すべてのフィールド ヘッダーまたは列名には、英数字 ( Date1 など、文字と数字) または次の記号のみを含める必要があります: ~ ! @ # $ % ^ & * + > : <> [] ?. その他の文字はサポートされていません | {Header name} には、サポートされていない特殊文字が含まれています。 特殊文字を削除し、もう一度アップロードします。 | ||
| すべてのフィールド ヘッダーまたは列名にシステム フィールドを含める必要はありません。 | {header name} はシステム フィールドです。 システム フィールドを使用しないように {header name} の名前を変更し、ファイルをもう一度アップロードしてください。 | すべて | |
| ファイルをアップロードした後は、各Viva Insightsデータ フィールドに 1 つの列ヘッダーのみをマップできます。 | ファイルには、1 つのデータ フィールドにマップされた複数のソース列があります。 各ソース列が一意のフィールドにマップされていることを確認します。 | すべて | |
| .csv ファイル内のヘッダー名が、.json ファイルでマップしたフィールドと一致しません。 .json ファイルに、.csv ファイルと同じフィールドが含まれていることを確認し、.zip ファイルをもう一度アップロードします。 | API ベースのインポートと Azure BLOB のインポート | ||
| .csv ファイル内のヘッダーの数が、.json ファイルでマップしたフィールドと一致しません。 .json ファイルに、.csv ファイルと同じフィールドが含まれていることを確認し、.zip ファイルをもう一度アップロードします。 | API ベースのインポートと Azure BLOB のインポート | ||
| すべてのソース列を、サポートされているデータ型にマップする必要があります | ソース列は、サポートされているデータ型にマップされていません。 サポートされているデータ型にマップし、ファイルをもう一度アップロードします。 | API ベースのインポートと Azure BLOB のインポート | |
| .json ファイルは、予期しない "DatasetType" を指定します。 正しい値を指定し、.zip ファイルをもう一度アップロードします。 | API ベースのインポートと Azure BLOB のインポート |
フィールド値に関連する検証エラーと警告を次に示します。 [詳細な構成] で有効な行をアップロードし、無効なデータを含む行を除外すると、エラーが発生し、検証が失敗します。 オンにすると、有効な値を含む行のみがアップロードされ、エラーのために取り込まれなかった行に対する警告が表示されます。 この設定は既定ではオフになっています。
| カテゴリ | 関連ルール | メッセージ | エラーまたは警告 | 適用対象 |
|---|---|---|---|---|
| フィールド値 | データ ファイルは、.csv UTF-8 形式である必要があります。 | .csv 形式が無効です。 行内の列の数がヘッダー内の列の数と一致しません。 コンマが見つからないか、誤った場合はチェックして、もう一度アップロードしてください。 | Error | すべて |
| .csv 形式が無効です。 行内の列の数がヘッダー内の列の数と一致しません。 無効な値を持つ行はアップロードされません。 コンマが見つからないか、誤った場合はチェックして、もう一度アップロードしてください。 | 警告 | すべて | ||
| UTF-8 以外の文字が見つかりました。 .csv ファイルで UTF-8 エンコードが使用されていることを確認し、もう一度アップロードします。 | Error | すべて | ||
| UTF-8 以外の文字が見つかりました。 無効な値を持つ行はアップロードされません。 .csv ファイルで UTF-8 エンコードが使用されていることを確認し、もう一度アップロードします。 | 警告 | すべて | ||
| フィールド値は、正しいデータ型で指定する必要があります。 「 属性リファレンス」を参照してください。 | {header name} 値が無効です。 {ヘッダー名} は、フォーム employee@contoso.comに続く電子メール アドレスにする必要があります。 |
警告 | すべて | |
{ヘッダー名} に無効な値が含まれています。 無効な値を持つ行はアップロードされません。 {ヘッダー名} は、フォーム employee@contoso.comに続く電子メール アドレスにする必要があります。 |
警告 | すべて | ||
| {header name} 値が無効です。 {ヘッダー名} は文字列にする必要があります。 | Error | すべて | ||
| {ヘッダー名} に無効な値が含まれています。 無効な値を持つ行はアップロードされません。 {ヘッダー名} は文字列にする必要があります。 | 警告 | すべて | ||
| 警告 | すべて | |||
| {header name} 値が無効です。 {ヘッダー名} は、フォーム 23.75 に続く二重にする必要があります。 | Error | すべて | ||
| {ヘッダー名} に無効な値が含まれています。 無効な値を持つ行はアップロードされません。 {ヘッダー名} は、フォーム 23.75 に続く二重にする必要があります。 | 警告 | すべて | ||
| {header name} 値が無効です。 {ヘッダー名} は整数にする必要があります。 | Error | すべて | ||
| {ヘッダー名} に無効な値が含まれています。 無効な値を持つ行はアップロードされません。 {ヘッダー名} は整数にする必要があります。 | 警告 | すべて | ||
| 必須フィールドには、すべての行の値が必要です。 | {header name} 列または {header name} 値がありません。 {Header name} は必須フィールドであり、行ごとに値が必要です。 {header name} 値を追加し、ファイルをもう一度アップロードします。 | Error | すべて | |
| 新しい PersonId フィールドに ManagerId 値がありません。 ManagerId は必須フィールドです。 対応する ManagerId フィールドを追加し、もう一度アップロードします。 | Error | すべて | ||
| 各 PersonId には、一意の ManagerId が必要です。 | すべて | |||
次の場所に ループ を使用することはできません。
|
Error | すべて |