POWER EGG 3.0
HRMOS経費(eKeihi)連携

2023年1月

ディサークル株式会社

改版履歴
修正日・版

修正箇所・内容

2021/02/26 1.0版

初版 発行

2021/08/12 2.0版

Ver3.2c の修正パッチに連携機能を含むことに伴い、設定の流れを修正
POC の場合はパッチの適用は不要の旨を追記

2022/02/14 3.0版

設定の流れ「③メニュー（eKeihi連携設定）の追加」の作業が必要なケースを記載

2023/01/30 4.0版

製品名変更（eKeihi→HRMOS経費）に伴う画面イメージの差し替え、名称変更
設定の流れ「⑥ 各社員ごとの設定」 以下の記載を追記
・HRMOS経費を利用しないユーザの場合の設定方法について追記
・ユーザIDに使用する項目に関する留意事項を追記

1

All Rights Reserved Copyright© D-CIRCLE,INC.

1

事前準備
以下の条件を満たしているか事前に確認した上で、設定・利用を行なってください。
・APIの設定を除いて、 HRMOS経費の導入準備が完了していること
・POWER EGG3.0のバージョンがVer3.2c以降であること
・POWER EGG利用環境（Webサーバ、クライアント）からHRMOS経費がネットワーク的に接続できる環境であること
また、 HRMOS経費のログイン用URL、API用URLについて設定時に必要となりますので、ご用意お願いします。

2

All Rights Reserved Copyright© D-CIRCLE,INC.

HRMOS経費(eKeihi)連携においての実現機能、連携イメージ図
今回のHRMOS経費(eKeihi)連携機能では、以下の機能が可能となります。
①アクションメニューから、 HRMOS経費にシングルサインオンできる（ログイン後のトップ画面）②アシストメッセージに、 HRMOS経費のトップ画面の情報を表示する③アシストメッセージをクリックすると、 HRMOS経費にシングルサインオンして該当画面を表示する（PC版のみの機能となります。スマホ版はアシストメッセージの表示のみ）①アクションメニューから、 HRMOS経費にシングルサインオンできる（ログイン後のトップ画面）

3

All Rights Reserved Copyright© D-CIRCLE,INC.

HRMOS経費(eKeihi)連携においての実現機能、連携イメージ図②アシストメッセージに、HRMOS経費のトップ画面の情報を表示する③アシストメッセージをクリックすると、HRMOS経費にシングルサインオンして該当画面を表示する（ PC版のみの機能 別ウィンドウでの表示）【PC版での表示例】【スマホ版での表示例】 ※ スマホ版は表示のみでタップできません

4

All Rights Reserved Copyright© D-CIRCLE,INC.

HRMOS経費(eKeihi)連携においての実現機能、連携イメージ図
HRMOS経費のトップ画面に表示される承認依頼情報のうち、承認、代理承認、グループ承認の３つがPOWER EGGのアシストメッセージに表示されます。（それぞれの同じ色枠内の箇所が対応しています）【POWER EGG側のアシストメッセージ】【HRMOS経費側のトップ画面】

5

All Rights Reserved Copyright© D-CIRCLE,INC.

HRMOS経費アシストメッセージ取得の流れ
POWER EGG

③アクセストークンの再取得

HRMOS経費

有効期限切れの場合②アクセストークンの有効期限を確認④アクセストークンを返却⑤ログイン者の承認依頼情報の取得

有効期限内の場合⑥ログイン者の承認依頼情報を返却①HRMOS経費側のアシストメッセージ表示要求⑦NaviViewにトップ画面の情報をアシストメッセージとして表示

6

All Rights Reserved Copyright© D-CIRCLE,INC.

