複数のマスタ連携を行い、ユーザー台帳を作成する（マルチソース連携）

概要

Josysでは、ユーザー台帳を外部SaaSツールをもとに作成することができます。
参考：外部システムと連携（マスタ連携）し、ユーザー台帳を作成する

その際、Josysではサポートマスタを有効化することで、一部の項目をサポートマスタ側の情報から取得するといったことが可能です。サポートマスタを有効化することで、メインで利用しているプライマリマスタ側には保持していない項目をサポートマスタ側でカバーすることができます。

本ページでは、複数のマスタソースを利用してユーザー台帳を作成する方法を記載しています。

想定読者

IT管理者

できること

1. 複数データソースからの情報統合: IdP（Identity Provider）とHRMS（Human Resource Management System）など、複数のシステムからユーザー情報を取得し、一元管理できます
2. ユーザー情報の完全性向上: 基本的なアカウント情報（メールアドレス、氏名）に加えて、人事情報（部署、役職、従業員番号、入社日等）を統合することで、より正確で包括的なユーザープロフィールを構築できます
3. 柔軟な属性マッピング: 各データソースの異なる属性名を、Josysの標準属性やカスタムフィールドに柔軟にマッピングできます

プライマリソースの役割

プライマリソースは、Josysにおけるユーザー管理の基準となる必須のデータソースです。下記3点の役割を担っています。

1. ユーザーの作成: プライマリソースに新しいユーザーが追加されると、Josysにも自動的にユーザーが作成されます。
2. ユーザーの削除: プライマリソースからユーザーが削除されると、Josysからも削除されます。（または無効化されます）
3. 基本情報の提供: メールアドレス、氏名、ステータス等の基本的なアカウント情報を提供します。

サポートソースの役割

サポートソースは、既に存在するユーザーに対して追加属性を提供するデータソースです。下記3点の役割を担っています。
※サポートソースからユーザーが作成されることはありません。あくまでも、プライマリソースのユーザー情報に追記をする役割です。

1. 追加属性の提供: 部署、役職、従業員番号、入社日、勤務地等の人事情報や追加のビジネス情報を提供します。
2. 属性の拡充: プライマリソースで管理されていない情報を補完し、ユーザープロフィールをより充実させます。
3. 複数ソースの利用: 必要に応じて複数のサポートソースを追加できます。（例：SmartHRから人事情報、Kaonaviからタレント情報）

データの統合方法

複数のEDSから取得したデータは、以下のロジックで統合されます：

1. NULL値の上書き防止
   サポートソースがわの情報が空欄の場合、既存の値は上書きされません。
   ＜例＞
   現在のJosysの値: 部署 = "Engineering"
   サポートソース（SmartHR）: 部署 = 入力なし
   →この場合、既存の "Engineering" がそのまま保持されます。
2. 属性の追加と補完
   サポートソースは、プライマリソースに存在しない属性を新たに追加できます。
   結果として、Josysのユーザープロフィールには全ての属性が統合されます。
   
   例:プライマリソース（Entra ID）: メールアドレス, 氏名
   サポートソース（SmartHR）: 従業員番号, 入社日, 役職, ステータス

サポート対象のデータソース

ユーザー台帳のマルチソース連携ではマスタ連携として利用可能なソースをご利用いただけます。

取得できる情報

サポートステータスとは

プライマリソース側とのステータス不一致を認識するために取得しています。
例えば、メインソース側で”在籍中”だが、サポートソース側で”退職済”になっている等のように、それぞれでステータスが一致していない　場合に気づけるようになっています。その場合は、ステータス列の横に赤色のビックリマークのアイコンが付きます。

従業員番号をサポートソースから取得する機能

メインソースに従業員番号が登録されていない場合、サポートソース側から従業員番号を補うことが可能な機能です。
例えば、Google Workspaceをメインソースとしており、サポートソースをSmartHRにした場合、本機能が適用化されていればSmartHR側の従業員番号をGoogle Workspaceから連携されてきたユーザーに付与することができるようになります。

本機能はご依頼いただいたお客様に対して適用しております。適用したい場合は弊社の担当までご連絡ください。

制限事項・注意点

1. プライマリソースは1つのみ: 組織ごとにプライマリソースは1つのみ設定可能です。
   複数のプライマリソースを同時に利用することはできません。
    
2. ユーザーの作成/削除はプライマリーに依存: ユーザーの新規作成や削除は、プライマリソースの変更に基づいてのみ実行されます。サポートソースのみの変更では、ユーザーは作成/削除されません。
    
3. アプリ連携にエラーがあると同期が失敗する：プライマリ・サポートソースにアプリ連携のエラーがあると同期が失敗する場合があります。
    
