HiBobのフィールドマッピング
メッセージ内のprincipal.preferredNameやprincipal.managerNameのようなトークンは、Pynの従業員プロフィールのフィールドを読み取ります。HiBobが接続されていると、PynはそのプロフィールのフィールドをBobから埋められます。フィールドに値があるかどうかは、あなたのBobテナントが何を持っているか、接続したBobアカウントが何を見られるか、ほかにどのソースが接続されているかで決まります。表を使って、トークンからBobで入力または修正すべきフィールドをたどってください。
トークンとその背後にあるBobのフィールド
Section titled “トークンとその背後にある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を読み取ります。すべてのトークンとそのフォールバックはトークンを参照してください。
HiBobが埋められるプロフィールのフィールド
Section titled “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 | 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のほかのカスタムフィールドは、マッピングされない限り無視されます。
マネージャー
Section titled “マネージャー”PynはReports toの中のidを取り、そのidを持つBobの従業員を見つけます。Bobがidを返さないときは、BobでのマネージャーのEmployee ID(work.reportsToIdInCompany)を使い、同じBobの会社でそのEmployee ID(work.employeeIdInCompany)を持つ人と照合します。マネージャーも同期に含まれている必要があるので、接続したBobアカウントにはその人のレコードへの閲覧アクセスが必要です。
タイムゾーン
Section titled “タイムゾーン”PynはBobからタイムゾーンを読み取りません。Primary CountryとPostal Codeから算出します。米国、カナダ、オーストラリアでは郵便番号から、タイムゾーンが1つの国では国だけから決めます。タイムゾーンが複数あるほかの国では、その人にSlackのタイムゾーンがあればそれを使います。なければTime Zoneは空のままで、受信者のタイムゾーンでスケジュールされたステップは代わりにワークスペースのタイムゾーンで送られます。
同期の動き方
Section titled “同期の動き方”Bobでの変更は、約1時間以内にPynに届き、次に送られるメッセージのトークンに反映されます。Bobで何も変わらなかった実行は、Historyに「Successfully integrated to HiBob. No employee changes found」として記録されます。PynはBobから読み取るだけで、書き戻すことはありません。
退職者は同期に残るので、退職日が届きます。Bobの結果から消えた人はRemovedと印が付き、Terminatedになります。
トラブルシューティング
Section titled “トラブルシューティング”| 表示されるもの | 確認すること |
|---|---|
| トークンが「Manager」や「department」などのフォールバックを表示する | その背後のプロフィールのフィールドが空です。従業員でその人を開いてフィールドを確認し、次に下の行を確認します。接続されたほかのソースも一部のフィールドを埋められます。プロフィールの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を確認します。 |
- トークン:すべてのトークン、そのフォールバック、書式についてです。
- HiBob:Bobを接続し、Pynに必要な権限を付与するにはこちらです。
- HRISフィールド:HiBobをほかのソースと比較するにはこちらです。
- 従業員プロパティ:Pynのすべてのフィールドについてです。
- マネージャー、タイムゾーン、メールアドレスの抜けを直す:値を正すにはこちらです。