---
title: HiBobのフィールドマッピング
description: HiBobが接続されているときにPynがHiBobから埋められるメッセージのトークンと従業員プロフィールのフィールド、それぞれの背後にあるBobのフィールド、ほかに供給できるソース、そして値が表示されないときに確認することです。
sidebar:
  order: 1
area: integrations
feature: hibob
appPath: /settings/integrations/installed
lastVerified: 2026-11-15
version: "2026-11-06"
audience: admin
related:
  - flows/steps/reference-tokens
  - integrations/hibob
  - integrations/hris-fields
  - directory/employees/reference-employee-properties
  - directory/employees/fix-missing-details
translation:
  source: integrations/hibob/field-mapping.mdx
  sourceSha: 2642a82ed96efd584f86db853f16c51104e71d57
---

メッセージ内の`principal.preferredName`や`principal.managerName`のようなトークンは、Pynの従業員プロフィールのフィールドを読み取ります。HiBobが接続されていると、PynはそのプロフィールのフィールドをBobから埋められます。フィールドに値があるかどうかは、あなたのBobテナントが何を持っているか、接続したBobアカウントが何を見られるか、ほかにどのソースが接続されているかで決まります。表を使って、トークンからBobで入力または修正すべきフィールドをたどってください。

## トークンとその背後にあるBobのフィールド

エディターのツールバーで**Insert token**を選ぶか`@`を入力すると、一覧には各トークンが**principal**（エンロールされた従業員）と**recipient**（メッセージを受け取る人）の下に名前で表示されます。各行はPynがBobから埋められるトークンであって、常に値があるトークンではありません。プロフィールのフィールドが空なら、トークンはフォールバックを表示します。下の`principal`トークンのうち一覧に`recipient`の対になるものがあるものは、受信者について同じフィールドを読み取ります。

| トークン | 読み取るプロフィールのフィールド | Bobのフィールドid |
| --- | --- | --- |
| `principal.preferredName`（**Preferred Name**として表示） | **Preferred Name**、なければ**Display Name**の最初の単語 | `root.displayName` |
| `principal.firstName` | **Display Name**の最初の単語 | `root.displayName` |
| `principal.preferredFullName` | **Preferred Name**と姓、なければ**Display Name** | `root.displayName` |
| `principal.legalName` | **Legal Name** | `root.fullName` |
| `principal.jobTitle` | **Job Title** | `work.title` |
| `principal.department` | **Department** | `work.department` |
| `principal.location` | **Location** | `work.site`、なければ`address.city` |
| `principal.startDate`、`principal.startDate.dayAfter`、`principal.startDate.nextBusinessDay`、`principal.nextAnniversary` | **Start Date** | `work.startDate` |
| `principal.tenure` | **Tenure Date**、なければ**Start Date** | `work.originalStartDate`、なければ`work.startDate` |
| `principal.birthday`、`principal.nextBirthday` | **Birthday** | `personal.shortBirthDate` |
| `principal.managerName`、`principal.managerPreferredName`、`principal.managerEmail` | **Manager**の**Display Name**と**Primary Email Address** | `work.reportsTo`がマネージャーを選び、その人自身の`root.displayName`と`root.email`が値を埋めます |
| `principal.hrbp.name`、`principal.hrbp.preferredName`、`principal.hrbp.preferredFullName`、`principal.hrbp.email` | **HRBP**の名前とメールアドレス | `employee.hrbp`がHRBPを選び、その人自身の`root.displayName`と`root.email`が値を埋めます |
| `principal.buddy.name`、`principal.buddy.preferredName`、`principal.buddy.preferredFullName`、`principal.buddy.email`、`principal.buddy.startDate.nextBusinessDay` | **Buddy**の名前、メールアドレス、入社日 | あなたのバディ用カスタムフィールドがバディを選び、その人自身の`root.displayName`、`root.email`、`work.startDate`が値を埋めます |

BobにはPynが読み取る呼び名のフィールドがないので、別のソースが呼び名を供給しない限り、呼び名のトークンはBobのDisplay nameの最初の単語を表示します。

