メインコンテンツへスキップ

SmartHR - X-point Cloudマスター連携

  • 更新

本レシピはFreeプランにて無料でご利用いただけます。アカウント登録が完了されていない場合は下記よりご登録ください。

ActRecipe Freeプラン利用申込フォーム

 

SmartHR上の部署や役職のマスター情報をX-point Cloudへ連携する方法を解説します。
レシピを使用するには事前にSmartHRおよびX-point Cloudの利用契約が必要になります。
SmartHRの「労務管理プラン」「¥0プラン」ではご利用いただけません。

 

0.事前準備

  1. 「SmartHR - X-point Cloudマスター連携」レシピを使用するには、事前にSmartHR Plusでのアプリの登録が必要となります。
  2. 以下のSmartHR Plusにアクセスし、画面右上の「ログイン」ボタンよりSmartHRへログインします
    https://www.smarthr.plus/apps/actrecipe
  3. 続いて「連携をはじめる」ボタン(青色)をクリックします
  4. アプリのインストール確認画面にて「連携をはじめる」ボタンをクリックします
  5. アプリの連携が完了しますと上記「2」のボタンが「アプリを開く」に変わりますので、同ボタンをクリックします
  6. 以下の確認画面が表示されますので「連携を許可」をクリックします(※)

連携するユーザはSmartHRの「管理者」権限を保持している必要があります。

 

SmartHR_Plus_ActRecipe.png

 

※ 
ActRecipeのアカウントを保持しておりActRecipeにログインしていない場合にはログインをしてください。
ActRecipeのアカウントが未作成の場合は「無料ではじめる」ボタンよりアカウントを作成し、通知メールに従ってください。

 

1.マイレシピへの登録

メニューの「シェアレシピ」から、「SmartHR - X-point Cloudマスター連携」にチェックを入れ、画面下にある登録ボタンを押下します。


続いて「マイレシピ」から、レシピ名をクリックするか操作メニューより「編集」を選択します。
参考：シェアレシピ・マイレシピとはなんですか？

 

ヘッダーでは、レシピ名とレシピ説明を変更することができます。
参考：レシピヘッダーでは何を設定すれば良いですか？

 

2.SmartHRの認証情報設定

「SmartHR マスター情報取得」を押下し、設定を展開します。

本タスクでは、以下の設定を行います。

  • サブドメイン (自動入力)：SmartHRとの連携ができていれば自動的にサブドメイン名がセットされます。
  • 取得マスター
    • 部署：SmartHR上の部署マスターを取得します。データを取得するには部署コードの設定が必須です。
    • 役職：SmartHR上の役職マスターを取得します。データを取得するには役職コードの設定が必須です。
      「部署」と「役職」の異なるマスターを1つのレシピで切り替えて連携することはできません。「部署連携用レシピ」「役職連携用レシピ」のように用途毎に分けてご利用ください。

SmartHRとのOAuth接続を切断する場合は「テナントの変更・解除」をクリックし、続いて「接続解除」をクリックします。

 

3.X-pointの接続設定

「X-point Cloudマスター情報連携」を押下し、設定を展開します。
本タスクでは、以下の項目を設定します。

  • X-point Cloudアクセストークン：X-point Cloudの「X-point アクセストークン」を入力します。（「APIトークン」ではありません）
  • X-point Cloudサブドメイン：X-point Cloudのサブドメインを入力します。例えば「https://xxxx.atledcloud.jp/」の場合は「xxxx」のみを入力します。
  • ドメインコード：X-point Cloudのドメインコードを入力します。
  • 既存データを更新する（オプション）：デフォルトでは新たに作成された部署や役職のみを更新します。SmartHR上の部署名や役職名が変更になった場合等でX-point Cloud上の既存データを更新が必要な際にはチェックを付けます。

レシピを実行する (自動実行はこちら)

マイレシピの操作メニューより「実行」を選択することでレシピを実行できます。
画面イメージや履歴の確認方法は以下をご参照ください。

参考：レシピを実行するにはどうすれば良いですか？

 

レシピの実行に成功すると、SmartHR上のマスターデータがX-point Cloudへ連携されます。
マスターが登録・更新されると下記のフォーマットで実行ログに記録されます。
[名称:コード]

また、登録・更新ができないレコードは不足情報が記録されます。

 

【注意事項】SmartHR - X-point Cloudマスター連携で取得可能なマスター情報の取扱いについて

  •  取得できる従業員の範囲・項目は、設定時に利用したSmartHRのアカウントの権限設定を反映します。目的と用途に応じた権限のSmartHRのアカウントを使って設定を行なってください。
    詳しくは、*従業員関連の閲覧・作成・更新・削除の権限を設定する* を参照してください。
    https://support.smarthr.jp/ja/help/articles/1500001368101/

 

FAQ

Q.「SmartHR Plus上でActRecipeのアプリをインストールしてレシピを再実行してください。」と表示されますがどのようにすれば良いですか？
A.何らかの原因でSmartHR Plusの接続が切断されてしまった場合に表示されるメッセージです。以下の手順でSmartHR Plusとの再接続をお願いします。
・SmartHR Plusへアクセスし、アプリをアンインストールします。操作方法はこちら。
・続いてアプリの「追加」および「許可」をクリックしてください。操作方法はこちら。

 

Freeプランについて
このレシピはActRecipeのFreeプランでご利用いただけます。Freeプランの制約事項や有償プランへの移行は下記をご覧ください。

 

このレシピで連携できるSaaSについて

 

その他のSmartHR連携ができるレシピ

 

関連記事