intra-mart Accel Kaiden! 勤務管理 / 管理者操作ガイド 第24版 2024-04-01

7.1.3.2. 契約・場所情報QRコード作成/確認マスタ

本項では、契約・場所情報QRコード作成/確認マスタの設定方法を説明します。

7.1.3.2.1. 概要

エッジ端末にインストールする”入退記録(Bio-IDiom Services for GPS連携)”アプリに設定する
契約・場所情報のQRコードを作成します。
メンテナンス、インポートの2種類の方法でマスタ設定が可能です。
また、マスタ設定をエクスポート可能です。

7.1.3.2.2. メンテナンス

本項では、メンテナンス機能を利用したマスタ設定方法を説明します。

7.1.3.2.2.1. 新規登録

  1. 「サイトマップ」→「勤務管理」→「Bio-IDiom Services」→「契約・場所情報QRコード作成/確認」をクリックします。

    コラム

    契約・場所情報QRコードの参照のみ行う場合は、
    「サイトマップ」→「勤務管理」→「Bio-IDiom Services」→「契約・場所情報QRコード確認」をクリックします。
  2. 一覧画面表示後、「新規登録」をクリックします。
    ../../../../../_images/mainte_0139.png
  3. 登録/更新画面で必要な情報を入力し、「登録」をクリックします。
    ../../../../../_images/mainte_0239.png
    • 会社
      会社を選択します。
    • 契約・場所情報コード
      契約・場所情報コードを入力します。
    • 契約・場所情報名
      契約・場所情報名を入力します。
    • 検索キーワード
      検索用のキーワードを入力します。
    • 場所名
      場所名を入力します。
      「場所名」はBio-IDiom Services for GPS連携に登録している顔認証対象者グループ名と同じ内容を登録してください。
    • 場所ID
      場所IDを入力します。
      「場所ID」はBio-IDiom Services for GPS連携に登録している顔認証対象者グループIDと同じ内容を登録してください。
    • 緯度(10進数)
      緯度(10進数)を入力します。
    • 経度(10進数)
      経度(10進数)を入力します。
    • 半径(m)
      半径(m)を入力します。
    • 場所名モード詳細
      場所名モード詳細を選択します。
      「場所名モード詳細」が未選択の場合はBio-IDiom Services設定の「入退記録アプリの運用モード」の設定値が有効になります。
      場所ごとに変更したい場合のみ選択してください。
    • 作業期間
      作業期間を入力します。
    • まばたき検知機能
      入退記録アプリでのまばたき検知機能の使用有無を選択します。
      「まばたき検知機能」が未選択の場合はBio-IDiom Services設定の「まばたきによるシャッター操作の要」の設定値が有効になります。
      場所ごとに変更したい場合のみ選択してください。

    コラム

    「場所名モード詳細」、「まばたき検知機能」の設定の詳細は
    intra-mart Accel Kaiden! セットアップガイド』-「WARファイルの作成」-「intra-mart Accel Kaiden!の設定ファイル」-「オプションモジュール」-「intra-mart Accel Kaiden! Bio-IDiom Services連携モジュール」-「Bio-IDiom Services for GPS連携設定」を参照してください。

    コラム

    明細行の操作方法は、 明細行の操作 を参照してください。
  4. 確認ポップアップが表示されますので、「決定」をクリックします。
    ../../../../../_images/mainte_0339.png
  5. 新規登録することができました。
    ../../../../../_images/mainte_0439.png

7.1.3.2.2.2. 更新

  1. 「サイトマップ」→「勤務管理」→「マスタメンテナンス」→「休暇申請別勤務状況マッピング」をクリックします。
  2. 一覧画面で「検索」をクリックします。
    ../../../../../_images/mainte_0539.png

    コラム

    検索欄に検索したい契約・場所情報の以下の項目を入力して「検索」をクリックすると、結果を一覧に表示します。
    • 契約・場所情報コード
    • 契約・場所情報名
    • 検索キーワード
  3. 一覧画面の対象データが表示されている行をクリックします。
    ../../../../../_images/mainte_0639.png

    コラム

    一覧機能の操作方法は、 一覧画面の操作 を参照してください。
  4. 登録/更新画面で情報を編集し、「更新」をクリックします。
    ../../../../../_images/mainte_0739.png
    次の項目は編集不可項目です。
    • 会社
    • 契約・場所情報コード
  5. 確認ポップアップが表示されますので、「決定」をクリックします。
    ../../../../../_images/mainte_0839.png
  6. 更新することができました。
    ../../../../../_images/mainte_0939.png