4. プライマリソースとサポートソースの間で、同一人物かどうかを識別するためのキーはメールアドレスのみです。
   プライマリソース側サポートソース側のメールアドレスが一致しない場合、データのマージは行われず、そのサポートソースのデータはJosysのユーザー台帳に連携されません。
    
5. サポートソースにマッピングされた項目は、ジョーシス側にすでに値が存在している場合でも、
   同期のたびにサポートソース側の最新の値で常に上書き（更新）されます。

連携手順

1. 左メニューから 連携＞マスタ連携 をクリックします。
2. マスタ連携を未実施の場合は、プライマリソースを選択のうえ、マスタ連携を行ってください。
   参考：外部システムと連携（マスタ連携）し、ユーザー台帳を作成する
3. 右上にある「サポートマスタを有効にする」ボタンをクリックします。
   
4. ウィンドウが開くので、上部にある「サポートソースを有効化」のトグルをクリックしてON切り替えます。
   
5. 有効化すると右側にプルダウンが表示されるため、サポートソースとして利用したいアプリを選択してください。
   
   ⚠️先に対象ソースと、Josysのアプリ連携が必要です。
6. サポートソースを選択すると、プライマリソースから取得されないフィールドへ自動でマッピングが追加されます。 
   また、複数のソースが利用可能なフィールドについてはプルダウンから利用するソースを選択できるようになります
   
   💡氏名やEメールアドレスなど一部の項目はプライマリソースに紐づけられます。
7. サポートソースを追加したあとは日次の自動同期の際にデータの更新が行われます。
   即時で反映したい場合は、マスタ連携の同期を実施してください。
   参考：マスタ連携後のデータ同期タイミングについて

💡ステータスについて
ステータス欄は、プライマリソースと、サポートソースの2つがマッピングされます。二つのソースからステータスを取得することで、それぞれのマスタで異なるステータスが設定されていた場合にステータスの不一致アラートが表示されるようになります。

サポートソースの部署が反映されない事象の解消方法について

1.セカンダリソースの一時無効化

1. 左サイドバーの「連携」＞「マスタ連携」をクリックします。
2. 画面右上の「サポートマスタを有効にする」をクリックし、項目のマッピングの設定画面を開きます。
3. 画面上部の「サポートソースを有効化」のトグルスイッチを一度OFFにします。

2.プライマリソースの項目有効化

1. 表示されたプライマリソースの項目一覧から、「部署」のチェックボックスにチェックを入れます。
2. 「変更を保存」ボタンをクリックします。

3.セカンダリソースの再設定

1. 再度「サポートソースを有効化」のトグルスイッチをONにします。
2. プルダウンメニューから、利用するサポートソースを再選択します。

4.項目のマッピング確認と保存

1. サポートソースの項目設定にて、「部署」にチェックが入っていることを確認します。
2. 確認後、再度「変更を保存」ボタンをクリックしてください。
3. 設定保存後、次回の同期サイクル、または手動同期完了後に、サポートソース側の部署情報がJosysのユーザー一覧に正しく反映されます。

よくある質問

• Q. プライマリソースとサポートソースの違いは何ですか？

  A. プライマリソースは、ユーザーの作成/削除の基準となる必須のデータソースです。ユーザーのライフサイクル（入社/退社）はプライマリソースに依存します。サポートソースは、既存ユーザーに対して追加属性を提供するデータソースです。サポートソース単独では、ユーザーの作成や削除は行われません。

• Q. NULL値が既存値を上書きしてしまいますか？

  A. いいえ、NULL値の上書き防止機能により既存値は保護されます。サポートソースから提供される値がNULLの場合、既存の有効な値はそのまま保持されます。これにより、データの欠損によって重要な情報が失われることを防ぎます。

• Q. サポートソースは何個まで追加できますか？

  A. 技術的な制限は設けていませんが、パフォーマンスと管理の観点から、2〜3個程度を推奨します。多数のサポートソースを追加すると、同期時間が長くなる可能性があります。具体的な上限については、管理画面または担当のアカウントコンサルタントにご確認ください。

• Q. プライマリソースを後から変更することはできますか？

  A. プライマリソースの変更は、ユーザーデータの整合性に大きな影響を与えるため、慎重な計画が必要です。変更を実行される際にはユーザープロファイルのエクスポートを行うなどバックアップを取得するようお願いいたします。

• Q. サポートソースのユーザーがプライマリソースに存在しない場合、どうなりますか？

  A. サポートソースのユーザーは、プライマリソースに対応するユーザーが存在する場合のみ属性が統合されます。プライマリーに存在しないユーザーの情報は無視されます。これにより、退職済みの従業員情報等が誤って反映されることを防ぎます。

• Q. 従業員番号を人事ツールで管理しています。これらをサポートソースから同期することはできませんか？

  A. ご依頼いただいたお客様にのみ機能を提供しています。
  サポートソースから従業員番号をJosysに同期したい場合は担当までご連絡ください。