intra-mart Accel Kaiden! 勤務管理 / 管理者操作ガイド 第12版 2020-05-29

4.3.1. 作業実績インポート

本項では、ジョブを利用した作業実績データのインポート方法を説明します。

4.3.1.1. 概要

作業実績データのインポートでは、各利用者の日別の作業実績データをインポートします。
他システムで管理している作業実績をインポートする際に使用します。

作業実績データのインポートには、次の注意点があります。
  • 作業実績のインポートは、作業実績が入力可能な期間のみに制限されます。

コラム

次の条件に一致する場合はインポートできません。
  • 該当期間の作業実績がオープンしていない。
  • 該当期間の作業実績が確定済みである。
  • 該当期間の作業実績が締め済みである。
  • ジョブ実行日に利用者が作業実績を利用できない。
  • 各種マスタの設定上、作業実績から入力できない作業実績情報はインポートできません。
  • 作業実績インポートを行った利用者の作業実績は自動的に確定されます。

4.3.1.2. ファイル作成

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

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

  • データ形式

    No(列) 項目名 必須 最大文字数 備考
    1 ユーザコード 100  
    2 対象日 10 yyyy/MM/dd形式
    3 連番 18
    ユニークな値にしてください。
    行番号は、インポートファイルの記載順で決まります。
    4 会社コード 100  
    5 プロジェクトコード 100  
    6 作業種類コード 100  
    7 作業種類内訳コード 100  
    8 工数 6 HH:mm形式
    9 備考   1000  
    10 分析用タグ1(組織用分析タグ)   100  
    11 分析用タグ2(プロジェクト用分析タグ   100  
    12 分析用タグ3   100  
    13 分析用タグ4   100  
    14 分析用タグ5   100  
    15 分析用タグ6   100  
    16 分析用タグ7   100  
    17 分析用タグ8   100  
    18 分析用タグ9   100  
    19 分析用タグ10   100  

    データサンプル
    "aoyagi","2016/05/18","0","comp_sample_01","000001","000001","31000010","8:00","","0100","1000","","","","","","","",""
    "aoyagi","2016/05/18","0","comp_sample_01","000001","000001","31000010","8:00"
    

    コラム

    1行目は全項目を記述していますが、2行目はNo.9以降の項目の記述を省略しています。
    記述を省略した項目は「“”」として扱われます。

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

    ディレクトリ kaiden/import/workData/
    ファイル名 daily_work_data_import.csv

    コラム

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

4.3.1.3. ジョブネットの設定

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

    コラム

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

    コラム

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

    ジョブネット作成時には次のジョブを登録してください。
    ジョブID ジョブ名(ジョブ選択時のツリー)
    kaiden-job-labor-import-dailyWorkData Kaiden! / 勤務管理 / 作業実績/作業実績インポート
  5. 編集後、「更新」をクリックします。
    ../../../../_images/jobnet_0434.png
  6. 確認ポップアップの「決定」をクリックします。
    ../../../../_images/jobnet_0534.png
  7. ジョブネットが設定されました。
    ../../../../_images/jobnet_0634.png

    コラム

    ジョブネットの設定(実行)後、作業実績一覧でインポートが正しく実行されたことを確認してください。

4.3.1.4. 実行パラメータ

設定が可能な実行パラメータは次の通りです。
名称 キー 説明/設定値
処理対象会社コード
company_cd
インポートを行う会社の会社コードを設定します。
(省略時:登録済みの全会社を対象とします。)
インポートファイル
target_file
インポートファイルのstorage以降のパスを設定します。
(省略時:kaiden/import/workData/
daily_work_data_import.csv)
文字コード
character
インポートファイルの文字コードを設定します。
(省略時:UTF-8)
  • UTF-8
  • SHIFT-JIS
区切り文字
delimiter
インポートファイルの区切り文字を設定します。
(省略時:,)
  • , : カンマ
  • \t : タブ
囲み文字
enclosing
インポートファイルの囲み文字を設定します。
(省略時:”)
  • ” : ダブルクォーテーション
読込開始行数
start_rows
インポートファイルの読込開始行数を設定します。
(省略時:2)
アーカイブファイル
archive_file
インポートファイルのアーカイブ先を設定します。
(省略時:kaiden/archive/import/workData/
daily_work_data_import_{YMDHMSN}.csv)
ファイル削除判定
delete_flag
インポートファイルの削除有無を設定します。
(省略時:false)
  • true : 削除する
  • false : 削除しない
正常終了時の
ファイル出力有無
normal_log
正常終了時の処理結果ファイル出力有無を設定します。
(省略時:true)
  • true : 出力する
  • false : 出力しない
{YMDHMSN}:「yyyyMMddHH24mmssSSS」形式