7.1.3.2.2.3. QRコード表示

  1. 「サイトマップ」→「勤務管理」→「Bio-IDiom Services」→「契約・場所情報QRコード確認」をクリックします。
  2. 一覧画面で「検索」をクリックします。
    ../../../../../_images/mainte_0539.png

    コラム

    検索欄に検索したい契約・場所情報の以下の項目を入力して「検索」をクリックすると、結果を一覧に表示します。
    • 契約・場所情報コード
    • 契約・場所情報名
    • 検索キーワード
  3. 一覧画面の対象データが表示されている行をクリックします。
    ../../../../../_images/mainte_0639.png

    コラム

    一覧機能の操作方法は、 一覧画面の操作 を参照してください。
  4. 「QRコード表示」をクリックします。
    ../../../../../_images/mainte_109.png
  5. 契約・場所情報QRコードを別ウィンドウで表示します。

7.1.3.2.2.4. QRコードダウンロード

  1. 「サイトマップ」→「勤務管理」→「Bio-IDiom Services」→「契約・場所情報QRコード確認」をクリックします。
  2. 一覧画面で「検索」をクリックします。
    ../../../../../_images/mainte_0539.png

    コラム

    検索欄に検索したい契約・場所情報の以下の項目を入力して「検索」をクリックすると、結果を一覧に表示します。
    • 契約・場所情報コード
    • 契約・場所情報名
    • 検索キーワード
  3. 一覧画面の対象データが表示されている行をクリックします。
    ../../../../../_images/mainte_0639.png

    コラム

    一覧機能の操作方法は、 一覧画面の操作 を参照してください。
  4. 「QRコードダウンロード」をクリックします。
    ../../../../../_images/mainte_115.png
  5. 契約・場所情報QRコードの画像ファイルがダウンロードされます。

7.1.3.2.3. インポート

本項では、インポート機能を利用したマスタ設定方法を説明します。

7.1.3.2.3.1. インポートデータ作成

インポートするデータを作成し、ストレージにアップロードします。
作成するインポートデータの形式は、次の通りです。
  • ファイル形式
    ジョブネットの設定で設定する実行パラメータにより変化します。
    以下は初期値(実行パラメータ未設定の場合)のファイル形式です。

    ファイル名
    import_header.csv
    import_detail.csv
    文字コード UTF-8
    区切り文字 ,
    囲み文字

  • データ形式

    import_header.csv
    No(列) 項目名 必須 最大文字数 備考
    1 会社コード 100  
    2 契約・場所情報コード 100  
    3 ロケールID 50
    ja:日本語
    en:英語
    zh_CN:中国語
    4 契約・場所情報名 250  
    5 検索キーワード   1000  

    データサンプル
    "comp_sample_01","000000","en","Sample Contract Name","sample"
    "comp_sample_01","000000","ja","サンプル契約名","sample"
    "comp_sample_01","000000","zh_CN","合同名称样本","sample"
    

    import_detail.csv
    No(列) 項目名 必須 最大文字数 備考
    1 会社コード 100  
    2 契約・場所情報コード 100  
    3 タプルID 18  
    4 行番号 18  
    5 場所名 30  
    6 場所ID 25  
    7 緯度(10進数) 11  
    8 経度(10進数) 11  
    9 半径(m) 8  
    10 作業開始日   10 yyyy/MM/dd形式
    11 作業終了日   10 yyyy/MM/dd形式
    12 場所名モード詳細   100  
    13 まばたき検知機能   1  

    データサンプル
    "comp_sample_01","000000","0","1","サンプル場所名","111111","35.692553","139.689662","30","2020/04/01","2021/03/31","103","1"
    

    注意

    契約・場所情報QRコードの明細は0件または1件のみ登録することができます。
    明細が0件の場合、import_detail.csvのファイルを空で作成しアップロードしてください。

  • アップロード先
    ジョブネットの設定で設定する実行パラメータにより変化します。
    以下は初期値(実行パラメータ未設定の場合)のアップロード先です。

    ディレクトリ kaiden/generic/master/nfcTenantInfo
    ファイル名
    import_header.csv
    import_detail.csv

    コラム

    インストール直後などはアップロード先のディレクトリが作成されていません。
    ディレクトリの作成方法やファイルのアップロード方法は、次のドキュメントを参照してください。

