次の方法で共有

ファイル ルールと検証エラー

  • [アーティクル]

この記事では、アップロード ファイルの形式を説明し、高度な分析情報アプリにデータを取り込むときに発生する可能性のあるエラーを提供します。

ファイルルールとフィールドルール

任意のデータ行または列に属性に無効な値がある場合、ソース ファイルが固定されるまでアップロード全体が失敗します (または、マッピングによって値が有効になる方法で属性の検証の種類が変更されます)。

ファイルの規則

データ ファイルは .csv UTF-8 形式である必要があり、空にすることはできません。

フィールドの見出しのルール

すべてのフィールド ヘッダーまたは列名は、次の必要があります。

  • ASCII 英数字 ( Date1 など、文字と数字)、またはアンダースコア (_) のみが含まれます。 その他の文字はサポートされていません。
  • 値を含めます。
  • 先頭、中、末尾の空白文字、または @、#、%、& などの特殊な英数字以外の文字はありません。
  • 一意である。
  • 次のシステム フィールドが含まれています。
    • PeopleHistoricalId
    • StartDate
    • EndDate
    • ドメイン
    • PopulationType
    • TimeZone
    • StandardTimeZone
    • WorkdayStart
    • WorkDayEnd
    • WeekendDays
    • InferredTeamSize
    • ObjectId
    • マイクロソフト_

必須フィールドには、すべての行の値が必要です。

ファイルをアップロードした後は、各Viva Insightsデータ フィールドに 1 つの列ヘッダーのみをマップできます。

フィールドの値のルール

フィールド値は、正しいデータ型で指定する必要があります。 「 属性リファレンス」を参照してください。

フィールドの値の文字のルール

  • 行のフィールド値の文字数は 128 KB を超えることはできません。これは約 1024 x 128 文字です。
  • フィールド値では、"新しい行" (\n) 文字は使用できません。

注:

フィールド値には、日本語文字などの 2 バイト文字を使用できます。

[ManagerId] フィールドの値の規則

各 PersonId には、一意の ManagerId が必要です。 つまり、1 人に複数のマネージャーを設定することはできません。

次の場所にループを使用することはできません。

  • マネージャーと従業員が互いに報告します。
  • マネージャーは従業員に報告します。

ディランがクリスのマネージャーだとします。 組織のデータを表示できませんでした。

  • クリスはディランに報告し、ディランはクリスに報告します。
  • クリスに報告するディラン。

次の階層の両方で、エンド ユーザー エクスペリエンスでエラーが発生します。

3 人の間のマネージャー階層ループを示すスクリーンショット。

.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} 値が無効です。 {ヘッダー名} は、MM/DD/YYYY 形式の後の日付にする必要があります。 すべて
{header name} 値が無効です。 {ヘッダー名} は、フォーム 23.75 に続く二重にする必要があります。 すべて
{header name} 値が無効です。 {ヘッダー名} は整数にする必要があります。 すべて
必須フィールドには、すべての行の値が必要です。 {header name} 列または {header name} 値がありません。 {Header name} は必須フィールドであり、行ごとに値が必要です。 {header name} 値を追加し、ファイルをもう一度アップロードします。 すべて
新しい PersonId フィールドに ManagerId 値がありません。 ManagerId は必須フィールドです。 対応する ManagerId フィールドを追加し、もう一度アップロードします。 すべて
各 PersonId には、一意の ManagerId が必要です。 すべて
次の場所に ループ を使用することはできません。
  • マネージャーと従業員が互いに報告します。
  • マネージャーは従業員に報告します。
 すべて