SmartHR 帳票DX連携サービスとは、帳票DXと連携してPDF帳票・office帳票を出力できるサービスです。
出力したいデザインのテンプレートを選択し、実行することで生成された文書をダウンロードすることができます。
※本課題はSandbox組織におけるマニュアルとなりますのでご注意ください。本番組織のマニュアルはこちらとなります。
※Sandbox組織は本番運用環境と異なるため、予告なくメンテナンス作業等でサービスが停止する場合がございます。ご了承くださいますようお願い申し上げます。
目次
２.セットアップ
２.１.アプリケーションの連携
２.２.カスタムボタンの設置
３.実行
３.１.Basic認証について
３.２.カスタムボタンから認可を実行
３.３.ドキュメント出力
１.サービス連携の準備
- 帳票DX認証情報
認証情報は弊社までご連絡、お問い合わせいただいた際に発行しご提供します。
※本番組織の認証情報とは異なりますのでご注意ください。
２.セットアップ
２.１.アプリケーションの連携
１.以下URLより、「SmartHR Plus for sandbox」にアクセスします。
| https://******.daruma.space/sandbox/app_store/addons |
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＞「従業員リスト」画面からカスタムボタンをクリックします。
２.認証成功時にセッションに保管されたトークン情報をもとに帳票DX のテンプレート選択画⾯に遷移します。
◇◆－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－◆◇
テンプレート選択画面では、ヘルプページ等のリンクやログインユーザー名と社員番号を見る事が可能です。
●帳票DXのロゴ
帳票DX for SmartHRの製品ページへ遷移します。
●ヘルプマーク
弊社サポートサイト＞帳票DX for SmartHRページに遷移します。
●お知らせマーク
弊社ホームページ＞お知らせページに遷移します。
●現在ログインしているSmartHRのユーザ名と社員番号
◇◆－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－◆◇
◇◆－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－◆◇
ログアウトは以下から行います。
押下するとログイン中の状態が解除されログアウト完了画面に遷移します。
◇◆－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－◆◇
３.出⼒したいデザインのテンプレートを選択します。
◇◆－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－◆◇
出力を実行する選択中の従業員情報と、選択人数が右上に表示されます。
◇◆－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－◆◇
４.帳票DXでドキュメント⽣成が始まり、⽣成されたPDFがダウンロードされます。
◇◆－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－◆◇
「従業員リスト」より複数従業員を選択（一度に1000名まで）して出力することができるようになりました。
※ただ、1000名分の帳票を出力する際は負荷がかかるため、1000名分選択して出力したすぐ後に連続で1000名分選択して出力を行わないようにお願いいたします。
◇◆－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－◆◇
以上がSmartHRと帳票DXを連携して帳票を出力する手順になります。