クラウド人事労務ソフトSmartHRのデータをCData SyncでSQL Serverに複製する方法

by 菅原和義 | 2021年08月24日

f:id:sugawarakazu:20210821180922j:plain

こんにちは。CData Software Japanテクニカルサポートエンジニアの菅原です。

クラウド人事労務ソフトで有名なSmartHRを導入している会社の方は多いのではないでしょうか。従業員データをSmartHRで一元管理していて、自社内でのカスタムアプリ（業務アプリケーション）でもSmartHRのデータを使いたいと思ったことありませんか。使いたいけどダブルメンテはNGだったり、手動でCSV等で出力して移行するとなると意外と手間がかかりますよね。

そこで今回はSmartHRに対応したCData Syncを使って、SQL Serverへ複製する方法を紹介します。

CData Syncは、クラウド/ SaaSのデータをノンコーディングで直感的にDBにレプリケーション（複製）できるツールです。

SmartHRとは？
手順（SmartHR ⇒ CData Sync ⇒ SQL Server）
ジョブのスケジュール設定
終わりに

SmartHRとは？

雇用契約や入社手続きがペーパーレスで完結できるクラウドベースの労務管理サービスです。

https://smarthr.jp/

f:id:sugawarakazu:20210821181409j:plain

外部サービスと連携するためのAPIも充実しており、従業員情報から、部署・役職・事業所といった各種マスタデータまで幅広いデータの取得・登録・更新が可能です。

https://developer.smarthr.jp/api/index.html

f:id:sugawarakazu:20210821182328j:plain

CData Sync およびAPI Profile で対応しているSmartHR のAPI オブジェクトは以下の通りです。

Name	対応API
BankAccountSettings	口座情報
BizEstablishments	事務所
CrewCustomFieldTemplateGroups	従業員カスタム項目グループ
CrewCustomFieldTemplates	従業員カスタム項目テンプレート
CrewInputForms	従業員情報収集フォーム
Crews	従業員
CrewsBankAccounts	従業員_口座情報
CrewsCustomFields	従業員_カスタム項目
CrewsDepartments	従業員_部署
CrewsProfileImages	従業員_プロフィール画像
Departments	部署
DependentRelations	続柄
Dependents	家族情報
EmploymentTypes	雇用形態
JobTitles	役職
MailFormats	メールフォーマット
PaymentPeriods	給与支給形態
Users	ユーザ

今回はこのAPIを利用して、CData Syncから従業員情報の取得を行ってみたいと思います。

手順（SmartHR ⇒ CData Sync ⇒ SQL Server）

それでは実際にSmartHRのデータをSQL Serverに複製する方法を説明します。

SmartHRのアプリケーション連携の設定

まずはSmartHRのアプリケーション連携の設定を行います。

f:id:sugawarakazu:20210821193516j:plain

SmartHRの画面にアクセスして、右上のユーザー＞「共通設定」をクリック

f:id:sugawarakazu:20210821193806j:plain

メニュー一覧の「アプリケーション連携」をクリック

f:id:sugawarakazu:20210821194301j:plain

APIを使用するので「アクセストークン」をクリック

f:id:sugawarakazu:20210821194505j:plain

「新規発行」をクリック

f:id:sugawarakazu:20210821194728j:plain

各リソースの参照・更新の制限を設定して「登録」をクリック

f:id:sugawarakazu:20210821194941j:plain

登録されたアクセストークンが後ほど必要となるため、アクセストークンをメモしておいてください。忘れると再度、新規発行を行うことになります。

これでSmartHRの設定は終わりです。

CData Syncの設定

次にCData Syncの設定を行います。CData Syncを起動します。

データソースにSmartHRを設定

f:id:sugawarakazu:20210812161045j:plain

「接続」タブの「接続の追加」-「データソース」タブの「Add More」をクリック

f:id:sugawarakazu:20210812161728j:plain

コネクタをダウンロード画面で「SmartHR」を検索

f:id:sugawarakazu:20210821201711j:plain

「SmartHR」をクリック

f:id:sugawarakazu:20210821201829j:plain

「ダウンロード＆インストール」をクリック

f:id:sugawarakazu:20210821202254j:plain

インストールが完了するとデータソースに「SmartHR Profile」が表示されます。「SmartHR Profile」をクリック

f:id:sugawarakazu:20210822121517j:plain

名前：任意
プロバイダークラス：System.Data.CDAta.API
フォーマット設定：プロパティリスト
Profile Settings：（入力例）UseSandbox=False;APIKey=XXXXXXXXXXXXXX;TenantId=YYYYYYYYYYYYYYYYYY;
- UseSandbox=False　Sandbox環境に接続したい場合はTrueにしてください。
- APIKey=SmartHRのアクセストークン
- TenantId=SmartHRのTenantId ※TenantIdはSmartHRのURLの青文字部分です。「https://YYYYYYYYYYYYYYYYYY.smarthr.jp/」