7.1.3.2.3.2. ジョブネットの設定

インポート機能用のジョブネットの設定を行います。
  1. 「サイトマップ」→「テナント管理」→「ジョブネット設定」をクリックします。
  2. ジョブネット一覧(画面左部)の「契約・場所情報」をクリックします。
    ../../../../../_images/jobnet_0149.png
  3. 「編集」をクリックします。
    ../../../../../_images/jobnet_0249.png
  4. 必要に応じて「実行パラメータ」、「トリガ設定」を編集します。
    ../../../../../_images/jobnet_0349.png

    コラム

    設定が必要な実行パラメータの詳細は、実行パラメータを参照してください。
    トリガ設定の設定方法は『テナント管理者操作ガイド』を参照してください。

    コラム

    複数の「実行パラメータ」、「トリガ設定」を行う場合はジョブネットを複数作成してください。
    ジョブネットの作成方法は『テナント管理者操作ガイド』を参照してください。

    ジョブネット作成時には次のジョブを登録してください。
    ジョブID ジョブ名(ジョブ選択時のツリー)
    kaiden-job-prlb-neo-face-import-01-nfcTenantInfo 勤務管理/ 顔認証 / インポート / 契約・場所情報
  5. 編集後、「更新」をクリックします。
    ../../../../../_images/jobnet_0449.png
  6. 確認ポップアップの「決定」をクリックします。
    ../../../../../_images/jobnet_0549.png
  7. ジョブネットが設定されました。
    ../../../../../_images/jobnet_0649.png

    コラム

    ジョブネットの設定(実行)後、メンテナンス機能でインポートが正しく実行されたことを確認してください。

7.1.3.2.3.3. 実行パラメータ

設定が可能な実行パラメータは次の通りです。
名称 キー 説明/設定値
エラースキップ
error_skip
会社別処理でエラー発生時の後続処理をスキップするか設定します。
(省略時:false)
ロック待ち時間
lock_wait
ロックの待ち時間を設定します。
(省略時:10秒)
処理対象会社グループセットコード
company_group_set_cd
インポートを行う会社の会社グループセットコードを設定します。
(省略時:登録済みの全会社を対象とします。)
処理対象会社グループコード
company_group_cd
インポートを行う会社の会社グループコードを設定します。
(省略時:登録済みの全会社を対象とします。)
処理対象会社コード
company_cd
インポートを行う会社の会社コードを設定します。
(省略時:登録済みの全会社を対象とします。)
コンダクター
conductor
ジョブの各処理間で実行されるコンダクターを設定します。
カンマ区切りで複数指定できます。
AbstractGenericJobConductorを継承したクラスのコンポーネント名を指定してください。
(省略時:コンダクターを使用しません。)
インポートモード
import_mode
インポートの処理モードを設定します。
(省略時:1)
  • 1 : 単一期間(差分)モード
インポートファイルのパス
file_path
インポートファイルのstorage以降のパスを設定します。
(省略時:kaiden/generic/master/nfcTenantInfo/
import_header.csv, import_detail.csv)
処理後のインポートファイルの操作モード
file_mode
処理後のインポートファイルの操作モードを設定します。
(省略時:1)
  • 1 : 操作なし
  • 2 : コピー(copy)
  • 3 : アーカイブ(move)
  • 4 : 正常終了(警告含)時アーカイブ(move)、エラー終了時操作なし
  • 5 : 正常終了(警告含)時操作なし、エラー終了時アーカイブ(move)
  • 6 : 削除(delete)
  • 7 : 正常終了(警告含)時削除(delete)、エラー終了時操作なし
  • 8 : 正常終了(警告含)時操作なし、エラー終了時削除(delete)
