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

3.46. PDFデータ出力設定マスタ

本項では、PDFデータ出力設定マスタの設定方法を説明します。

3.46.1. 概要

PDFデータ出力設定マスタは、フォーム付PDFガジェットを使用した申請書のデータをCSVファイルで出力する項目の設定と出力先を管理します。
メンテナンス、インポートの2種類の方法でマスタ設定が可能です。
また、マスタ設定をエクスポート可能です。

コラム

フォーム付PDFガジェットを使用した申請書のデータを、最終承認後にCSVファイルで出力したい場合は本設定を実施ください。
フォーム付PDFガジェットについては、『intra-mart Accel Kaiden! 経費旅費 / ガジェットガイド』-「ガジェット」-「フォーム付PDF」を参照してください。

3.46.2. メンテナンス

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

3.46.2.1. 新規登録

  1. 「サイトマップ」→「経費精算・旅費精算」→「マスタメンテナンス」→「PDFデータ出力設定」をクリックします。
  2. 一覧画面表示後、「新規登録」をクリックします。
    ../../../_images/mainte_0141.png
  3. 登録/更新画面で必要な情報を入力し、「登録」をクリックします。
    ../../../_images/mainte_0241.png
    • 設定コード
      会社ごとに一意のコードを入力します。
    • 設定名
      設定の名称を入力します。
    • ファイルパス
      CSVファイルの出力先ファイルパスを入力します。
      ※{}内に出力データのキーを設定することで、出力データに置換されます。
    • 出力カラム
      CSVファイルに出力するカラムを入力します。
      ※出力データをカンマ区切りで設定します。
    • 文字コード
      出力するCSVファイルの文字コードを入力します。
      (未設定:「UTF-8」)
    • 区切り文字
      出力するCSVファイルの区切り文字を入力します。
      (未設定:「,」)
    • 囲み文字
      出力するCSVファイルの囲み文字を入力します。
      (未設定:「”」)

コラム

以下、出力可能なデータの一覧です。
「ファイルパス」、「出力カラム」で使用します。
「ファイルパス」で使用する場合、{}で囲むことで出力データに置換されます。
出力データ一覧
キー
matterNumber
案件番号
matterName
案件名
applyBaseDate
申請基準日
applyAuthUserCd
申請権限者コード
authCompanyCd
権限会社コード
authCompanyName
権限会社名
authOrgzSetCd
権限組織セットコード
authOrgzSetName
権限組織セット名
authOrgzCd
権限組織コード
authOrgzName
権限組織名
authUserCd
権限者コード
authUserName
権限者名
executeUserCd
実行者コード
executeUserName
実行者名
localeIdApply
申請時ロケールID
actFlag
代理フラグ
flowId
フローID
flowName
フロー名
flowVersionId
フローバージョンID
contentsId
コンテンツID
contentsName
コンテンツ名
contentsVersionId
コンテンツバージョンID
routeId
ルートID
routeName
ルート名
routeVersionId
ルートバージョンID
systemMatterId
システム案件ID
userDataId
ユーザデータID
gadgetId
ガジェットID
gadgetClass
ガジェットクラス
gadgetVariation
ガジェットバリエーション
gadgetInstance
ガジェットインスタンス
tupleId
タプルID
rowNumber
行番号
pdfFile
PDFファイルパス
json
PDFファイルのフォームデータ
※「出力カラム」で使用する場合、JSON形式の文字列を出力
「出力カラム」については、「フォーム付きPDFを添付して申請する方法」を参照
[フォーム名]
PDFファイルに設定した入力フォームのフォーム名
フォーム名の例)text01,text02,text03,text04 等
入力フォームについては各ツールのマニュアル等を参照してください。
  1. 確認ポップアップが表示されますので、「決定」をクリックします。
    ../../../_images/mainte_0341.png
  2. 新規登録することができました。
    ../../../_images/mainte_0441.png

