---
title: "従業員プロパティ"
description: "従業員のすべての項目、従業員同士のリレーション、プロフィールをソースに結び付ける外部id、ライフサイクルステージの決まり方、そしてタイムゾーンの解決のされ方です。"
sidebar:
  order: 3
area: directory
feature: employees
appPath: /directory/home
lastVerified: 2026-11-15
version: "2026-11-03"
audience: admin
related:
  - directory/employees/fix-missing-details
  - directory/employees/upload-employees-from-a-spreadsheet
  - directory/employee-groups/reference-group-types
intercom:
  - id: "6024089"
    title: "How does Pyn determine a message recipient's time zone?"
    url: https://intercom.help/pyn/en/articles/6024089-how-does-pyn-determine-a-message-recipient-s-time-zone
    note: draws on
translation:
  source: directory/employees/reference-employee-properties.mdx
  sourceSha: 26c518f755f0f65bd8a7a9d1ee1045b6b8884d0a
---

従業員プロフィールは、固定のプロパティ一式と、HRISが追加するカスタム項目からなります。1列目のキーはトークンが使う名前で、**アップロード列**が「はい」の行では、Employee Fileのアップロードが読み取る見出しでもあります。

## プロパティ

| キー | ラベル | アップロード列 | 補足 |
| --- | --- | --- | --- |
| `displayName` | Display Name | はい | あらゆる場所に表示されるフルネームです。 |
| `preferredName` | Preferred Name | はい | 挨拶の中のファーストネームなど、トークンが使います。 |
| `legalName` | Legal Name | はい | 書類用です。 |
| `jobTitle` | Job Title | はい | |
| `primaryEmail` | Primary Email Address | はい（必須） | メッセージの届け先となる勤務先アドレスです。 |
| `personalEmail` | Personal Email Address | はい | 勤務先アドレスがない場合に、一覧で斜体で表示されます。 |
| `secondaryEmail` | Secondary Email Address | はい | |
| `avatarUri` | Avatar Image | はい | URLです。空の場合はイニシャルが表示されます。 |
| `startDate` | Start Date | はい | 直近または今後の開始日です。`yyyy-MM-dd`または`yyyy/MM/dd`。Onboardingと記念日のトリガー、Upcomingビューの基準になります。 |
| `terminationDate` | Termination Date | はい | `yyyy-MM-dd`または`yyyy/MM/dd`。 |
| `tenureDate` | Tenure Date | はい | Start Dateと異なる場合の、勤続年数用の本来の開始日です。`yyyy-MM-dd`または`yyyy/MM/dd`。 |
| `probationEndDate` | Probation End Date | いいえ | ソースが供給する場合にだけ表示されます。 |
| `birthday` | Birthday | はい | プロフィールでは`MM-dd`。アップロードでは`dd/MM`、`yyyy-MM-dd`、ISO 8601の日時も受け付けます。 |
| `businessUnit`、`department`、`division`、`location`、`team` | Business Unit、Department、Division、Location、Team | はい | 自由入力です。Department、Division、Location、Countryは最初から属性です。 |
| `employmentType` | Employment Type | いいえ | HRISから来るFull-TimeやContractorなどの自由入力です。最初から属性です。 |
| `jobClass` | Job Class | いいえ | ADPから来る自由入力です。属性にできます。 |
| `country` | Primary Country | はい | プロフィールではISOコードです。アップロードでは名前を受け付けます。 |
| `postalCode` | Postal Code | はい | 米国、カナダ、オーストラリアのタイムゾーンの解決に使います。 |
| `timeZone` | Time Zone | はい | IANA名です。 |
| `locale` | Locale | いいえ | `en-US`のようなBCP 47タグです。ない場合は国から解決されます。 |
| `active` | Active status | はい（`status`として） | **Active**、**Inactive**、**On Leave**、**Removed**のいずれかです。アップロードで空欄の場合はアクティブを意味します。 |
| `stage` | Lifecycle | いいえ | Pynが割り出します。以下を参照してください。 |
| `exempt` | Exempt Status | いいえ | **Exempt**または**Non-Exempt**（米国）です。 |
| `workerType`、`employeeType`、`timeType` | Worker Type、Employee Type、Time Type | いいえ | **Contingent Worker** / **Employee**、**Fixed Term** / **PEO** / **Regular**、**Full-Time** / **Part-Time**です。WorkdayとRipplingから来ます。 |
| `removed` | Removed | いいえ | その人がソースシステムから消えたときに設定されます。 |
| `returningEmployee` | Returning Employee | いいえ | 退職後に再雇用された人です（BambooHR）。 |
| `missingSsn` | Missing Social Security Number | いいえ | Workdayから来るはい/いいえです。この行と下の4行は、Pynがオンにしたワークスペースでだけプロフィールに表示されます。 |
| `orientationDate` | Orientation Date | いいえ | Workdayから来る、新入社員のオリエンテーション日です。 |
| `orientationEligible` | Orientation Eligible | いいえ | Workdayから来るはい/いいえです。 |
| `over401kLimit` | Over-contribution to 401k | いいえ | Workdayから来るはい/いいえです。 |
| `surveyLink` | Survey Link | いいえ | Workdayから来る、その人のアクティブなサーベイのURLです。 |