アーカイブ先パス
archive_path
インポートファイルのアーカイブ先パスを設定します。
(省略時:kaiden/generic/master/nfcTenantInfo/
import_header_{YMDHMSN}.csv, import_detail_{YMDHMSN}.csv)
文字コード
character
インポートファイルの文字コードを設定します。
(省略時:UTF-8)
  • UTF-8
  • SHIFT-JIS
区切り文字
delimiter
インポートファイルの区切り文字を設定します。
(省略時:,)
  • , : カンマ
  • \t : タブ
囲み文字
enclosing
インポートファイルの囲み文字を設定します。
(省略時:”)
  • ” : ダブルクォーテーション
読込開始行数
start_rows
インポートファイルの読込開始行数を設定します。
(省略時:0)
ガジェットクラス
gadgetClass
インポートするマスタのガジェットクラスを設定します。
契約・場所情報QRコード作成/確認マスタインポートの場合は「master」を設定します。
ガジェットバリエーション
gadgetVariation
インポートするマスタのガジェットバリエーションを設定します。
契約・場所情報QRコード作成/確認マスタインポートの場合は「nfcTenantInfo」を設定します。
{YMDHMSN}:「yyyyMMddHH24mmssSSS」形式

7.1.3.2.4. エクスポート

本項では、エクスポート機能を利用したマスタ設定方法を説明します。

7.1.3.2.4.1. ジョブネットの設定

エクスポート機能用のジョブネットの設定を行います。
  1. 「サイトマップ」→「テナント管理」→「ジョブネット設定」をクリックします。
  2. ジョブネット一覧(画面左部)の「契約・場所情報」をクリックします。
    ../../../../../_images/jobnet_0734.png
  3. 「編集」をクリックします。
    ../../../../../_images/jobnet_0834.png
  4. 必要に応じて「実行パラメータ」、「トリガ設定」を編集します。
    ../../../../../_images/jobnet_0934.png

    コラム

    設定が必要な実行パラメータの詳細は、実行パラメータを参照してください。
    トリガ設定の設定方法は『テナント管理者操作ガイド』を参照してください。

    コラム

    複数の「実行パラメータ」、「トリガ設定」を行う場合はジョブネットを複数作成してください。
    ジョブネットの作成方法は『テナント管理者操作ガイド』を参照してください。

    ジョブネット作成時には次のジョブを登録してください。
    ジョブID ジョブ名(ジョブ選択時のツリー)
    kaiden-job-prlb-neo-face-export-01-nfcTenantInfo 勤務管理/ 顔認証 / エクスポート / 契約・場所情報
  5. 編集後、「更新」をクリックします。
    ../../../../../_images/jobnet_1034.png
  6. 確認ポップアップの「決定」をクリックします。
    ../../../../../_images/jobnet_1134.png
  7. ジョブネットが設定されました。
    ../../../../../_images/jobnet_1234.png

7.1.3.2.4.2. ファイル取得

エクスポートファイルを次のエクスポート先から取得します。
  • エクスポート先
    ジョブネットの設定で設定する実行パラメータにより変化します。
    以下は初期値(実行パラメータ未設定の場合)のエクスポート先です。

    ディレクトリ kaiden/generic/{COMPANY_CD}/master/nfcTenantInfo
    ファイル名
    export_header.csv
    export_detail.csv

    コラム

    エクスポートファイルのダウンロード方法は、次のドキュメントを参照してください。
  • データ形式
    エクスポートファイルのデータ形式です。

    export_header.csv
    項目 項目名 備考
    companyCd 会社コード  
    tenantPlaceCd 契約・場所情報コード  
    localeId ロケール
    ja:日本語
    en:英語
    zh_CN:中国語
    tenantPlaceName 契約・場所情報名  
    searchKeyword 検索キーワード  

    export_detail.csv
    項目 項目名 備考
    companyCd 会社コード  
    tenantPlaceCd 契約・場所情報コード  
    tupleId タプルID  
    rowNumber 行番号  
    place 場所名  
    groupId 場所ID  
    gpsn 緯度(10進数)  
    gpse 経度(10進数)  
    radius 半径(m)  
    period_start_date 作業開始日 yyyy/MM/dd形式
    period_end_date 作業終了日 yyyy/MM/dd形式
    appMode 場所名モード詳細  
    shutterOpe まばたき検知機能  