連携仕様
HRMOS経費側のアカウント情報を使用し、認証を行います。
HRMOS経費のユーザIDをPOWER EGG上で社員ごとに設定しますが、どの項目に設定するかは、予め POWER EGG の「HRMOS経費(eKeihi)連携設定」で設定する必要があります。
HRMOS経費(eKeihi)連携設定については、「POWER EGG側の設定(HRMOS経費(eKeihi)連携設定)」をご参照ください。
例： POWER EGGの社員所属情報の「メモ１」 をユーザIDとして使用する場合
HRMOS経費側のユーザID：imaoka
HRMOS経費(eKeihi)連携設定の「ユーザIDとして使用する項目」：社員所属情報のメモ１
シングルサインオンの設定「ユーザID」-「デフォルト値」：@@empmemo1@@
POWER EGG社員所属情報の「メモ１」：imaoka※ POWER EGGのどの項目をユーザIDに使用できるかについては、「POWER EGG側の設定(各社員ごとの設定)」のページをご参照ください。

7

All Rights Reserved Copyright© D-CIRCLE,INC.

設定の流れ以下の順番で各設定を行なってください。
【HRMOS経費側】① API連携の登録【POWER EGG側の設定】② Ver3.2c の場合、修正パッチの適用③ メニュー（HRMOS経費(eKeihi)連携設定）の追加④ HRMOS経費(eKeihi)連携設定⑤ シングルサインオンの設定⑥ 各社員ごとの設定⑦ アクションメニューの設定

8

All Rights Reserved Copyright© D-CIRCLE,INC.

HRMOS経費側の設定(① API連携の登録)
HRMOS経費側にAPI連携を行なうための設定が必要となります。
その際には、管理者アカウントにてログインし、以下の手順で設定を行なってください。
・「管理」タブから「API連携」を選択します。
・コード1～3のうち、いずれかを選択します。

9

All Rights Reserved Copyright© D-CIRCLE,INC.

HRMOS経費側の設定(① API連携の登録)
・クライアントID、クライアントシークレット、スコープに左下に記載する設定内容に従い入力・選択し、「有効」にチェックをつけ、登録します。

【設定内容】
項目名

入力・選択値

クライアントID

poweregg

クライアントシークレット

PowerEgg30

スコープ

top_info※複数の会社でHRMOS経費(eKeihi)連携を使用する場合、それぞれ異なるクライアントIDを指定してください。
HRMOS経費では、クライアントIDを3つまで登録できるため、同一のHRMOS経費（API用URLが同一）を使用できるのは３社までとなります。
クライアントIDとクライアントシークレットの「入力・選択値」は例であり、POWER EGG側の設定と一致していれば問題ありません。
10

All Rights Reserved Copyright© D-CIRCLE,INC.

HRMOS経費側の設定(① API連携の登録)・登録後、入力した設定が登録されていることを一覧で確認してください。

11

All Rights Reserved Copyright© D-CIRCLE,INC.

