---
title: "Employee File"
description: "スプレッドシートを従業員のソースとして使います。サンプルファイルをダウンロードし、列を埋め、アップロードし、更新するには再アップロードします。HRISなしでPynを運用する方法です。"
sidebar:
  label: 概要
  order: 0
area: integrations
feature: employee-file
appPath: /settings/integrations/available
lastVerified: 2026-11-09
version: "2026-11-09"
audience: admin
related:
  - integrations
  - directory/employees
  - integrations/sync-and-matching
  - integrations/sample-data
intercom:
  - id: "16755797"
    title: How to Upload Employee Data Manually (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16755797-how-to-upload-employee-data-manually-pyn-2
    note: replaces
  - id: "16755703"
    title: Connect  to your HRIS (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16755703-connect-to-your-hris-pyn-2
    note: draws on
  - id: "6024080"
    title: How to upload employee data manually (Pyn 1)
    url: https://intercom.help/pyn/en/articles/6024080-how-to-upload-employee-data-manually-pyn-1
    note: "Pyn 1 article, kept for reference"
translation:
  source: integrations/employee-file/index.mdx
  sourceSha: 5e56e7dc24fde63c7998601735bb3a5093248c35
---

Employee Fileは、スプレッドシートを従業員ディレクトリに変えます。各行が1人の従業員、各列がPynのプロパティで、各アップロードは名簿全体です。行は`employeeId`で追加または更新され、ファイルにいない人はこのソースから削除済みとして印が付きます。Pynは何かを保存する前にファイルを検証し、読めなかった行と列を伝えます。

## 始める前に

- あなたが管理者またはオーナーであること。
- 列の見出しが下のプロパティ名になっているCSV、XLS、またはXLSXを用意すること。**Download Sample File**で、すべての列と5行の例が入ったCSVが手に入ります。
- すべての行に`employeeId`と`primaryEmail`が必要です。タイムゾーンが複数ある国の従業員には`timeZone`を指定します。米国、カナダ、オーストラリアでは`country`と`postalCode`があれば十分です。そうでないと行は拒否されます。

![Installedの下のEmployee File連携。アップロードのパネルが開いています。](https://support.pyn.ai/media/integrations/employee-file/integrations-employee-file-tile.png)

## 接続する

1. Pynで左のナビゲーションの**Settings**を開き、**Integrations**の下の**Available**を開きます。

2. **Employee File**のタイルを選びます。カバーには**File Upload**とあります。Pynが連携を作成し、そのパネルを開きます。「Upload a spreadsheet of your employees to get started. Use the sample file to see the expected columns.」連携を作成できない場合は、**Add Employee File**というタイトルのダイアログに「We could not create the Employee File integration. Please try again or contact support.」と表示されます。

3. **Download Sample File**を選び、見出し行を保ったままそれを元にファイルを作ります。

4. **Upload**を選んでファイルを選びます。検証と保存の間、パネルには「**Uploading...**」と表示されます。

5. 成功すると「Success! Uploaded n records. Head over to the Directory to see employees after processing completes. This can take a minute or two.」と表示されます。

行が失敗すると、パネルは「There were n errors found in the uploaded file:」の下に最初の5件を行と問題とともに表示し、残りの件数を示します。たとえば`Unknown country: "Engalnd"`、`Could not determine timezone from country "United States". Add a postal code or choose a time zone.`、`Invalid birthday format. Expected MM-dd, dd/MM, yyyy-MM-dd or ISO8601 datetime.`です。いずれかの行が失敗している間は何も保存されません。挙げられた行を直し、ファイル全体をもう一度アップロードします。

## 同期されるもの

| 列 | 必須 | 補足 |
| --- | --- | --- |
| `employeeId` | はい | その人の安定したid。アップロードはこれで照合します |
| `primaryEmail` | はい | 勤務先メールアドレス。SlackやGoogleのアカウントの照合にも使います |
| `displayName`、`legalName`、`preferredName`、`jobTitle` | | |
| `personalEmail`、`secondaryEmail`、`avatarUri` | | 個人メールアドレスはプレボーディングに使います |
| `status` | | `active`、`inactive`、または`leave`。空欄は`active`を意味します |
| `startDate`、`terminationDate`、`tenureDate` | | `yyyy-MM-dd`か`yyyy/MM/dd`、または`.xls`か`.xlsx`ファイルの日付セル。存在しない日付は拒否されます |
| `birthday` | | `MM-dd`、`dd/MM`、`yyyy-MM-dd`、またはISOの日時 |
| `country`、`postalCode`、`timeZone` | | 国は名前またはISOコード、タイムゾーンは`Europe/London`のようなIANA名。`.xls`や`.xlsx`ファイルの数値セルはシートの表示どおりに読まれるので、`00000`形式の郵便番号は先頭のゼロを保ちます |
| `businessUnit`、`department`、`division`、`location`、`team` | | 属性とグループになります |
| `managerId`、`buddyId`、`hrbpId`、`mentorId` | | 関係する人の`employeeId` |

スケジュールされた更新はありません。ファイルはアップロードしたときに読まれます。**Advanced**タブには**Fields in Employee File**が列ごとの件数付きで表示されます。[従業員](https://support.pyn.ai/ja/directory/employees/)の**Add employee**で1人ずつ追加することもできます。**Full name\***、**Preferred name**、**Work email**、**Personal email**、**Start date\***、**Country\***、**Time zone\***、**Manager**を尋ね、入社予定者として追加します。

## テストする

アップロードの1、2分後に[従業員](https://support.pyn.ai/ja/directory/employees/)を開きます。アクティブな行は**Active**に、将来の入社日は**Upcoming**に、`status`が`inactive`の行は**Inactive**に表示されます。1人を開いてマネージャーのリンクを確認します。

## 再接続または切断する

認証情報はありません。データを変えるには新しいファイルをアップロードし、必ず全員を含めます。後のファイルにない行は、このソースから削除済みとして印が付き、その人は非アクティブと表示されます。後のファイルにその人を載せると、その行の`status`で戻ります。**Deactivate**はデータを残したままアップロードを無視し、**Activate**で再び有効になります。

## トラブルシューティング

| 表示されるもの | 意味 |
| --- | --- |
| 「The uploaded file was empty」 | 見出しの下にデータ行がないか、見出し行がありません。 |
| `country`や`postalCode`を挙げる行のエラー | 国名が認識されなかったか、郵便番号からゾーンが決まりませんでした。`timeZone`を追加してください。 |
| マネージャーがリンクされない | `managerId`がどの行の`employeeId`にも一致しません。 |
| 誰かが2回表示される | アップロードの間に`employeeId`とメールアドレスがすべて変わったため、以前のレコードと何も一致しませんでした。idとメールアドレスは変えないでください。 |

## 関連ページ

- [連携](https://support.pyn.ai/ja/integrations/)：HRISの選択肢についてです。
- [従業員](https://support.pyn.ai/ja/directory/employees/)：アップロードしたレコードを確認し、1人を追加するにはこちらです。
- [同期の頻度とマッチング](https://support.pyn.ai/ja/integrations/sync-and-matching/)：idとメールアドレスがどう照合されるかについてです。
- [Sample Data](https://support.pyn.ai/ja/integrations/sample-data/)：代わりに架空の名簿でPynを試すにはこちらです。
