ファイル ルールと検証エラー
この記事では、アップロード ファイルの形式を説明し、高度な分析情報アプリにデータを取り込むときに発生する可能性のあるエラーを提供します。
ファイルルールとフィールドルール
任意のデータ行または列に属性に無効な値がある場合、ソース ファイルが固定されるまでアップロード全体が失敗します (または、マッピングによって値が有効になる方法で属性の検証の種類が変更されます)。
ファイルの規則
データ ファイルは .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
検証エラー
高度な分析情報アプリへのデータのアップロード中に発生する可能性がある検証エラーを次に示します。 ほとんどの場合、エラーを修正し、ファイルをもう一度アップロードする必要があります。 データをフォーマットしてアップロードする準備をする方法については、組織データの 準備 に関する記事を参照してください。
カテゴリ | 関連ルール | メッセージ | 適用対象 |
---|---|---|---|
ファイルとファイル拡張子 | データ ファイルは .csv UTF-8 形式である必要があり、空にすることはできません。 | ファイルが空です。 別のファイルを選択し、もう一度アップロードします。 | アップロードのみ .csv |
このファイルの拡張子が '{0}' です。 .csv ファイルを選択し、もう一度アップロードします。 | アップロードのみ .csv | ||
.csv 形式が無効です。 行内の列の数がヘッダー内の列の数と一致しません。 コンマが見つからないか間違っているかを確認し、もう一度アップロードしてください。 | すべて | ||
UTF-8 以外の文字が見つかりました。 .csv ファイルで UTF-8 エンコードが使用されていることを確認し、もう一度アップロードします。 | すべて | ||
列ヘッダー | すべてのフィールド ヘッダーまたは列名は一意である必要があります。 | ファイル内の 2 つ以上の列ヘッダーは同じです。 列ごとに一意のヘッダーを含めます。 | すべて |
すべてのフィールド ヘッダーまたは列名に値を含める必要があります。 | 列 {J} にヘッダーがありません。 選択したファイルにヘッダー名を含めて、もう一度アップロードします。 | すべて | |
すべてのフィールド ヘッダーまたは列名には、英数字 ( Date1 など、文字と数字) または次の記号のみを含める必要があります: ~ ! @ # $ % ^ & * + > : <> [] ?. その他の文字はサポートされていません | {Header name} には、サポートされていない特殊文字が含まれています。 特殊文字を削除し、もう一度アップロードします。 | ||
すべてのフィールド ヘッダーまたは列名にシステム フィールドを含める必要はありません。 | {header name} はシステム フィールドです。 システム フィールドを使用しないように {header name} の名前を変更し、ファイルをもう一度アップロードしてください。 | すべて | |
ファイルをアップロードした後、各 Viva Insights データ フィールドにマップできる列ヘッダーは 1 つだけです。 | ファイルには、1 つのデータ フィールドにマップされた複数のソース列があります。 各ソース列が一意のフィールドにマップされていることを確認します。 | すべて | |
フィールド値 | フィールド値は、正しいデータ型で指定する必要があります。 「 属性リファレンス」を参照してください。 | {header name} 値が無効です。 {ヘッダー名} は、フォーム employee@contoso.com に続く電子メール アドレスにする必要があります。 |
すべて |
{header name} 値が無効です。 {ヘッダー名} は文字列にする必要があります。 | すべて | ||
すべて | |||
{header name} 値が無効です。 {ヘッダー名} は、フォーム 23.75 に続く二重にする必要があります。 | すべて | ||
{header name} 値が無効です。 {ヘッダー名} は整数にする必要があります。 | すべて | ||
必須フィールドには、すべての行の値が必要です。 | {header name} 列または {header name} 値がありません。 {Header name} は必須フィールドであり、行ごとに値が必要です。 {header name} 値を追加し、ファイルをもう一度アップロードします。 | すべて | |
新しい PersonId フィールドに ManagerId 値がありません。 ManagerId は必須フィールドです。 対応する ManagerId フィールドを追加し、もう一度アップロードします。 | すべて | ||
各 PersonId には、一意の ManagerId が必要です。 | すべて | ||
次の場所に ループ を使用することはできません。
|
すべて |