個人開発でSmartHRと連携したレポーティングツールを作成してみました。
simple-hr-reporter.saikicks.net
概要
このツールはSmartHRと連携してAPI経由でデータを取得して可視化を行うためのレポーティングツールです。
SmartHRではフリープラン、労務管理プランでは分析レポートの利用が有料プランに切り替えるなどの対応を行わないと利用できません。
オプション機能として提供されていますが、そこまで細かく分析するほどでは無く現状の人事情報を可視化したい、みたいな緩い使い方でも許容できるユーザーさんを対象に簡易的なグラフ出力を提供します。
利用にはテナントIDとアクセストークンを利用しますが、サイト内にも記載がある通りこのツールはテナントIDやアクセストークンを保存したりはしません。データ取得時のみに利用します。
そのため画面をリロードしたりするともちろん情報は失われます。
再度表示したい場合は都度テナントID、アクセストークンはをもう一度入力していただく手間はありますが…
技術構成
- React
- rebass
- styled-component
- recharts
- TypeScript
- Vite
- Vitest
- CloudFlare Pages
- Axios
レポート出力結果
出力結果は以下のような感じでシンプルに出力しています。
もしご興味あれば是非使ってみてください。
次にテナントIDとアクセストークンについて簡単に説明します。
テナントIDについて
テナントIDはSmartHRのURLに含まれている以下の部分の文字列です。
https://[テナントID].smarthr.jp/
アクセストークンについて
アクセストークンは管理画面より作成を行うため以下に手順を載せておきます。
SmartHRにログインした後、右上のユーザー名の部分をクリックするとメニューが表示されます。
その中の「共通設定」をクリックしてください。
次に左側メニューから「外部システム連携」をクリックします。
「新規発行」をクリックします
「アクセストークン名」を入力します。利用する用途を名前にしておくと良いです。
例えば「分析レポート」とか…
必須項目の入力が埋まると「登録」ボタンがクリックできるようになるので登録するとアクセストークンが払い出されます。
これらのテナントIDとアクセストークンを利用して本ツールにて入力して「出力」ボタンをクリックしてもらうとレポートが出力されます。
まだまだ表示がおかしい部分があったり、追加したい機能等があるので引き続き開発を進めていきたいと思います!
採用計画や人事データを活用して分析を行いたい方は是非活用してみてください。