アップロードには、行を識別するあなた自身の安定したidである`employeeId`も必要で、以下の4つのリレーション列も受け付けます。Pynはそれ以外の見出しを無視するため、スプレッドシートの`employmentType`のような列は何も設定しません。

HRISはカスタム項目を追加できます。カスタム項目は**Details**で標準の項目より前に表示され、単一選択型と複数選択型のものは**Filters**の一覧に現れます。文字列型、ブール型、単一選択型のプロパティは属性にできます。[属性を作成する](https://support.pyn.ai/ja/directory/demographics/create-a-demographic/)を参照してください。

## リレーション

| リレーション | アップロード列 | 用途 |
| --- | --- | --- |
| **Manager** | `managerId` | Managerの受信者とトークン、**Managers**リレーショングループです。 |
| **Buddy** | `buddyId` | Buddyの受信者、**Buddies**グループです。 |
| **HRBP** | `hrbpId` | HRBPの受信者とトークン、**HRBPs**グループです。 |
| **Mentor** | `mentorId` | **Mentors**グループです。 |

各アップロード列には、同じファイル内の相手の`employeeId`を入れます。HRISは独自のidを供給し、Pynがそれらを照合します。リレーショングループでリレーションが数えられるのは、相手が在籍中の従業員である場合だけです。

## 外部idとソース

Pynは、そのシステム自身のid（BambooHRの従業員id、Workdayのワーカーid、Employee Fileのあなたの`employeeId`）と、その人のメールアドレスでレコードを1つのプロフィールに照合するため、同じ勤務先メールアドレスを持つスプレッドシートの行とHRISのレコードは1人の従業員になります。プロフィールに一致するメールアドレスでサインインすると、そのユーザーがプロフィールにリンクされます。

それぞれの値は、その値を供給する最初のソースから、次の順で取られます。フォームの回答とwebhookで送信されたデータ、次にWorkday、BambooHR、ADP、Greenhouse、Ashby、Rippling、HiBob、その次にEmployee Fileです。Slackは最後で、表示名、呼び名、主要メールアドレス、タイムゾーン、カスタム項目だけです。アバターは例外で、Slackの写真はHRISの写真より先に使われます。プロフィールの**Sources**タブにレコードが並び、その1つで**Disconnect**を選ぶと統合から外れます。

## ライフサイクルステージの決まり方

Pynは開始日、退職日、今日を並べ、その順序からステージを読み取ります。

| 日付 | ステージ |
| --- | --- |
| ソースから削除された | 日付にかかわらず**Terminated**。 |
| 開始日が未来（退職日がないか、それより前） | **Upcoming Joiner** |
| 開始日が過去で、退職日がないか未来で、非アクティブとマークされていない | **Current Active Employee** |
| 開始日が過去で、非アクティブとマークされている（または雇用のソースがない） | **Terminated** |
| 退職日が過去 | **Terminated** |
| 日付が一切ない | アクティブなら**Current Active Employee**、そうでなければ**Terminated** |

「非アクティブとマークされている」とは、最も優先度の高いソースが`inactive`としているか、どのソースも雇用システムではないことを意味します。Slack、Microsoft Teams、Greenhouse、Ashbyは雇用システムではないため、それらにしか知られていない人は非アクティブと見なされます。`active`が`leave`の場合はレコードに**On Leave**と表示されますが、ステージは変わりません。入社済みで休職中の従業員は**Current Active Employee**です。

## タイムゾーンの解決のされ方

1. ソースが供給するタイムゾーン。有効なIANA名、認識できる略称、またはWindowsのタイムゾーン名である場合です。
2. それ以外の場合は、米国（ZIP）、カナダ、オーストラリアについて、国と郵便番号から。
3. それ以外の場合は、国にタイムゾーンが1つしかなければ、その国から。
4. それ以外の場合はなし。その人へのメッセージは**Settings** > **Account Settings**にあるワークスペースのタイムゾーンで送られ、Employee Fileのアップロードはその行を報告するので、タイムゾーンまたは郵便番号を追加できます。

## 関連ページ

- [マネージャー、タイムゾーン、メールアドレスの抜けを直す](https://support.pyn.ai/ja/directory/employees/fix-missing-details/)：値を正しく直す方法です。
- [スプレッドシートから従業員をアップロードする](https://support.pyn.ai/ja/directory/employees/upload-employees-from-a-spreadsheet/)：これらのキーを見出しにするファイルについてです。
- [グループの種類](https://support.pyn.ai/ja/directory/employee-groups/reference-group-types/)：これらのプロパティから組み立てられるグループです。
