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. 新規登録¶
「サイトマップ」→「経費精算・旅費精算」→「マスタメンテナンス」→「PDFデータ出力設定」をクリックします。 一覧画面表示後、「新規登録」をクリックします。 登録/更新画面で必要な情報を入力し、「登録」をクリックします。
設定コード会社ごとに一意のコードを入力します。 設定名設定の名称を入力します。 ファイルパス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ファイルに設定した入力フォームのフォーム名フォーム名の例)text01,text02,text03,text04 等入力フォームについては各ツールのマニュアル等を参照してください。参考URL:(Adobe)PDF フォームの作成と配布
確認ポップアップが表示されますので、「決定」をクリックします。 新規登録することができました。
3.46.2.2. 更新¶
「サイトマップ」→「経費精算・旅費精算」→「マスタメンテナンス」→「PDFデータ出力設定」をクリックします。 一覧画面で「検索」をクリックします。コラム
検索欄に検索したいPDFデータ出力設定の以下の項目を入力して「検索」をクリックすると、結果を一覧に表示します。
設定コード 設定名 一覧画面の対象データが表示されている行をクリックします。コラム
一覧機能の操作方法は、 一覧画面の操作 を参照してください。 登録/更新画面で情報を編集し、「更新」をクリックします。次の項目は編集不可項目です。
- 開始日
- 終了日
- 会社
- 設定コード
コラム
期間機能の操作方法は、 期間の操作 を参照してください。 確認ポップアップが表示されますので、「決定」をクリックします。 更新することができました。
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. ジョブネットの設定¶
インポート機能用のジョブネットの設定を行います。
「サイトマップ」→「テナント管理」→「ジョブネット設定」をクリックします。 ジョブネット一覧(画面左部)の「PDFデータ出力設定」をクリックします。 「編集」をクリックします。 必要に応じて「実行パラメータ」、「トリガ設定」を編集します。コラム
設定が必要な実行パラメータの詳細は、実行パラメータを参照してください。トリガ設定の設定方法は『テナント管理者操作ガイド』を参照してください。コラム
複数の「実行パラメータ」、「トリガ設定」を行う場合はジョブネットを複数作成してください。ジョブネットの作成方法は『テナント管理者操作ガイド』を参照してください。ジョブネット作成時には次のジョブを登録してください。
ジョブID ジョブ名(ジョブ選択時のツリー) kaiden-job-prwf-master-import-pdf-data-export-settings 経費旅費・旅費精算 / マスタ / インポート / PDFデータ出力設定 編集後、「更新」をクリックします。 確認ポップアップの「決定」をクリックします。 ジョブネットが設定されました。コラム
ジョブネットの設定(実行)後、メンテナンス機能でインポートが正しく実行されたことを確認してください。
3.46.3.3. 実行パラメータ¶
設定が可能な実行パラメータは次の通りです。
名称 キー 説明/設定値 エラースキップ error_skip 処理でエラー発生時の後続処理をスキップするか設定します。(省略時:false) ロック待ち時間 lock_wait ロックの待ち時間を設定します。(省略時:10秒) 処理対象会社グループセットコード company_group_set_cd 処理対象会社グループコード company_group_cd 処理対象会社コード company_cd インポートを行う会社の会社コードを設定します。(省略時:登録済みの全会社を対象とします。) コンダクター conductor ジョブの各処理間で実行されるコンダクターを設定します。カンマ区切りで複数指定できます。AbstractGenericJobConductorを継承したクラスのコンポーネント名を指定してください。(省略時:コンダクターを使用しません。) インポートモード import_mode
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. ジョブネットの設定¶
エクスポート機能用のジョブネットの設定を行います。
「サイトマップ」→「テナント管理」→「ジョブネット設定」をクリックします。 ジョブネット一覧(画面左部)の「PDFデータ出力設定」をクリックします。 「編集」をクリックします。 必要に応じて「実行パラメータ」、「トリガ設定」を編集します。コラム
設定が必要な実行パラメータの詳細は、実行パラメータを参照してください。トリガ設定の設定方法は『テナント管理者操作ガイド』を参照してください。コラム
複数の「実行パラメータ」、「トリガ設定」を行う場合はジョブネットを複数作成してください。ジョブネットの作成方法は『テナント管理者操作ガイド』を参照してください。ジョブネット作成時には次のジョブを登録してください。
ジョブID ジョブ名(ジョブ選択時のツリー) kaiden-job-prwf-master-export-pdf-data-export-settings 経費旅費・旅費精算 / マスタ / エクスポート / PDFデータ出力設定 編集後、「更新」をクリックします。 確認ポップアップの「決定」をクリックします。 ジョブネットが設定されました。
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」形式