一覧にあるこれらのトークンにはHiBobのソースがありません：エンロールメントの基準日である`date.reference`と、`recipient.surveyLink`。

**Probation End Date**やPynサポートがマッピングしたBobのカスタムフィールドなど、ほかのプロフィールのフィールドには、**Insert token**、次に「**Employee Field…**」を選んでフィールドを選びます。Raw HTMLメールでは、`principal.email`は`root.email`を、`principal.personalEmail`は`home.privateEmail`を、`principal.endDate`は`internal.terminationDate`を、`principal.country`は`address.country`を読み取ります。すべてのトークンとそのフォールバックは[トークン](https://support.pyn.ai/ja/flows/steps/reference-tokens/)を参照してください。

## HiBobが埋められるプロフィールのフィールド

最初の列は、Pynの従業員プロフィールでのフィールドのラベルです。各行はPynがBobから埋められるフィールドであって、すべてのプロフィールが持つフィールドではありません。Bobに値がないか、接続したアカウントがそれを見られないときフィールドは空のままで、代わりに別のソースが供給できます。BobのフィールドidはBobのAPIがそのフィールドに使う名前です。

| Pynのフィールド | Bobでのフィールド | Bobのフィールドid | 補足 |
| --- | --- | --- | --- |
| **Display Name** | Display name | `root.displayName` | Full name、次にFirst nameとLast nameにフォールバックします。 |
| **Legal Name** | Full name | `root.fullName` | First nameとLast name（`root.firstName`、`root.surname`）にフォールバックします。 |
| **Primary Email Address** | Email | `root.email` | メッセージの送り先となる勤務先アドレス。レコードの照合にも使います。 |
| **Personal Email Address** | Personal email | `home.privateEmail` | 勤務先アドレスのない入社予定者の照合に使います。 |
| **Job Title** | Job title | `work.title` | |
| **Department** | Department | `work.department` | Bobが表示する値で、リストのidではありません。 |
| **Location** | Site | `work.site` | Addressのcity（`address.city`）にフォールバックします。 |
| **Primary Country** | Country | `address.country` | 住所から。 |
| **Postal Code** | Postal code | `address.postalCode` | 住所から。 |
| **Time Zone** | なし | | 国と郵便番号から算出します。下を参照してください。 |
| **Birthday** | Date of birth | `personal.shortBirthDate` | 日と月のみ。 |
| **Start Date** | Start date | `work.startDate` | |
| **Tenure Date** | Original start date、なければStart date | `work.originalStartDate`、`work.startDate` | BobにOriginal start dateがあればそこから数え、なければ**Start Date**と同じです。 |
| **Termination Date** | Termination date | `internal.terminationDate` | |
| **Probation End Date** | Probation end date | `internal.probationEndDate` | |
| **Original Start Date in HiBob** | Original start date | `work.originalStartDate` | HiBob専用のプロパティです。**Tenure Date**の元になります。 |
| **Active status** | Lifecycle status、次にStatus | `internal.lifecycleStatus`、`internal.status` | 「leave」を含むLifecycle statusは**On Leave**です。それ以外では、StatusがActiveまたは空なら**Active**、それ以外は**Inactive**です。 |
| **Manager** | Reports to | `work.reportsTo` | マネージャーのBobレコードと照合します。下の[マネージャー](#マネージャー)を参照してください。 |
| **HRBP** | HRBP | `employee.hrbp` | HRBPのBobレコードと照合します。 |
| **Buddy** | あなたのバディ用フィールド | カスタムフィールド | Bobに標準のバディフィールドはありません。どのカスタムフィールドが保持するかはPynサポートが設定します。 |
| カスタムフィールド | あなたが選ぶフィールド | 任意のフィールドid | テキスト、はい/いいえ、日付、または数値として読み取ります。Pynサポートがそれぞれをマッピングします。 |

PynがBobから読み取らないもの：**Preferred Name**、**Avatar Image**、**Secondary Email Address**、**Employment Type**、**Business Unit**、**Division**、**Team**、**Mentor**。Bobの雇用形態や契約のフィールドは**Employment Type**にマッピングされません。代わりにPynサポートがどちらかをカスタムフィールドとしてマッピングできます。「Manager ID」フィールドのようなBobのほかのカスタムフィールドは、マッピングされない限り無視されます。

### マネージャー

Pynは**Reports to**の中のidを取り、そのidを持つBobの従業員を見つけます。Bobがidを返さないときは、Bobでのマネージャーの**Employee ID**（`work.reportsToIdInCompany`）を使い、同じBobの会社でその**Employee ID**（`work.employeeIdInCompany`）を持つ人と照合します。マネージャーも同期に含まれている必要があるので、接続したBobアカウントにはその人のレコードへの閲覧アクセスが必要です。

### タイムゾーン

PynはBobからタイムゾーンを読み取りません。**Primary Country**と**Postal Code**から算出します。米国、カナダ、オーストラリアでは郵便番号から、タイムゾーンが1つの国では国だけから決めます。タイムゾーンが複数あるほかの国では、その人にSlackのタイムゾーンがあればそれを使います。なければ**Time Zone**は空のままで、受信者のタイムゾーンでスケジュールされたステップは代わりにワークスペースのタイムゾーンで送られます。

## 同期の動き方

Bobでの変更は、約1時間以内にPynに届き、次に送られるメッセージのトークンに反映されます。Bobで何も変わらなかった実行は、**History**に「Successfully integrated to HiBob. No employee changes found」として記録されます。PynはBobから読み取るだけで、書き戻すことはありません。

退職者は同期に残るので、退職日が届きます。Bobの結果から消えた人は**Removed**と印が付き、**Terminated**になります。

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

| 表示されるもの | 確認すること |
| --- | --- |
| トークンが「Manager」や「department」などのフォールバックを表示する | その背後のプロフィールのフィールドが空です。[従業員](https://support.pyn.ai/ja/directory/employees/)でその人を開いてフィールドを確認し、次に下の行を確認します。接続されたほかのソースも一部のフィールドを埋められます。プロフィールの**Sources**タブには、その人の背後にあるすべてのレコードが一覧表示されます。 |
| Bobでは入力されているのにPynでは空 | **Installed**でHiBob連携を開き、**Advanced**を選びます。**Fields in Report**にBobが返したものと何人分かが一覧表示されます。フィールドがないなら、サービスユーザーの権限グループ、または**Connect with HiBob**でサインインした場合はあなた自身のアカウントが、それを見られません。Bobはそのようなフィールドをエラーなしで省きます。 |
| **Manager**が空 | Bobで**Reports to**が空か、権限グループがそれを見られないか、マネージャーがサービスユーザーに見えません。マネージャーidを保持するカスタムフィールドは読み取られません。 |
| **Location**に市区町村が表示される | その人にBobでのSiteがないので、Pynが住所の市区町村を使いました。 |
| Bobのカスタムフィールドがない | カスタムフィールドはPynサポートがマッピングして初めて読み取られます。 |
| Bobでの変更が届いていない | 次の1時間ごとの更新を待ち、連携の**History**を確認します。 |

## 関連ページ

- [トークン](https://support.pyn.ai/ja/flows/steps/reference-tokens/)：すべてのトークン、そのフォールバック、書式についてです。
- [HiBob](https://support.pyn.ai/ja/integrations/hibob/)：Bobを接続し、Pynに必要な権限を付与するにはこちらです。
- [HRISフィールド](https://support.pyn.ai/ja/integrations/hris-fields/)：HiBobをほかのソースと比較するにはこちらです。
- [従業員プロパティ](https://support.pyn.ai/ja/directory/employees/reference-employee-properties/)：Pynのすべてのフィールドについてです。
- [マネージャー、タイムゾーン、メールアドレスの抜けを直す](https://support.pyn.ai/ja/directory/employees/fix-missing-details/)：値を正すにはこちらです。
