intra-mart Accel Kaiden! 経費旅費 / 管理者操作ガイド 第27版 2024-04-01

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. ジョブネットの設定

ジョブネットの設定を行います。
  1. 「サイトマップ」→「テナント管理」→「ジョブネット設定」をクリックします。
  2. ジョブネット一覧(画面左部)の「通勤費Web経費精算用定期経路連携ファイルインポート」をクリックします。
    ../../../../_images/jobnet_0163.png
  3. 「編集」をクリックします。
    ../../../../_images/jobnet_0263.png
  4. 必要に応じて「実行パラメータ」、「トリガ設定」を編集します。
    ../../../../_images/jobnet_0363.png

    コラム

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

    コラム

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

    ジョブネット作成時には次のジョブを登録してください。
    ジョブID ジョブ名(ジョブ選択時のツリー)
    kaiden-job-base-tsukinhi-web-external-03-commute-route-data-linkage-import Kaiden! / 通勤費Web/ 外部 / 通勤費Web経費精算用定期経路連携ファイルインポート
  5. 編集後、「更新」をクリックします。
    ../../../../_images/jobnet_0463.png
  6. 確認ポップアップの「決定」をクリックします。
    ../../../../_images/jobnet_0563.png
  7. ジョブネットが設定されました。
    ../../../../_images/jobnet_0663.png

    コラム

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

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」形式