POWER EGG側の設定(② Ver3.2cの場合、修正パッチの適用）
・パッケージ版／POWER EGG クローズドクラウド（PCC）の
POWER EGG3.0 Ver3.2c をご利用で、HRMOS経費(eKeihi)連携 HotFix(HotFix_PE32cPL0+eKeihi_31244) または
修正パッチ未適用の場合、修正パッチ1以降を適用してください。
※修正パッチの適用については、販売代理店様にご相談ください。
※POWER EGG オープンクラウド（POC）をご利用の場合は、本作業は必要ありません。

12

All Rights Reserved Copyright© D-CIRCLE,INC.

POWER EGG側の設定(③ メニュー（HRMOS経費(eKeihi)連携設定）の追加)
・下記の場合、「HRMOS経費(eKeihi)連携設定」の処理をメニューに追加してください。
 パッケージ版／POWER EGG クローズドクラウド（PCC）の Ver3.2c をご利用の場合
 パッケージ版／POWER EGG クローズドクラウド（PCC）の Ver3.2c 以前からVer3.3c 以降にバージョンアップしてご利用する場合
 POWER EGG オープンクラウド（POC）をご利用の場合処理グループ

処理名

基本（管理者） HRMOS経費(eKeihi)連携設定

処理種別
管理者

上記の処理が登録されていますので、システム設定 > システム共通 > メニューの設定より、メニューに追加してください。
推奨：トップメニュー：システム設定＞外部システム連携設定 の最後に追加してください。
※POWER EGG3.0 Ver3.4c を新規インストールしてご利用になる場合は、HRMOS経費(eKeihi)連携設定のメニューは初期登録されているため、本作業は必要ありません。
※POWER EGG3.0 Ver3.3cからVer3.4cへバージョンアップを行なった場合は、メニュー名の変更が必要となります。[システム設定] – [システム共通] - [メニューの設定] – [メニューの登録]より、対象メニューのメニュー名をeKeihiからHRMOS経費へ変更してください。

13

All Rights Reserved Copyright© D-CIRCLE,INC.

POWER EGG側の設定(④ HRMOS経費(eKeihi)連携設定)
・HRMOS経費(eKeihi)連携設定画面より、HRMOS経費を利用する会社ごとに接続情報を登録してください。（設定内容は次ページ参照）
クライアントシークレットまで入力後、接続テストボタンを押すことで、認証キーとなるアクセストークンとその有効期限が取得されます。

[システム設定] - [外部システム連携設定] - [HRMOS経費(eKeihi)連携設定]

また、以下の3つの項目が変更となる際には必ず、接続ボタンを押し、アクセストークンを取得し直す必要があります。
【アクセストークン取得し直し対象となる項目】
・HRMOS経費API連携先URL
・クライアントID・クライアントシークレット
有効期限が切れた場合は、期限切れ以降の初回のアシストメッセージ取得時にアクセストークンを再取得し、設定が自動更新されるため、運用開始以降は再設定不要です。

14

All Rights Reserved Copyright© D-CIRCLE,INC.

POWER EGG側の設定(④ HRMOS経費(eKeihi)連携設定)【設定内容】
項目名

入力・選択値会社

HRMOS経費を利用する会社

シングルサインオンID

シングルサインオン設定で登録するID
例）eKeihi

HRMOS経費API接続先URLHRMOS経費のAPI用URL

クライアントID

HRMOS経費のAPI連携で登録したクライアントID

クライアントシークレット

HRMOS経費のAPI連携で登録したクライアントシークレット
HRMOS経費へのシングルサインオン時にユーザIDとして使用する項目です。
使用できる項目に関する注意事項等については、「POWER EGG側の設定(各社員ごとの設定)」のページをご参照ください。
シングルサインオンの設定時には当画面で選択した値に対応したデフォルト値を入力してください。

ユーザIDとして使用する項目

選択する値

シングルサインオン設定で設定するデフォルト値

当システムのユーザID@@userid@@

メールアドレス@@mailaddress@@

外部社員コード１@@empid1@@

外部社員コード２@@empid2@@

社員情報のメモ1@@empmemo1@@

社員情報のメモ2@@empmemo2@@

社員情報のメモ3@@empmemo3@@

社員所属情報のメモ1@@belongmemo1@@

社員所属情報のメモ2@@belongmemo2@@

社員所属情報のメモ3@@belongmemo3@@

15

All Rights Reserved Copyright© D-CIRCLE,INC.

POWER EGG側の設定(⑤ シングルサインオンの設定)
・以下の設定画面より、右下に記載した設定内容に従い、HRMOS経費へのシングルサインオンを行なう設定を登録してください。
[システム設定]-[外部システム連携設定] [外部システムへのシングルサインオンの設定] [シングルサインオンの設定(管理者用)]【設定内容】
以下に記載された項目以外の項目は設定不要です。
項目名

入力・選択値ID

HRMOS経費(eKeihi)連携設定で設定したシングルサインオンID

連携システム名連携URL
連携種類
ユーザ設定
使用区分
ユーザID
画面表示
必須指定
パラメタ名

HRMOS経費(eKeihi)連携
HRMOS経費のログイン用URL
フォーム認証（POST）
要（パスワードをユーザが設定しない場合は「不要」）
チェックなしデフォルト値
パスワード
画面表示
必須指定
パラメタ名

デフォルト値

16

表示する
入力必須
uid（左記以外の値を使用することはできません）
HRMOS経費(eKeihi)連携設定画面「ユーザIDとして使用する項目」で選択した値に対応するデフォルト値を入力してください。
詳細は、「POWER EGG側の設定(④ HRMOS経費(eKeihi)連携設定)」をご参照ください。

表示する
入力必須
pw（左記以外の値を使用することはできません）
パスワードをユーザが設定する場合は、何も指定せず空欄にしてください。この場合、初回接続時に表示される入力画面でユーザがパスワードを入力します（個人設定の画面からも設定可能です）。
パスワードをユーザが設定せず、POWER EGG のマスタの値をパスワードに使用する場合は、ここで使用する値を指定してください。使用できる値は
POWER EGG のマニュアルをご参照ください。

All Rights Reserved Copyright© D-CIRCLE,INC.

POWER EGG側の設定(⑥ 各社員ごとの設定)
HRMOS経費(eKeihi)連携設定で登録した「ユーザIDに使用する項目」に応じて、POWER EGG側の社員情報または社員所属情報を設定してください。
＜HRMOS経費を利用する社員と利用しない社員が混在する場合の注意事項＞
HRMOS経費を利用しない社員については、「ユーザIDに使用する項目」として指定した項目を空白に設定する必要があります。
そのため、当システムのユーザIDや、他の用途にも使用している項目は 「ユーザIDに使用する項目」として使用できないため、ご注意ください。
ユーザIDに使用する項目
当システムのユーザID
メールアドレス
外部社員コード１
外部社員コード２
社員情報のメモ1
社員情報のメモ2
社員情報のメモ3
社員所属情報のメモ1

設定する画面
社員の登録で設定
組織図エディタの社員所属情報で設定
社員の登録で設定

組織図エディタの社員所属情報で設定

社員所属情報のメモ2
社員所属情報のメモ3

17

All Rights Reserved Copyright© D-CIRCLE,INC.

POWEREGG側の設定(⑦ アクションメニューの設定)
・アクションメニューからHRMOS経費にシングルサインオンする場合、以下の設定を登録してください。
・処理の登録・メニューの登録[システム設定] – [システム共通] - [メニューの設定] – [処理の登録]

18【設定内容】
項目名

入力・選択値

処理グループ基本（一般）

処理種別

ユーザ用

URL

SSO/SSO0100d.jsf?LINKID=eKeihi
LINKIDには「シングルサインオンの設定」で登録したIDを指定してください。
「URLの前に“/pe4j/”を付ける」のチェックを外さないでください。

権限設定

HRMOS経費のアクションメニュー利用者に「使用可」の権限を登録してください。

使用区分

表示する

All Rights Reserved Copyright© D-CIRCLE,INC.

POWER EGG側の設定(⑦ アクションメニューの設定)[システム設定] – [システム共通] - [メニューの設定] – [メニューの登録]

19【設定内容】「処理の登録」で登録した処理をメニューに登録してください。

All Rights Reserved Copyright© D-CIRCLE,INC.

留意事項
・ 複数の会社でHRMOS経費(eKeihi)連携を使用する場合、それぞれ異なるクライアントIDを指定してください。HRMOS経費では、クライアントIDを3つまで登録できるため、同一のHRMOS経費（API用URLが同一）を使用できるのは３社までとなります。
P10の表で記載しているクライアントIDとクライアントシークレットの「入力・選択値」は例であり、POWER EGG側の設定と一致していれば問題ありません。
・ Office365連携やSAML認証機能を利用している場合は、社員情報のメモ1はユーザIDとして利用できません。別の項目に設定してください。
・ PCリマインダー等の各リマインダーからの起動には対応していません。アシストメッセージをクリック・タップした場合は、ナビビューへ遷移します。

20

All Rights Reserved Copyright© D-CIRCLE,INC.