2. 勤怠管理のワークフローを作成するための準備¶
勤怠管理のワークフローでは、一部の項目の入力補助として、データベースに登録しているマスタ情報を参照する設定を行います。シナリオに従って操作を行う前に、準備作業として、これら参照するマスタを IM-FormaDesigner の標準アプリケーションで作成し、データを登録しましょう。
2.1. 勤怠管理のワークフローでマスタを参照している項目¶
勤怠管理のワークフローでマスタを参照している項目は、次の2つです。この2つの項目で利用するマスタを作成します。
2.1.1. 勤怠種類マスタ¶
2.1.2. 人件費マスタ¶
2.2. 勤怠種類マスタを作成する¶
勤怠種類を管理するマスタを作成していきましょう。
2.2.1. アプリケーションの登録を始める¶
BIS管理者に設定したユーザでログインします。(今回の例では、「浅野幸長」でログインします。) サイトマップ「Forma管理画面」の「Formaアプリ作成管理」配下にある「アプリ一覧」をクリックします。 アプリケーション一覧が表示されます。「登録」をクリックして、勤怠種類マスタのアプリケーションを新規に登録しましょう。 アプリケーションの基本情報を以下の図のように設定しましょう。 必要な情報を入力したら「登録」をクリックしましょう。確認メッセージは「決定」をクリックして、次の作業に進みます。
2.2.2. 画面のレイアウトを設定する¶
2.2.2.1. ヘッダーを設定する¶
2.2.2.2. 入力項目を配置する¶
データの入力項目を設定しましょう。
「ツールキット」をクリックして、ツールキットを表示しましょう。 入力アイテムの「文字列」を2つドラッグアンドドロップで配置します。 配置した「文字列」をダブルクリックしてプロパティ画面を表示し、ラベルをそれぞれ「勤怠種類コード」「勤怠種類名」に変更します。入力が終わったら、「詳細設定」タブをクリックします。 それぞれのアイテムのフィールド識別IDとフィールド識別名を設定します。設定したら、プロパティの外側をクリックして、プロパティを閉じます。 入力アイテムの「セレクトボックス」をドラッグアンドドロップで配置します。 配置した「セレクトボックス」をダブルクリックしてプロパティ画面を表示し、ラベルを「ロケール」に変更します。変更したら「データの定義」タブをクリックしましょう。 「」アイコンを3回クリックして、項目の定義の入力欄を3行分用意しましょう。
追加した項目の定義に対して、以下の図の通りに入力しましょう。入力が終わったら、「詳細設定」をクリックしましょう。 初期値を設定するために「フィールド初期選択値」に”ja”(日本語)を入力しましょう。また、フィールド識別ID、フィールド識別名を以下の通りに入力します。入力が終わったら、プロパティの外側の任意の部分をクリックしてプロパティを閉じます。
2.2.2.3. ボタンを配置する¶
2.2.3. アプリケーションのデータのテーブルを作成する¶
2.2.4. アプリケーションの一覧画面を設定する¶
2.2.5. データ登録の権限を設定する¶
マスタデータを一覧画面から登録・更新・削除・変更するための権限を設定しましょう。今回は、人事部とBIS管理者のみが一覧画面からデータのメンテナンスを行えるように設定していきます。
「権限設定」をクリックします。 最初にBIS管理者のロールに権限を付与していきます。「ロール」を展開し、「追加」をクリックしましょう。 「」をクリックしてロール検索画面を表示しましょう。
検索キーワードに「BIS管理者」を入力後に「検索」をクリックしましょう。検索結果から「BIS管理者」を選択して「決定」をクリックします。 権限を「登録・更新・削除可能」に変更し、「登録」をクリックすると、BIS管理者のロールへの権限設定ができました。確認メッセージでは、そのまま「決定」をクリックします。 続いて、人事部に所属するユーザへの権限設定を行うために「組織」を展開し、「追加」をクリックしましょう。 「」をクリックして組織検索画面を表示しましょう。
組織検索でツリーの表示に切り替えた後、株式会社ナガハマ、管理本部の順にツリーを展開し、人事部を選択して、「決定」をクリックしましょう。 権限を「登録・更新・削除可能」に変更し、「登録」をクリックすると、人事部に所属するユーザへの権限設定ができました。確認メッセージでは、そのまま「決定」をクリックします。 これで権限設定が完了しましたので、続いてメニューへの登録を行います。
2.2.6. 一覧画面をメニューに登録する¶
2.3. 勤怠種類マスタのデータを登録する¶
作成した勤怠種類マスタのデータを登録しましょう。
2.3.1. 勤怠種類マスタの一覧画面を表示する¶
勤怠種類マスタの権限を設定したユーザで一覧画面を表示しましょう。
先の手順で権限を付与したBIS管理者、または人事部の所属ユーザでログインしましょう。今回は例として、人事部の「細川忠興」さんでログインします。 サイトマップ「Formaアプリ」の「勤怠種類マスタ一覧」をクリックします。 「登録」をクリックしてデータの登録画面を表示します。 通常の出勤を登録するために、以下のように各項目に入力して「登録」をクリックします。 これで1件データを登録することができましたので、同様にして他の勤怠種類を登録します。 データの登録が終わった時点では、以下の図のようにデータが表示されています。続いてデータを取得するための作業に移ります。
2.4. 勤怠種類マスタのデータを参照するためのデータソース定義を登録する¶
勤怠種類マスタを、ワークフローの画面から入力補助として参照するためのデータソース定義を登録していきましょう。
2.4.1. データを取得するSQLを確認する¶
今回は、データソース定義を「テナントDBクエリ」として登録するにあたって、事前にSQLを確認します。SQLを簡単に生成する方法として、ViewCreatorのクエリ機能を利用していきます。
BIS管理者に設定したユーザでログインします。(今回の例では、「浅野幸長」でログインします。) サイトマップ「ViewCreator」の「クエリ一覧」をクリックします。 クエリ一覧で「新規」をクリックしてクエリ編集画面を表示しましょう。 テーブル一覧で先に作成したアプリケーションのテーブル名を入力して、対象のテーブルを表示しましょう。この時、テーブル一覧が表示されていない場合には、「テーブル一覧表示」をクリックすると表示されます。 絞り込んだテーブルをドラッグ&ドロップで編集画面上に配置しましょう。 配置したテーブルから画面の項目「imfr_ud_work_id(勤怠種類コード)」「imfr_ud_work_name(勤怠種類名)」をダブルクリックして、下のカラム一覧に追加します。追加し終わったら、「抽出条件一覧」をクリックしましょう。 今度は、配置したテーブルから画面の項目「locale」のみダブルクリックして、下の抽出条件一覧に追加します。追加したら、「SQLの表示」をクリックしましょう。 自動的に生成されたSQL文が表示されますので、コピーしてメモ帳などのテキストファイルに保存しておきます。このクエリは登録する必要はありませんので、SQLの保存後は何もせずに「サイトマップ」をクリックして、次の作業に移ります。
2.4.2. データソース定義の登録を始める¶
2.4.3. データソース定義のクエリを設定する¶
SQLの欄に表示されている内容を、先に確認したSQL文ですべて上書きます。一部、最後のWHEREの内容に表示されている「=」の後を’‘から?に変更します。 このデータソース定義では、ユーザのロケール(表示言語の設定)に合わせて切り替えられるように、入力値(データの抽出条件)を設定します。入力値をロケールの1項目分になるように、下の2行の「削除」をクリックして削除します。 次に、勤怠管理フローで「勤怠種類コード」「勤怠種類名」を参照できるように、出力値の追加を1回クリックして入力欄を2行にしましょう。 カラム名、論理名を以下の図のように設定しましょう。ロケールによって、項目の表示名を変える場合には、それぞれの項目ごとに言語に対応した内容を入力しましょう。 最後に、設定内容に問題がないかを確認するために入力値の「テスト実行値」に’ja’を入力した上で、「テスト実行」をクリックしましょう。エラーメッセージが表示されず、「テスト実行に成功しました。取得件数:4」が表示できていれば設定内容は問題ありませんので、このまま「登録」をクリックして登録しましょう。確認メッセージでは、「決定」をクリックして進めていきます。
2.5. 人件費マスタを作成する¶
社員の基本時間人件費を管理するマスタを作成していきましょう。
2.5.1. アプリケーションの登録を始める¶
BIS管理者に設定したユーザでログインします。(今回の例では、「浅野幸長」でログインします。) サイトマップ「Forma管理画面」の「Formaアプリ作成管理」配下にある「アプリ一覧」をクリックします。 アプリケーション一覧が表示されます。「登録」をクリックして、人件費マスタのアプリケーションを新規に登録しましょう。 アプリケーションの基本情報を入力しましょう。アプリケーション種別は「標準」としておきます。必要な情報を入力したら「登録」をクリックしましょう。
2.5.2. 画面のレイアウトを設定する¶
2.5.2.1. ヘッダーを設定する¶
2.5.2.2. 入力項目を配置する¶
データの入力項目を設定しましょう。
「ツールキット」をクリックして、ツールキットを表示しましょう。 入力アイテムの「文字列」を2つドラッグアンドドロップで配置します。 配置した「文字列」をダブルクリックしてプロパティ画面を表示し、ラベルをそれぞれ「従業員ランク」「従業員ランク名」に変更します。入力が終わったら、「詳細設定」タブをクリックします。 それぞれのアイテムのフィールド識別IDとフィールド識別名を設定します。 入力アイテムの「セレクトボックス」をドラッグアンドドロップで配置します。 配置した「セレクトボックス」をダブルクリックしてプロパティ画面を表示し、ラベルを「ロケール」に変更します。変更したら「データの定義」タブをクリックしましょう。 「」アイコンを3回クリックして、項目の定義の入力欄を3行分用意しましょう。
3行の表示値をそれぞれ「日本語」「英語」「中国語」と入力しましょう。送信値は「ja」「en」「zh_CN」としておきます。入力が終わったら、「詳細設定」をクリックしましょう。 初期値を設定するために「フィールド初期選択値」に”ja”(日本語)を入力しましょう。また、フィールド識別ID、フィールド識別名を以下の通りに入力します。入力が終わったら、プロパティの外側の任意の部分をクリックしてプロパティを閉じます。 入力アイテムの「数値」をドラッグアンドドロップで配置します。 配置した「数値」をダブルクリックしてプロパティ画面を表示し、[前]ラベルを「時間単価」、[後]ラベルを「円」に変更し、表示フォーマットの3桁カンマのチェックをオンにします。変更したら「詳細設定」タブをクリックします。 フィールド識別IDとフィールド識別名を設定します。入力が終わったら、プロパティの外側の任意の部分をクリックしてプロパティを閉じます。
2.5.2.3. ボタンを配置する¶
2.5.3. アプリケーションのデータのテーブルを作成する¶
2.5.4. アプリケーションの一覧画面を設定する¶
2.5.5. データ登録の権限を設定する¶
マスタデータを一覧画面から登録・更新・削除・変更するための権限を設定しましょう。今回は、経理部とBIS管理者のみが一覧画面からデータのメンテナンスを行えるように設定していきます。
「権限設定」をクリックします。 最初にBIS管理者のロールに権限を付与していきます。「ロール」を展開し、「追加」をクリックしましょう。 「」をクリックしてロール検索画面を表示しましょう。
検索キーワードに「BIS管理者」を入力後に「検索」をクリックしましょう。検索結果から「BIS管理者」を選択して「決定」をクリックします。 権限を「登録・更新・削除可能」に変更し、「登録」をクリックすると、BIS管理者のロールへの権限設定ができました。確認メッセージでは、そのまま「決定」をクリックします。 続いて、経理部に所属するユーザへの権限設定を行うために「組織」を展開し、「追加」をクリックしましょう。 「」をクリックして組織検索画面を表示しましょう。
組織検索でツリーの表示に切り替えた後、株式会社ナガハマ、管理本部の順にツリーを展開し、経理部を選択して、「決定」をクリックしましょう。 権限を「登録・更新・削除可能」に変更し、「登録」をクリックすると、経理部に所属するユーザへの権限設定ができました。確認メッセージでは、そのまま「決定」をクリックします。 これで権限設定が完了しましたので、続いてメニューへの登録を行います。
2.5.6. 一覧画面をメニューに登録する¶
2.6. 人件費マスタのデータを登録する¶
作成した人件費マスタのデータを登録しましょう。
2.6.1. 人件費マスタの一覧画面を表示する¶
人件費マスタの権限を設定したユーザで一覧画面を表示しましょう。
先の手順で権限を付与したBIS管理者、または経理部の所属ユーザでログインしましょう。今回は例として、経理部の「桑名吉成」さんでログインします。 サイトマップ「Formaアプリ」の「人件費マスタ一覧」をクリックします。 「登録」をクリックしてデータの登録画面を表示します。 ランク「エントリー」を登録するために、以下のように各項目に入力して「登録」をクリックします。 これで1件データを登録することができましたので、同様にして他の人件費を登録します。 データの登録が終わったら、続いてデータを取得するための作業に移ります。
2.7. 人件費マスタのデータを参照するためのデータソース定義を登録する¶
人件費マスタをワークフローの画面から人件費単価として検索するためのデータソース定義を登録していきましょう。
2.7.1. データを取得するSQLを確認する¶
今回は、データソース定義を「テナントDBクエリ」として登録するにあたって、事前にSQLを確認します。SQLを簡単に生成する方法として、ViewCreatorのクエリ機能を利用していきます。
BIS管理者に設定したユーザでログインします。(今回の例では、「浅野幸長」でログインします。) サイトマップ「ViewCreator」の「クエリ一覧」をクリックします。 クエリ一覧で「新規」をクリックしてクエリ編集画面を表示しましょう。 テーブル一覧で先に作成したアプリケーションのテーブル名を入力して、対象のテーブルを表示しましょう。この時、テーブル一覧が表示されていない場合には、「テーブル一覧表示」をクリックすると表示されます。 絞り込んだテーブルをドラッグ&ドロップで編集画面上に配置しましょう。 配置したテーブルから画面の項目「imfr_ud_labor_rank(従業員ランク)」「imfr_ud_labor_rank_name(従業員ランク名)」「imfr_ud_labor_unit_cost(時間単価)」をダブルクリックして、下のカラム一覧に追加します。追加し終わったら、「抽出条件一覧」をクリックしましょう。 今度は、配置したテーブルから画面の項目「locale」のみダブルクリックして、下の抽出条件一覧に追加します。追加したら、「SQLの表示」をクリックしましょう。 自動的に生成されたSQL文が表示されますので、コピーしてメモ帳などのテキストファイルに保存しておきます。このクエリは登録する必要はありませんので、SQLの保存後は何もせずに「サイトマップ」をクリックして、次の作業に移ります。
2.7.2. データソース定義の登録を始める¶
2.7.3. データソース定義のクエリを設定する¶
SQLの欄に表示されている内容を、先に確認したSQL文ですべて上書きます。一部、最後のWHEREの内容に表示されている「=」の後を’‘から?に変更します。 このデータソース定義では、ユーザのロケール(表示言語の設定)に合わせて切り替えられるように、入力値(データの抽出条件)を設定します。入力値をロケールの1項目分になるように、下の2行の「削除」をクリックして削除します。 次に、勤怠管理フローで「従業員ランク」「ランク名」「時間単価」を検索できるように、出力値の追加を2回クリックして入力欄を3行にしましょう。 カラム名、論理名を以下の図のように設定しましょう。ロケールによって、項目の表示名を変える場合には、それぞれの項目ごとに言語に対応した内容を入力しましょう。出力値の「時間単価」についてはデータ型を「NUMBER」に変更しておきます。 最後に、設定内容に問題がないかを確認するために入力値の「テスト実行値」に’ja’を入力した上で、「テスト実行」をクリックしましょう。エラーメッセージが表示されず、「テスト実行に成功しました。取得件数:4」が表示できていれば設定内容は問題ありませんので、このまま「登録」をクリックして登録しましょう。これで、勤怠管理フローを作成するための事前準備は完了です。引き続き、フローの作成を進めていきましょう。
2.8. 関連情報¶
ここに記載した IM-FormaDesigner でのアプリケーションの作成やデータソース定義の設定方法の詳細は、以下のドキュメントで説明しております。