SmartHR 帳票DX連携サービスとは、帳票DXと連携してPDF帳票・office帳票を出力できるサービスです。
出力したいデザインのテンプレートを選択し、実行することで生成された文書をダウンロードすることができます。
※本課題はSandbox組織におけるマニュアルとなりますのでご注意ください。本番組織のマニュアルはこちらとなります。
※Sandbox組織は本番運用環境と異なるため、予告なくメンテナンス作業等でサービスが停止する場合がございます。ご了承くださいますようお願い申し上げます。
目次
２.セットアップ
２.１.アプリケーションの連携
２.２.カスタムボタンの設置
３.実行
３.１.Basic認証について
３.２.カスタムボタンから認可を実行
３.３.ドキュメント出力
１.サービス連携の準備
- 帳票DX認証情報
認証情報は弊社までご連絡、お問い合わせいただいた際に発行しご提供します。
２.セットアップ
２.１.アプリケーションの連携
１.以下URLより、「SmartHR Plus for sandbox」にアクセスします。
| https://******.daruma.space/sandbox/app_store/addons |
URLの*******部分はサブドメインといい、各企業のアカウントごとに異なります。
Sandboxにログインした際のURLの以下の部分がサブドメインです。
２.「アプリケーションをインストールする」をクリックします。
３.SmartHR Plus アプリケーションの登録画面で登録するOAuth Client IDを入力します。
| 項目 | 入力する値 |
| OAuth Client ID | 86951134118814 |
４.入力後、「登録する」ボタンをクリックします。
５.以下のように表示されていることを確認し、アプリケーションの連携は完了です。
２.２.カスタムボタンの設置
１.SmartHRの「共通設定」より「カスタムボタン」を選択します。
２.「カスタムボタンを追加」ボタンをクリックします。
以下赤枠の「カスタムボタンを追加」をクリックいただいても追加可能です。
３.開いた「カスタムボタンの追加」ダイアログでボタン名と帳票DXと連携するURLを入力します。
入力後、「登録」ボタンをクリックします。
| 項目 | 入力する値 |
| ボタン名 | 任意の名前を設定(ドキュメント出力等) |
| URL | https://tk0-d.ap.oproarts.com/smarthrb_work1/action?data={data_url}&type=template_select |
4.以下のように表示されていることを確認し、カスタムボタン設置完了です。
３.実行
３.１.Basic認証について
アプリケーションの連携（２.１.アプリケーションの連携）を行うと、ログイン時やトークン情報を保持するセッションが切れた際、Basic認証が求められるケースがございます。
お送りさせて頂く認証情報の中にユーザー名とパスワードも記載しておりますので、これらを入力後「ログイン」ボタンをクリックします。
こちらはSandbox組織のみ発生するもので、本番組織では発生しません。
３.２.カスタムボタンから認可を実行
１.SmartHR＞「従業員リスト」画面を開きます。
２.表示されている従業員一覧から、出力実行する従業員にチェックを入れます。
３.出力実行する従業員を選択後、「一括操作」ボタンをクリックし、カスタムボタンの設定（２.２.カスタムボタンの設置）で作成したボタンをクリックします。
４.初回アクセス時やアプリの改修が行われた際、「帳票DX サービス連携」画⾯が開かれます。
「連携」ボタンをクリックします。
５.認可画⾯が開きますので、「連携を許可」ボタンをクリックします。
６.「帳票DX 認証情報⼊⼒」画⾯に遷移しますので、弊社より発⾏された認証情報を⼊⼒し、「認証」ボタンをクリックします。
７.認証が成功すると、「認証が完了しました。この画面を閉じて従業員選択から出力実行を行ってください」と表示されますので、「閉じる」ボタンをクリックして⼀度ウィンドウを閉じます。
３.３.ドキュメント出力
１.SmartHR＞「従業員リスト」画面からカスタムボタンをクリックします。
「従業員リスト」より複数従業員を選択（一度に1000名まで）して出力することができます。
※ただ、1000名分の帳票を出力する際は負荷がかかるため、1000名分選択して出力したすぐ後に連続で1000名分選択して出力を行わないようにお願いいたします。
２.認証成功時にセッションに保管されたトークン情報をもとに帳票DX のテンプレート選択画⾯に遷移します。
３.出⼒したいデザインのテンプレートを選択します。
フォルダ>テンプレート のように階層で選択します。
※出力を実行する選択中の従業員情報と、選択人数が右上に表示されます。(キャプチャ青枠)
テンプレートをカスタマイズしたい方はこちらをご参照ください。
※カスタマイズできるテンプレートとできないテンプレートがございます。
<確認方法>
テンプレート選択画面>設定マーク>出力設定画面 で鉛筆マークが表示されているものがカスタムできるテンプレートです
４.帳票DXで⽣成されたドキュメントがダウンロードされます。
以上がSmartHRと帳票DXを連携して帳票を出力する手順になります。