目次
概要
このガイドでは、zoobaとGoogle Workspace、Microsoft Entra ID、Okta、SmartHRとの間でメンバー情報を連携する際の仕様について解説します。メンバー情報の同期において、どのシステムの情報が優先されるのか、どのように情報が更新されるのかを理解するためのリファレンスとしてご活用ください。
メンバー情報連携の基本原則
メンバー情報の連携には、主に以下の2つのケースがあります：
1. 新規メンバー作成時：zoobaシステム内に該当メンバーが存在しない場合
2. 既存メンバー更新時：zoobaシステム内に既に該当メンバーが存在する場合
・連携元が同じ場合（例：初回GWS→今回もGWS）
・連携元が異なる場合（例：初回zooba→今回はGWS）
（補足：手入力・CSVでメンバー情報を追加した場合は、連携元がzoobaになります）
メンバーの識別は主に以下の方法で行われます：
・メールアドレス
・連携先のID(内部値)
・従業員ID
メンバー情報は2つのアプリケーションから連携することができます：
※最大2つまでの連携が可能です。
※主連携先で選ばれたアプリケーションに存在しないメンバーの情報を補助連携先アプリケーションから取得するという仕様となっています。
Google Workspace (GWS) との連携
新規メンバー作成時
| zooba上での表記 | 取得内容 |
|---|---|
| メールアドレス | プライマリメールアドレス(primaryEmail) |
| その他メールアドレス | リカバリーメールアドレス(recoveryEmail) |
| 氏名 | フルネーム(fullName) |
| 表示名 | 表示名(displayName) |
| 姓 | 姓(familyName) |
| 名 | 名(givenName) |
| 連携元 | |
| 従業員ID | 外部ID(externalIds)から取得 |
| 役職 | 組織情報(organizations)のタイトル(title) |
| 所属部署 | 組織情報(organizations)の部門(department) |
既存メンバー更新時
連携元がGWSの場合
| zooba上での表記 | 更新ルール |
|---|---|
| メールアドレス | 変更されている場合は、古いメールアドレスがその他メールアドレスに追加される |
| 氏名 | zooba優先（値がない場合のみGWSの情報で更新） |
| 表示名 | zooba優先（値がない場合のみGWSの情報で更新） |
| 姓 | zooba優先（値がない場合のみGWSの情報で更新） |
| 名 | zooba優先（値がない場合のみGWSの情報で更新） |
| 従業員ID | zooba優先（値がない場合のみGWSの情報で更新） |
| 役職 | GWS優先 |
| 所属部署 | zooba優先（値がない場合のみGWSの情報で更新） |
連携元がGWS以外の場合
| zooba上での表記 | 更新ルール |
|---|---|
| 連携元 | GWSに変更される |
| メールアドレス | 基本的に維持されるが、GWSからの情報と異なる場合は、その他メールアドレスに追加される |
| その他メールアドレス | 更新対象のメンバーとGWSのメールアドレスが異なる場合に、GWSのメールアドレスが追加される |
| 氏名 | zooba優先（値がない場合のみGWSの情報で更新） |
| 表示名 | zooba優先（値がない場合のみGWSの情報で更新） |
| 姓 | zooba優先（値がない場合のみGWSの情報で更新） |
| 名 | zooba優先（値がない場合のみGWSの情報で更新） |
| 従業員ID | zooba優先（値がない場合のみGWSの情報で更新） |
| 役職 | GWS優先 |
| 所属部署 | zooba優先（値がない場合のみGWSの情報で更新） |
Microsoft Entra ID との連携
新規メンバー作成時
| zooba上での表記 | 取得内容 |
|---|---|
| メールアドレス | ユーザーのメールアドレス |
| 氏名 | 表示名(displayName) |
| 表示名 | 表示名(displayName) |
| 姓 | 姓(surname) |
| 名 | 名(givenName) |
| その他メールアドレス | メイン以外のメールアドレス |
| 国 | 国(country) |
| 地域 | 市区町村(city) |
| 連携元 | Microsoft |
| 在籍状態 | employed（雇用中） |
| 従業員ID | employeeId |
| 企業名 | 会社名(companyName) |
| 役職 | 職位(jobTitle) |
| 所属部署 | 部門(department) |
| 雇用日 | 入社日(employeeHireDate) |
| 退職日 | 削除日時(deletedDateTime) |
既存メンバー更新時
連携元がEntraIDの場合
| zooba上での表記 | 更新ルール |
|---|---|
| メールアドレス | 変更されている場合は、EntraIDのアドレスがその他メールアドレスに追加される |
| 氏名 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 表示名 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 姓 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 名 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| その他メールアドレス | メイン以外のメールアドレス |
| 国 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 地域 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 在籍状態 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 従業員ID | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 企業名 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 役職 | 更新される |
| 部署 | 更新される |
| 雇用日 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 退職日 | zooba優先（値がない場合のみEntraIDの情報で更新） |
連携元がEntraID以外の場合
| zooba上での表記 | 更新ルール |
|---|---|
| 連携元 | EntraIDに変更される |
| メールアドレス | 基本的に維持されるが、EntraIDからの情報と異なる場合は、その他メールアドレスとして追加される |
| 氏名 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 表示名 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 姓 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 名 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| その他メールアドレス | 更新対象のメンバーとEntraIDのメールアドレスが異なる場合に、EntraIDのメールアドレスが追加される |
| 国 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 地域 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 在籍状態 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 従業員ID | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 企業名 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 役職 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 所属部署 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 雇用日 | zooba優先（値がない場合のみEntraIDの情報で更新） |
| 退職日 | zooba優先（値がない場合のみEntraIDの情報で更新） |
Okta との連携
新規メンバー作成時
| zooba上での表記 | 取得内容 |
|---|---|
| メールアドレス | メールアドレス(email) |
| その他メールアドレス | セカンダリメールアドレス(secondEmail) |
| 氏名 | OktaClientから取得した名前 |
| 表示名 | 表示名(displayName) |
| 姓 | 姓(lastName) |
| 名 | 名(firstName) |
| 連携元 | Okta |
| 従業員ID | 従業員番号(employeeNumber) |
| 役職 | 役職(title) |
| 所属部署 | 部門(department) |
| 地域 | 市区町村(city) |
| 国 | 国コード(countryCode) |
| 管理者ID | マネージャーID(managerId)から取得 |
既存メンバー更新時
連携元がOktaの場合
| zooba上での表記 | 更新ルール |
|---|---|
| メールアドレス | 変更されている場合は、Oktaのメールアドレスがその他メールアドレスに追加される |
| 氏名 | zooba優先（値がない場合のみOktaの情報で更新） |
| 表示名 | zooba優先（値がない場合のみOktaの情報で更新） |
| 姓 | zooba優先（値がない場合のみOktaの情報で更新） |
| 名 | zooba優先（値がない場合のみOktaの情報で更新） |
| 従業員ID | zooba優先（値がない場合のみOktaの情報で更新） |
| 役職 | zooba優先（値がない場合のみOktaの情報で更新） |
| 所属部署 | zooba優先（値がない場合のみOktaの情報で更新） |
| 地域 | zooba優先（値がない場合のみOktaの情報で更新） |
| 国 | zooba優先（値がない場合のみOktaの情報で更新） |
| 管理者ID | zooba優先（値がない場合のみOktaの情報で更新） |
連携元がOkta以外の場合
| zooba上での表記 | 更新ルール |
|---|---|
| 連携元 | Oktaに変更される |
| メールアドレス | 基本的に維持されるが、Oktaからの情報と異なる場合は、その他メールアドレスに追加される |
| その他メールアドレス | 更新対象のメンバーとOktaのメールアドレスが異なる場合に、Oktaのメールアドレスが追加される |
| 氏名 | zooba優先（値がない場合のみOktaの情報で更新） |
| 表示名 | zooba優先（値がない場合のみOktaの情報で更新） |
| 姓 | zooba優先（値がない場合のみOktaの情報で更新） |
| 名 | zooba優先（値がない場合のみOktaの情報で更新） |
| 従業員ID | zooba優先（値がない場合のみOktaの情報で更新） |
| 役職 | zooba優先（値がない場合のみOktaの情報で更新） |
| 所属部署 | zooba優先（値がない場合のみOktaの情報で更新） |
| 地域 | zooba優先（値がない場合のみOktaの情報で更新） |
| 国 | zooba優先（値がない場合のみOktaの情報で更新） |
| 管理者ID | zooba優先（値がない場合のみOktaの情報で更新） |
SmartHR との連携
新規メンバー作成時
| zooba上での表記 | 取得内容 |
|---|---|
| メールアドレス | メールアドレス(email) |
| 氏名 | 姓(last_name) + 名(first_name) |
| 氏名(かな) | 姓(かな)(last_name_yomi) + 名(かな)(first_name_yomi) |
| 姓 | 姓(last_name) |
| 名 | 名(first_name) |
| 姓(かな) | 姓(かな)(last_name_yomi) |
| 名(かな) | 名(かな)(first_name_yomi) |
| 連携元 | SmartHR |
| 在籍状態 | 雇用状態(emp_status)から取得 |
| 従業員ID | 社員コード(emp_code) |
| 雇用形態 | 雇用状態(emp_status)から取得 |
| 役職 | 役職(position) |
| 所属部署 | 部門(department) |
| 地域 | 住所(address)の市区町村(city) |
| 国 | 住所(address)から取得 |
| 雇用日 | 入社日(entered_at) |
| 退職日 | 退職日(resigned_at) |
| 契約開始日 | 契約開始日(contract_start_on) |
| 契約終了日 | 契約終了日(contract_end_on) |
既存メンバー更新時
連携元がSmartHRの場合
| zooba上での表記 | 更新ルール |
|---|---|
| 在籍状態 | 更新される |
| 部署 | 更新される |
| 雇用形態 | 更新される |
| 役職 | 更新される |
| 契約開始日 | 更新される |
| 契約終了日 | 更新される |
| 地域 | 更新される |
| 国 | 更新される |
| 退職日 | 更新される |
| 雇用日 | 更新される |
| メールアドレス | 変更されている場合は、古いメールアドレスがその他メールアドレスに追加される |
連携元がSmartHR以外の場合
| zooba上での表記 | 更新ルール |
|---|---|
| 連携元 | SmartHRに変更される |
| メールアドレス | 基本的に維持されるが、SmartHRからの情報と異なる場合は、その他メールアドレスに追加される |
| 氏名 | zooba優先（値がない場合のみSmartHRの情報で更新） |
| 氏名(かな) | zooba優先（値がない場合のみSmartHRの情報で更新） |
| 姓 | zooba優先（値がない場合のみSmartHRの情報で更新） |
| 名 | zooba優先（値がない場合のみSmartHRの情報で更新） |
| 姓(かな) | zooba優先（値がない場合のみSmartHRの情報で更新） |
| 名(かな) | zooba優先（値がない場合のみSmartHRの情報で更新） |
| 在籍状態 | SmartHR優先 |
| 従業員ID | zooba優先（値がない場合のみSmartHRの情報で更新） |
| 雇用形態 | SmartHR優先 |
| 役職 | SmartHR優先 |
| 部署 | SmartHR優先 |
| 地域 | SmartHR優先 |
| 国 | SmartHR優先 |
| 雇用日 | SmartHR優先 |
| 退職日 | SmartHR優先 |
| 契約開始日 | SmartHR優先 |
| 契約終了日 | SmartHR優先 |
メンバーマスターの人事属性情報をSmartHRから補完する方法
Google やEntraID、oktaを参照元にした際に、SmartHRの情報を使って人事属性情報を補完追加することが可能です。
詳細の設定方法は「メンバーマスターの人事属性情報をSmartHRから補完する方法」をご参照ください。
コメント
0件のコメント
サインインしてコメントを残してください。