3.46.2.2. 更新

  1. 「サイトマップ」→「経費精算・旅費精算」→「マスタメンテナンス」→「PDFデータ出力設定」をクリックします。
  2. 一覧画面で「検索」をクリックします。
    ../../../_images/mainte_0541.png

    コラム

    検索欄に検索したいPDFデータ出力設定の以下の項目を入力して「検索」をクリックすると、結果を一覧に表示します。
    • 設定コード
    • 設定名
  3. 一覧画面の対象データが表示されている行をクリックします。
    ../../../_images/mainte_0641.png

    コラム

    一覧機能の操作方法は、 一覧画面の操作 を参照してください。
  4. 登録/更新画面で情報を編集し、「更新」をクリックします。
    ../../../_images/mainte_0741.png
    次の項目は編集不可項目です。
    • 開始日
    • 終了日
    • 会社
    • 設定コード

    コラム

    期間機能の操作方法は、 期間の操作 を参照してください。
  5. 確認ポップアップが表示されますので、「決定」をクリックします。
    ../../../_images/mainte_0841.png
  6. 更新することができました。
    ../../../_images/mainte_0941.png

3.46.3. インポート

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

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

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

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

  • データ形式

    No(列) 項目名 必須 最大文字数 備考
    1 会社コード 100  
    2 設定コード 100  
    3 ロケールID 50
    ja:日本語
    en:英語
    zh_CN:中国語
    4 開始日   10
    yyyy/MM/dd形式
    インポートモードが
    4、5の場合、使用されます。
    5 終了日   10
    yyyy/MM/dd形式
    インポートモードが
    4、5の場合、使用されます。
    6 設定名 250  
    7 削除フラグ 1
    0:有効
    1:無効(論理削除)
    8 ファイルパス    
    9 出力カラム    
    10 文字コード   100  
    11 区切り文字   100  
    12 囲み文字   100  

    コラム

    複数のロケールで利用する場合は、必要な全ロケール分のデータを作成してください。

    データサンプル
    "comp_sample_01","sample","ja","","","サンプル設定","0","kaiden/export/{authCompanyCd}/{settingCd}.csv","matterNumber,matterName,applyBaseDate,authOrgzCd,authOrgzName,authUserCd,authUserName,settingCd,text01,text02,text03,text04,pdfFile","UTF-8",",","""
    "comp_sample_01","sample","en","","","Sample settings","0","kaiden/export/{authCompanyCd}/{settingCd}.csv","matterNumber,matterName,applyBaseDate,authOrgzCd,authOrgzName,authUserCd,authUserName,settingCd,text01,text02,text03,text04,pdfFile","UTF-8",",","""
    "comp_sample_01","sample","zh_CN","","","样品设置","0","kaiden/export/{authCompanyCd}/{settingCd}.csv","matterNumber,matterName,applyBaseDate,authOrgzCd,authOrgzName,authUserCd,authUserName,settingCd,text01,text02,text03,text04,pdfFile","UTF-8",",","""
    

    コラム

    上記は、日本語・英語・中国語の3ロケールを持つ場合のファイル例です。
    項目を省略する場合でも、「”」で囲んでください。

    コラム

    データ形式 No.6[設定名]に設定している”settingCd”は、最終承認後にPDFへ入力した値をCSV出力する場合、必要なフォームの名称になります。
    最終承認後にCSVを出力する際、”settingCd”には、データ形式 No.2[設定コード]を設定します。

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

    ディレクトリ kaiden/generic/master/pdf_data_export_settings
    ファイル名 import.csv

    コラム

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

3.46.3.2. ジョブネットの設定

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

    コラム

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

    コラム

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

    ジョブネット作成時には次のジョブを登録してください。
    ジョブID ジョブ名(ジョブ選択時のツリー)
    kaiden-job-prwf-master-import-pdf-data-export-settings 経費旅費・旅費精算 / マスタ / インポート / PDFデータ出力設定
  5. 編集後、「更新」をクリックします。
    ../../../_images/jobnet_0441.png
  6. 確認ポップアップの「決定」をクリックします。
    ../../../_images/jobnet_0541.png
  7. ジョブネットが設定されました。
    ../../../_images/jobnet_0641.png

    コラム

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

3.46.3.3. 実行パラメータ

設定が可能な実行パラメータは次の通りです。
名称 キー 説明/設定値
エラースキップ
error_skip
処理でエラー発生時の後続処理をスキップするか設定します。
(省略時:false)
ロック待ち時間
lock_wait
ロックの待ち時間を設定します。
(省略時:10秒)
処理対象会社グループセットコード
company_group_set_cd
インポートを行う会社の会社グループセットコードを設定します。
(省略時:登録済みの全会社を対象とします。)
処理対象会社グループコード
company_group_cd
インポートを行う会社の会社グループコードを設定します。
(省略時:登録済みの全会社を対象とします。)
処理対象会社コード
company_cd
インポートを行う会社の会社コードを設定します。
(省略時:登録済みの全会社を対象とします。)
コンダクター
conductor
ジョブの各処理間で実行されるコンダクターを設定します。
カンマ区切りで複数指定できます。
AbstractGenericJobConductorを継承したクラスのコンポーネント名を指定してください。
(省略時:コンダクターを使用しません。)
インポートモード
import_mode
インポートの処理モードを設定します。
(省略時:1)
  • 1 : 単一期間(差分)モード
  • 2 : 単一期間(一新)モード
  • 3 : 単一期間(入替)モード
  • 4 : 複数期間(差分)モード
  • 5 : 複数期間(入替)モード
開始日
start_date
インポート期間の開始日(yyyy/MM/dd)を設定します。
(省略時:ジョブの実行日)
終了日
end_date
インポート期間の終了日(yyyy/MM/dd)を設定します。
(省略時:システムの終了日)
シフト日数
shift_date
インポート期間の開始日に対する増減日数を設定します。
「-2147483648~2147483647」の範囲で設定してください。
(省略時:0)
インポートファイルのパス
file_path
インポートファイルのstorage以降のパスを設定します。
(省略時:kaiden/generic/master/pdf_data_export_settings/import.csv)
処理後のインポートファイルの操作モード
file_mode
処理後のインポートファイルの操作モードを設定します。
(省略時:1)
  • 1 : 操作なし
  • 2 : コピー(copy)
  • 3 : アーカイブ(move)
  • 4 : 正常終了(警告含)時アーカイブ(move)、エラー終了時操作なし
  • 5 : 正常終了(警告含)時操作なし、エラー終了時アーカイブ(move)
  • 6 : 削除(delete)
  • 7 : 正常終了(警告含)時削除(delete)、エラー終了時操作なし
  • 8 : 正常終了(警告含)時操作なし、エラー終了時削除(delete)
アーカイブ先パス
archive_path
インポートファイルのアーカイブ先パスを設定します。
(省略時:kaiden/generic/master/pdf_data_export_settings/import_{YMDHMSN}.csv)
文字コード
character
インポートファイルの文字コードを設定します。
(省略時:UTF-8)
  • UTF-8
  • SHIFT-JIS
区切り文字
delimiter
インポートファイルの区切り文字を設定します。
(省略時:,)
  • , : カンマ
  • \t : タブ
囲み文字
enclosing
インポートファイルの囲み文字を設定します。
(省略時:”)
  • ” : ダブルクォーテーション
読込開始行数
start_rows
インポートファイルの読込開始行数を設定します。
(省略時:0)
マスタID
masterId
インポートするマスタのIDを設定します。
PDFデータ出力設定マスタインポートの場合は、ジョブ設定の実行パラメータに「pdf_data_export_settings」を設定しています。
{YMDHMSN}:「yyyyMMddHH24mmssSSS」形式

3.46.4. エクスポート

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

3.46.4.1. ジョブネットの設定

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

    コラム

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

    コラム

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

    ジョブネット作成時には次のジョブを登録してください。
    ジョブID ジョブ名(ジョブ選択時のツリー)
    kaiden-job-prwf-master-export-pdf-data-export-settings 経費旅費・旅費精算 / マスタ / エクスポート / PDFデータ出力設定
  5. 編集後、「更新」をクリックします。
    ../../../_images/jobnet_1039.png
  6. 確認ポップアップの「決定」をクリックします。
    ../../../_images/jobnet_1139.png
  7. ジョブネットが設定されました。
    ../../../_images/jobnet_1239.png

3.46.4.2. ファイル取得

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

    ディレクトリ kaiden/generic/master/pdf_data_export_settings/
    ファイル名 export.csv

    コラム

    エクスポートファイルのダウンロード方法は、次のドキュメントを参照してください。
  • データ形式
    エクスポートファイルのデータ形式です。
    項目 項目名 備考
    companyCd 会社コード  
    settingCd 設定コード  
    localeId ロケール
    ja:日本語
    en:英語
    zh_CN:中国語
    startDate 開始日 yyyy/MM/dd形式
    endDate 終了日 yyyy/MM/dd形式
    settingName 設定名  
    deleteFlag 削除フラグ
    0:有効
    1:無効
    filePath ファイルパス  
    fileColumns 出力カラム  
    fileCharacter 文字コード  
    fileDelimiter 区切り文字  
    fileEnclosing 囲み文字  

3.46.4.3. 実行パラメータ

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