本レシピはStandardプラン以上の有償プランでご利用いただけます。ご利用をご希望の場合は下記よりお問い合わせください。

お問い合わせ | ActRecipe

SmartHRのWebhookを利用して、従業員情報の項目の値が更新等されたら、別の項目にもその値をアップデートするレシピの設定方法を解説します。
レシピを使用するには事前にSmartHRの利用契約が必要になります。

■はじめに

ActRecipeではSmartHRを便利に活用する様々な機能をご提供しております。
主な特徴を動画にまとめておりますのでご覧ください。

0.事前準備

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

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

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

1.マイレシピへの登録

メニューの「シェアレシピ」から、「SmartHRデータアップデート」にチェックを入れ、画面下にある登録ボタンを押下します。シェアレシピの画面に「SmartHRデータアップデート」が表示されない場合はSmartHR Plusの画面からやり直してください。

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

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

2.SmartHR連携設定

「SmartHR 認証」を押下し、設定を展開します。

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

サブドメイン（自動入力）：SmartHRにとの連携ができていれば自動的にサブドメイン名がセットされます。
家族情報を含める（オプション）：事前にActRecipe内のデータベースにSmartHRのデータを保存する必要があります。家族情報を連携したい場合にはチェックを付けます。
従業員情報を取得する：ボタンを押下するとSmartHRから従業員情報が取得され、ActRecipeの内部データベースに保存されます。この処理には数十分かかることがあります。
SMARTHR WEBHOOK URLを生成：SmartHRからデータ取得が完了するとWebhook URLの生成が可能となります。
SmartHR Webhook URL：生成したURLは以下のページより設定します。
　https://[お客様ドメイン].smarthr.jp/admin/webhooks
　SmartHRのWebhook設定は下記ページをご確認ください。
　https://support.smarthr.jp/ja/help/articles/5260914962073/
シークレットトークン（オプション）：SmartHR上で指定したシークレットトークンを設定することができます。本レシピでの設定は表です。
対象項目：任意の項目の更新等にのみレシピを実行させる場合にご利用できます。
任意のSmartHR上の項目名をカンマ区切りで入力します。例えば、住所項目の更新だけをトリガーにしたいような場合には以下のように設定します。（Webhookのトリガーを「従業員の更新」に設定済み）
【　現住所（郵便番号）,現住所（都道府県）,現住所（市区町村）,現住所（丁目・番地）,現住所（建物名・部屋番号）】
「対象項目」の値が更新された場合にタスク2のデータコンバートを実行します。
本項目がブランクの場合は、どの項目更新においても、レシピ実行のトリガーとなります。
項目名については以下を参照ください。
SmartHR - エクスポート用JSONファイル(論理名)v1.4
SmartHR - エクスポート用JSONファイル(家族情報-論理名)v1.0