HULFT SquareとSmartHRを接続してみた
１．記事の概要
１－１. はじめに
HULFT Squareとは、日本発のiPaaS（クラウド型データ連携プラットフォーム）です。
詳しい特徴や機能については、以下のURLをご参照ください。
公式製品ページ：https://www.hulft.com/service/hulft-square
１－２. 記事の目的
このページ内を読了すると、HULFT SquareとSmartHRの接続準備ができるようになります。
２. SmartHRでの設定
２－１. アクセストークンを作成する
HULFT SquareとSmartHRを接続するために、まずSmartHR側の設定からしていきましょう。
SmartHRにログインし、アクセストークンを作成します。
【作成手順】
１．API連携 ＞ [アクセストークン] を押下
２．[新規発行] を押下
３．アクセストークン名に任意の名前を入力。ここでは「HULFT SQUARE連携」とする。
４．アクセストークンをメモする
アクセストークンが発行されたら、必ずメモし保存しておく。
SmartHRでの設定は以上になります。
３. HULFT Squareでの設定
３－１. コネクションを設定する
１．[新規作成] を押下
２．コネクターから [REST] を選び、[次へ] を押下
３．名前を任意で設定。ここでは [SmartHR接続] と入力
４．URLを入力し、接続テストを実行
URLは、以下のようになります。テナントIDは、SmartHRにログインした際のURLから取得します。
URL：https//[テナントID].smarthr.jp/
５．事前に作成したIntegrateサービス、リソース読み込みのためのプロファイルを選択
プロファイルの作成方法は別途、以下の記事をご参照ください。
６．接続テスト成功後、[OK] を押下
３－２. プロジェクトを作成する
１．[プロジェクトを作成] を押下
２．任意の名前を設定。ここでは「SmatHR_connect」とする。
３．[完了] を押下
３－３. プロジェクトを開く
１．プロジェクトを開く
２．プロファイル、Integrateサービスを選択し、[デザイナーを起動]を押下
３．[HULFTSquareDesignerを開く] を押下
これで事前準備は終了です。
4. SmartHRからデータを出力する
4－１. GET処理を追加する
１．GET処理を追加する
4－２. コンポーネント内の設定をする
【必須設定】
接続先：SmartHR接続（先ほど作成したもの）
パス：/api/v1/crews/[id]
※[id]には取得したい従業員情報のidを入力します。全件取得したい場合は割愛します。
エンコード：UTF-8
【レスポンス設定】
データ出力先：ファイル
ファイルパス：出力したいファイルパスを記入
【ヘッダ設定】
追加からリクエストヘッダを追加し、名前に「Content-Type」値に「application/json」と記入
認証：ベーシック認証
ユーザ：取得したアクセストークン
パスワード：空欄
4－３. コンポーネントを繋ぐ
4－４. 実行する
１．実行ボタンを押下
２．指定したファイルパスに以下のようにファイルが作成されることが確認できます。
５. SmartHRにデータを入力する
５－１. csvファイルを用意する
SmartHRに登録したい内容のcsvファイルを用意します。
５－２. 作成したcsvファイルを格納する
５－３. スクリプトを作成する
１．CSVファイル読み取り処理のコンポーネントを用意する
【必須設定】
ファイル：先ほどストレージに配置したファイルを参照
列名：先ほどのファイルのヘッダーと同じものを用意します
２．読み取った情報をJSON型に成型する
３．JSON型に成形完了
５－４. POSTのコンポーネントを追加する
【必須設定】
名前：任意の名前
接続先：SmartHR接続
パス：/v1/crews
【リクエスト設定】
データ入力先：ファイル
ファイルパス：成型したJSONファイルを置いたファイルパスを参照
５－５. スクリプトを実行する
実行結果
■おわりに
今回の記事ではHULFT SquareとSmartHRの接続について、データの出力と入力の方法をご紹介いたしました。
HULFT Squareにはまだまだたくさんの機能が存在していますので、今回の記事を足掛かりに様々な方法を試していただければと思います。
いかがだったでしょうか？
他にも、様々なケースの対処法を紹介していますので、是非目を通してみてください。
＜免責事項＞
情報の掲載には注意を払っておりますが、掲載された情報の内容の正確性については一切保証しません。また、当サイトに掲載された情報を利用・使用（閲覧、投稿、外部での再利用など全てを含む）するなどの行為に関連して生じたあらゆる損害等につきましても、理由の如何に関わらず自己責任で行う必要があります。
テクバンでは、お客様の業務にある困りごとをETLやBIをはじめ様々なテクノロジーで解決するためのご相談をお受けしております。「HULFT Square」もあわせてご覧下さい。HULFT Squareでデータ分析基盤を構築し、様々な経営判断の材料を可視化していくサービスなども提供してまいります。
“HULFT SquareとSmartHRを接続してみた” に対して1件のコメントがあります。
コメントは受け付けていません。