コンテンツにスキップ
PynPyn

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 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」などのフォールバックを表示する その背後のプロフィールのフィールドが空です。従業員でその人を開いてフィールドを確認し、次に下の行を確認します。接続されたほかのソースも一部のフィールドを埋められます。プロフィールの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を確認します。