5.16.2. 通勤費Web経費精算用定期経路連携ファイルインポート¶
本項では、通勤費Web経費精算用定期経路連携ファイルエクスポートで「通勤費Web」から取得した定期経路連携ファイルをインポートすることで、通勤経路マスタに通勤経路を登録する方法を説明します。
5.16.2.1. 概要¶
通勤費Web経費精算用定期経路連携ファイルインポートは、「通勤費Web」から取得した定期経路連携ファイルをインポートして、通勤経路マスタに通勤経路を登録します。通勤費Webユーザマッピングマスタに登録されていないユーザのデータはインポートされません。インポートデータにバス経路等が含まれる場合、データはインポートされますが「通勤費Web」からインポートしたデータとして扱われず、定期券控除に利用されません。
5.16.2.1.1. ファイル作成¶
インポートするデータを作成し、ストレージにアップロードします。作成するインポートデータの形式は、次の通りです。
ファイル形式ジョブネットの設定で設定する実行パラメータにより変化します。以下は初期値(実行パラメータ未設定の場合)のファイル形式です。
ファイル名 commuterRouteDataLinkage.csv 文字コード SHIFT-JIS 区切り文字 , 囲み文字 なし データ形式
No(列) 項目名 必須 最大文字数 備考 1 社員ID ○ 20 2 削除フラグ 1 N:有効N以外:無効(論理削除)3 出発駅名 255 4 到着駅名 255 5 開始日 ○ 10 6 終了日 ○ 10 7 定期文字列 255 8 定期経路シリアライズデータ 255 データサンプルaoyagi,N,東京,新宿,2023/09/01,2024/02/29,東京:JR中央線快速:Down:新宿,xxxxxxxxxx アップロード先ジョブネットの設定で設定する実行パラメータにより変化します。以下は初期値(実行パラメータ未設定の場合)のアップロード先です。
ディレクトリ kaiden/ekispert/download/commuterRouteDataLinkageCsv/{COMPANY_CD} ファイル名 commuterRouteDataLinkage.csv {COMPANY_CD}:会社コードコラム
インストール直後などはアップロード先のディレクトリが作成されていません。ディレクトリの作成方法やファイルのアップロード方法は、次のドキュメントを参照してください。
5.16.2.2. ジョブネットの設定¶
ジョブネットの設定を行います。
「サイトマップ」→「テナント管理」→「ジョブネット設定」をクリックします。 ジョブネット一覧(画面左部)の「通勤費Web経費精算用定期経路連携ファイルインポート」をクリックします。 「編集」をクリックします。 必要に応じて「実行パラメータ」、「トリガ設定」を編集します。コラム
設定が必要な実行パラメータの詳細は、実行パラメータを参照してください。トリガ設定の設定方法は『テナント管理者操作ガイド』を参照してください。コラム
複数の「実行パラメータ」、「トリガ設定」を行う場合はジョブネットを複数作成してください。ジョブネットの作成方法は『テナント管理者操作ガイド』を参照してください。ジョブネット作成時には次のジョブを登録してください。
ジョブID ジョブ名(ジョブ選択時のツリー) kaiden-job-base-tsukinhi-web-external-03-commute-route-data-linkage-import Kaiden! / 通勤費Web/ 外部 / 通勤費Web経費精算用定期経路連携ファイルインポート 編集後、「更新」をクリックします。 確認ポップアップの「決定」をクリックします。 ジョブネットが設定されました。コラム
ジョブネットの設定(実行)後、メンテナンス機能でデータ取得が正しく実行されたことを確認してください。
5.16.2.3. 実行パラメータ¶
設定が可能な実行パラメータは次の通りです。
名称 キー 説明/設定値 エラースキップ error_skip 処理でエラー発生時の後続処理をスキップするか設定します。(省略時:false) ロック待ち時間 lock_wait ロックの待ち時間を設定します。(省略時:10秒) 処理対象会社グループセットコード company_group_set_cd 処理対象会社グループコード company_group_cd 処理対象会社コード company_cd インポートを行う会社の会社コードを設定します。(省略時:登録済みの全会社を対象とします。) コンダクター conductor ジョブの各処理間で実行されるコンダクターを設定します。カンマ区切りで複数指定できます。AbstractGenericJobConductorを継承したクラスのコンポーネント名を指定してください。(省略時:コンダクターを使用しません。) インポートファイルのパス file_path インポートファイルのstorage以降のパスを設定します。(省略時:kaiden/ekispert/download/commuterRouteDataLinkageCsv/{COMPANY_CD}/commuterRouteDataLinkage.csv) 処理後のインポートファイルの操作モード file_mode 処理後のインポートファイルの操作モードを設定します。(省略時:1)
1 : 操作なし 2 : コピー(copy) 3 : アーカイブ(move) 4 : 正常終了(警告含)時アーカイブ(move)、エラー終了時操作なし 5 : 正常終了(警告含)時操作なし、エラー終了時アーカイブ(move) 6 : 削除(delete) 7 : 正常終了(警告含)時削除(delete)、エラー終了時操作なし 8 : 正常終了(警告含)時操作なし、エラー終了時削除(delete) アーカイブ先パス archive_path インポートファイルのアーカイブ先パスを設定します。(省略時:kaiden/ekispert/download/commuterRouteDataLinkageCsv/{COMPANY_CD}/commuterRouteDataLinkage_{YMDHMSN}.csv) 文字コード character インポートファイルの文字コードを設定します。(省略時:SHIFT-JIS)
UTF-8 SHIFT-JIS 区切り文字 delimiter インポートファイルの区切り文字を設定します。(省略時:,)
, : カンマ \t : タブ 囲み文字 enclosing インポートファイルの囲み文字を設定します。(省略時:none)
” : ダブルクォーテーション none : 囲み文字なし 読込開始行数 start_rows インポートファイルの読込開始行数を設定します。(省略時:0){COMPANY_CD}:会社コード{YMDHMSN}:「yyyyMMddHH24mmssSSS」形式