7.1.3.2.4.3. 実行パラメータ

設定が可能な実行パラメータは次の通りです。
名称 キー 説明/設定値
エラースキップ
error_skip
会社別処理でエラー発生時の後続処理をスキップするか設定します。
(省略時:false)
ロック待ち時間
lock_wait
ロックの待ち時間を設定します。
(省略時:10秒)
処理対象会社グループセットコード
company_group_set_cd
エクスポートを行う会社の会社グループセットコードを設定します。
(省略時:登録済みの全会社を対象とします。)
処理対象会社グループコード
company_group_cd
エクスポートを行う会社の会社グループコードを設定します。
(省略時:登録済みの全会社を対象とします。)
処理対象会社コード
company_cd
インポートを行う会社の会社コードを設定します。
(省略時:登録済みの全会社を対象とします。)
コンダクター
conductor
ジョブの各処理間で実行されるコンダクターを設定します。
カンマ区切りで複数指定できます。
AbstractGenericJobConductorを継承したクラスのコンポーネント名を指定してください。
(省略時:コンダクターを使用しません。)
エクスポートモード
export_mode
エクスポートの処理モードを設定します。
(省略時:1)
  • 1 : 全件出力モード
  • 3 : 更新日モード(エクスポート対象データの検索対象以降に更新されたレコードを出力)
エクスポート対象データの検索対象日
target_date
エクスポートモード3を設定した場合、エクスポート対象データの検索対象日(yyyy/mm/dd)を設定します。
(省略時:ジョブの実行日)
シフト日数
shift_date
エクスポートモード3を設定した場合、エクスポート対象データの検索対象日に対する増減日数を設定します。
「-2147483648~2147483647」の範囲で設定してください。
(省略時:0)
エクスポートファイルのパス
file_path
エクスポートファイルのstorage以降のパスを設定します。
(省略時:kaiden/generic/{COMPANY_CD}/master/nfcTenantInfo/
export_header.csv, export_detail.csv)
エクスポート時の既存ファイルの操作モード
file_mode
エクスポート時の既存ファイルの操作モードを設定します。
(省略時:1)
  • 1 : 既存ファイルに追記
  • 2 : 既存ファイルを削除し、エクスポート
  • 3 : エクスポートファイルをアーカイブ(移動)し、エクスポート
アーカイブ先パス
archive_path
エクスポート時の既存ファイルの操作モードが3の場合、エクスポートファイルのアーカイブ先パスを設定します。
(省略時:kaiden/generic/{COMPANY_CD}/master/nfcTenantInfo/
export_header_{YMDHMSN}.csv, export_detail_{YMDHMSN}.csv)
文字コード
character
エクスポートファイルの文字コードを設定します。
(省略時:UTF-8)
  • UTF-8
  • SHIFT-JIS
区切り文字
delimiter
エクスポートファイルの区切り文字を設定します。
(省略時:,)
  • , : カンマ
  • \t : タブ
囲み文字
enclosing
エクスポートファイルの囲み文字を設定します。
(省略時:”)
  • ” : ダブルクォーテーション
  • none : 囲み文字なし
エクスポートファイルのヘッダー出力有無
header_row
エクスポートファイルのヘッダー出力有無を設定します。
(省略時:false)
  • true : ヘッダー出力有
  • false : ヘッダー出力無
ガジェットクラス
gadgetClass
インポートするマスタのガジェットクラスを設定します。
契約・場所情報QRコード作成/確認マスタインポートの場合は「master」を設定します。
ガジェットバリエーション
gadgetVariation
インポートするマスタのガジェットバリエーションを設定します。
契約・場所情報QRコード作成/確認マスタインポートの場合は「nfcTenantInfo」を設定します。
{COMPANY_CD}:会社コード
{YMDHMSN}:「yyyyMMddHH24mmssSSS」形式