次の方法で共有

派生属性に関連するファイル アップロード エラーを解決する

  • [アーティクル]

従業員属性データを Microsoft Viva Glint にアップロードすると、次のいずれかの派生エラー メッセージが表示されることがあります。 記事の上部にある一覧から発生するエラーを選択し、適切な解決策に従ってエラーを修正します。

日付形式が正しく構成されていません

エラー メッセージ:

DERIVATION_ERROR: 日付形式が次の列に対して正しく構成されていません: (Hire Date)。 mm/dd/yyyy などの <日付形式が必要>。 Microsoft Excel ファイルの場合は、セルがテキスト形式であることを確認します。

この問題は、アップロードするファイルの日付形式が Viva Glint で属性を設定するときに指定された形式と一致しないために発生します。

解決方法

この問題を修正するには、次の手順に従ってください。

  1. 従業員属性データ ファイルを開きます。 ファイルの種類に応じて、適切な方法を使用します。

    • データ ファイルに .xls または .xlsx 拡張子がある場合は、Microsoft Excel で開きます。
    • データ ファイルに .csv 拡張子がある場合は、 Text Import Wizard を使用して、元の形式でデータを保持して Excel にデータをインポートします。

  2. エラー メッセージに表示される日付形式の列ごとに、次の手順に従います。

    1. 列の右側 (列 A など) に、 General として書式設定された新しい列 (列 B) を挿入します。

    2. 新しい列の最初のセル (セル B1) を選択し、次の数式を入力して Enter キーを押します。

      =TEXT(<元の日付列の最初のセル (例: A1>,"<mm/dd/yyyy などのエラー メッセージ内の日付形式を変更しました">)

      たとえば、次の数式を入力します。

      =TEXT(A1,"mm/dd/yyyy")

    3. 数式を 新しい列 (列 B) のセルに入力します。

    4. 新しい列 (列 B) の日付値をコピーし、 Paste>Paste Special>Values option を使用して、元の日付列 (列 A) に値を貼り付けます。

    5. 数式を含む新しい列を削除します。

  3. ファイルを保存し、Viva Glint にもう一度アップロードします。

アップロードされたファイル内の属性ヘッダーが Viva Glint 構成と一致しない

エラー メッセージ:

DERIVATION_ERROR: アップロードされたファイルの属性ヘッダーが Viva Glint の構成と一致しません。 すべての属性ヘッダー名が一致し、ファイルに含まれていることを確認します。 [Hire Date and Birth Year] 列を含めます。 これらの列は、テニュア、年齢グループの属性を派生するために使用されます。

この問題は、アップロードされたファイルの属性ヘッダーと Viva Glint で指定されている属性名が一致しない場合に発生します。 属性ヘッダーは、大文字と小文字とスペースを含め、Viva Glint の属性名と正確に一致する必要があります。

解決方法

この問題を修正するには、次の手順に従ってください。

  1. 従業員属性データ ファイルを開きます。 ファイルの種類に応じて、適切な方法を使用します。

    • データ ファイルに .xls または .xlsx 拡張子がある場合は、Microsoft Excel で開きます。
    • データ ファイルに .csv 拡張子がある場合は、 Text Import Wizard を使用して、元の形式でデータを保持して Excel にデータをインポートします。

  2. Viva Glint で指定されている属性名を確認します。

    1. 管理者ダッシュボードで Configure アイコンを選択し、Employees セクションで People を選択します。
    2. Actions>Manage User Attributes を選択します。
    3. 次のセクションの属性を確認します。

      • アクティブな属性

      • 派生属性

        注: このセクションでは、Viva Glint が派生属性を作成するために使用する属性を確認します。 これらの属性は、 Calculate From フィールドに一覧表示されます。

      • オプションのシステム属性

      • 階層属性

  3. 手順 2c で識別された各属性について、Viva Glint の名前とデータ ファイルのヘッダー行の値を比較し、不一致を修正します。 次のことを確認してください。

    • 大文字と小文字の不整合はありません。 たとえば、 EMPLOYEE ID と Employee ID が一致しません。
    • 余分なスペースはありません。 たとえば、" " 状態" と "状態" が一致しません。
    • スペル ミスはありません。
    • 余分な文字はありません。 たとえば、 Email_Address と EmailAddress が一致しません。
    • BOM> など、BOM エンコードを使用して UTF-8 によって追加される文字はありません。

    不一致を修正するには、Viva Glint で属性を するか ファイル内の属性ヘッダーを更新します。

  4. ファイルを保存し、Viva Glint にもう一度アップロードします。

ファイルが UTF-8 エンコードされていない

エラー メッセージ:

DERIVATION_ERROR: ファイルが UTF-8 でエンコードされていません。 <x-y>の行の近くでエラーが見つかりました。 UTF-8 エンコードでファイルをフォーマットし、再アップロードします。

この問題は、アップロードした.csv ファイルが UTF-8 エンコードを使用して保存されないために発生します。

解決方法

この問題を解決するには、Microsoft Excel またはテキスト エディターで次の手順に従って、UTF-8 エンコードを使用してファイルを再保存します。

  • Microsoft Excel の場合:

    1. .csv ファイルを Excel にインポートし データを想定した形式で保持します。
    2. [ファイル]>[名前を付けて保存]を選びます。
    3. [として保存] ダイアログ ボックスで、[種類として保存] ボックスの一覧から [CSV UTF-8 (コンマ区切り) を選択し、保存を選択します。

  • メモ帳やメモ帳++ などのテキスト エディターでは、次の手順を実行します。

    1. .csv ファイルを開きます。
    2. [ファイル]>[名前を付けて保存] の順に選択します。
    3. [名前] ダイアログ ボックスで、[ファイル名 ボックスにファイル名を入力し、[種類として保存ドロップダウン ボックスから すべてのファイルを選択し、Encoding ドロップダウン ボックスから UTF-8 を選択し、Save を選択します。

次に、ファイルをもう一度 Viva Glint にアップロードします。

注: 今後この問題を回避するには、人事情報システム (HRIS) チームと協力して、Viva Glint に自動的に送信されるすべてのファイルが BOM で UTF-8 ではなく UTF-8 を使用してエンコードされるようにしてください。

ファイルが予期しない形式である

エラー メッセージ:

  • DERIVATION_ERROR: ファイルが予期しない形式です。 csv ファイル形式を想定しています。 渡されたファイルが UTF-8 エンコードとコンマ区切りの値を持つ csv ファイルであるかどうかを確認します。

  • DERIVATION_ERROR: ファイルが予期しない形式です。 xlsx ファイル形式を想定しています。 渡されたファイルが、数式のない xlsx ファイルであり、追加のシートがないかどうかを確認します。

この問題は、アップロードするファイルが Viva Glint で属性を設定するときに指定された形式でないために発生します。

解決方法

この問題を解決するには、予想される形式でファイルを再保存し、Viva Glint に再度アップロードします。

  • 想定される形式が CSV の場合:
    • UTF-8 エンコードを使用して、ファイルを CSV ファイルとして保存し直 UTF-8 および BOM。
    • コンマを使用して値を区切ります。 値にコンマが含まれている場合は、二重引用符 ("Manager、Customer Success" など) で囲みます。
  • 想定される形式が XLSX の場合:
    • ファイルを XLSX ファイルとして再保存します。
    • パスワードを削除します。
    • ファイルに数式が含まれていることを確認します。
    • 1 枚のデータのみを保持します。

無効なデータが原因で派生に失敗しました

エラー メッセージ:

DERIVATION_ERROR: ファイルの処理に失敗しました。 <attribute の無効なデータ (Hire Date> など) が原因で派生に失敗しました。 ファイルを確認して再アップロードします。

この問題は、アップロードするファイルに次のような無効なデータが含まれているために発生します。

  • 00/00/0000
  • 01/01/1900
  • #N/A
  • #REF

解決方法

この問題を修正するには、次の手順に従ってください。

  1. 従業員属性データ ファイルを開きます。 ファイルの種類に応じて、適切な方法を使用します。

    • データ ファイルに .xls または .xlsx 拡張子がある場合は、Microsoft Excel で開きます。
    • データ ファイルに .csv 拡張子がある場合は、 Text Import Wizard を使用して、元の形式でデータを保持して Excel にデータをインポートします。

  2. エラー メッセージに一覧表示されている属性については、値を確認し、無効なデータを特定します。

  3. 無効なデータを修正または削除します。

  4. ファイルを保存し、Viva Glint にもう一度アップロードします。

行の長さがヘッダーの長さと一致しない

エラー メッセージ:

ENRICHMENT_FAILURE: 行 <行番号 (100 など> 長さがヘッダーの長さと一致しません。 ファイルを作成できません。

解決方法

この問題を修正するには、次の手順に従ってください。

  1. 従業員属性データ ファイルを開きます。 ファイルの種類に応じて、適切な方法を使用します。

    • データ ファイルに .xls または .xlsx 拡張子がある場合は、Microsoft Excel で開きます。
    • データ ファイルに .csv 拡張子がある場合は、 Text Import Wizard を使用して、元の形式でデータを保持して Excel にデータをインポートします。

  2. エラー メッセージで指定されている行を確認します。

  3. その行のデータを、ヘッダー行の列数と一致するように更新します。

  4. ファイルを保存し、Viva Glint にもう一度アップロードします。

MANAGER_HIERARCHY_UPDATE_ERROR

エラー メッセージ:

MANAGER_HIERARCHY_UPDATE_ERROR: 上司がいない従業員レコードが少なくとも 1 つ存在する必要があります。それ以外の場合は、レポート階層が無効である可能性があります。 CEO/トップレベル リーダーの場合は、マネージャー ID を空のままにします。

この問題は、CEO またはトップレベルのユーザーに Manager ID 値が割り当てられている場合に発生します。

解決方法

この問題を修正するには、次の手順に従ってください。

  1. 従業員属性データ ファイルで、CEO または最上位のユーザーを見つけて、マネージャー ID の値を削除します。

    注: Manager ID フィールドが空白であることを確認してください。 値としてスペースまたは "NULL" を入力しないでください。

  2. ファイルを保存し、Viva Glint にもう一度アップロードします。

今後この問題を回避するには、人事情報システム (HRIS) チームと協力して、従業員属性データの CEO または最上位のユーザーに対して Manager ID フィールドが空白になっていることを確認します。

MANAGER_HIERARCHY_ERROR

エラー メッセージ:

マネージャー階層エラー: マネージャーの電子メール アドレス snguyen@contoso.com が複数のコマンドチェーンに記載され、サイクルが作成されます。 ユーザー自身に報告しているか、解決する必要がある別のユーザーとの循環レポートを作成しています。

このエラーは、従業員属性データに、1 人以上のマネージャーが自分に報告するか、他のマネージャーとの循環レポート関係があることを示している場合に発生します。

解決方法

この問題を修正するには、次の手順に従ってください。

  1. 管理者ダッシュボードで、Configure アイコンを選択し、Client の設定 セクションでactivity 監査ログ選択します。

  2. ログで、アップロードされなかったファイルを見つけて、Details 列でエラー ファイルダウンロードを選択します。 ダウンロードされたエラー ファイル内の行は、各マネージャーの直接レポートと間接レポートの両方を表します。

  3. エラー ファイルの Description 列から重複するデータを検索して削除します。

  4. エラー ファイルに問題があると記載されている個別のマネージャーのメール アドレスを特定します。

  5. 手順 4 で識別されたマネージャーのメール アドレスごとに、従業員属性データを確認して、次の循環レポートリレーションシップが存在するかどうかを判断します。

    • マネージャーは自分自身に報告します。 そのため、従業員 ID とマネージャー ID は同じです。
    • 2 人以上のマネージャーが互いにレポートし、レポート ループを作成します。 たとえば、マネージャー A はマネージャー B に報告し、マネージャー B はマネージャー A にレポートします。

  6. 見かけ上の循環レポートリレーションシップをすべて修正します。

    Note

    • 組織内の CEO または最上位の人物は、自分への報告として表示されないようにする必要があります。 Manager ID フィールドは常に空白にする必要があります。
    • マネージャーの役職を入力する必要があるために、マネージャーが自分自身へのレポートとして表示される場合は、代わりにスキップ レベルのマネージャーのマネージャー ID を指定します。

  7. ファイルを保存し、Viva Glint にもう一度アップロードします。