はじめてのプリザンターアプリ作成：見積管理４

今回は、見積管理アプリに実装する以下機能の内、見積書出力機能を作成します。

見積書作成機能: 見積書を出力するための管理項目を作成します。
見積明細編集機能: 見積書の明細部分を同じ画面で一括編集できるようにします。
見積書出力機能: 見積管理アプリからExcelで見積書を出力します。
承認ワークフロー機能: 顧客に見積提示する前にライン上の承認申請を行います。

はじめに
「export for Pleasanter」の設定
まとめ

はじめに

帳票出力機能は、プリザンターの標準機能にはないので、当社でExcel帳票出力ツール「export for Pleasanter」を開発しました。

「export for Pleasanter」の設定

今回は見積管理アプリに「export for Pleasanter」を設定してExcel帳票を出力していきます。

export for Pleasanter導入手順

STEP1
セットアップ
- 拡張スクリプト
- サーバー再起動
STEP2
サイトパッケージのインポート
- efp設定アプリ
- efp詳細設定アプリ
STEP3
アプリケーション設定追加
- 既存アプリにExcelテンプレート項目追加
- 既存アプリにExcel出力ボタン追加
STEP4
Excelテンプレート用意
- 書式別明細行別にテンプレートを用意
STEP5
export for Pleasanter設定
- efp設定アプリにExcel出力をアプリケーション情報を設定
- efp詳細設定アプリにExcelテンプレート情報等を設定
STEP6
Excel出力
- アプリケーションでデータ登録
- Excel出力と確認
- 必要に応じてExcelでPDF等へのデータ変換し業務利用

STEP3：アプリケーション設定追加＞Excelテンプレート項目追加

見積管理アプリ＞テーブルの管理＞エディタでExcelテンプレート項目を追加します。

項目名	型	必須	読取	重複	規定値	選択肢	検索
Excelテンプレート	分類					efp設定*2	*1

*1 「検索機能を使う」・「複数選択」・「選択肢にブランクを挿入しない」に☑を設定
*2 以下コードをコピー＆ペーストしてください。なお、「”SiteId”: 99999,」はSTEP2のサイトパッケージのインポートしたefp設定アプリのサイトIDを、「”NumB”: “[\”99999\”]”」は見積管理アプリのサイトIDを設定してください。

[
    {
        "SiteId": 99999,
        "NoAddButton": true,
        "View": {
            "ColumnFilterHash": {
                "NumB": "[\"99999\"]"
            },
            "ColumnFilterSearchTypes": {
                "NumB": "ExactMatch"
            },
            "ColumnSorterHash": {
                "NumA": "asc"
            }
        }
    }
]

STEP3：アプリケーション設定追加＞Excel出力ボタン追加

見積管理アプリ＞テーブルの管理＞プロセスタブを選択します。

新規作成ボタンをクリックし、以下を設定後、画面下部の追加ボタンをクリックしてください。

画面種別：編集
現在の状況：*
変更後の状況：*
OnClick：efpOutputFile(this)
実行種別：追加したボタン
アクション種別：無し

export for Pleasanterの注意点

プリザンターのプロセスでExcel出力ボタン作成時、OnClick時のexport for Pleasanter起動処理：efpOutputFile(this)で設定した場合、「efp設定」および「efp詳細設定」のサイト名を検索しサイトIDを自動で取得します。
同じ名前のサイト名がある場合には、efpOutputFile(this,efp設定サイトID,efp詳細設定サイトID)で指定してください。

STEP4：Excelテンプレート用意

今回は、見積管理アプリと見積明細アプリで作成した見積データを使用してExcel出力します。

見積書テンプレートの設定ルールは以下の通りです。

見積管理アプリは親テーブルなので、{{項目物理名}}と二重の波括弧で項目の物理名を設定します。
見積明細アプリは子テーブルなので、{{{項目物理名}}}と三重の波括弧で項目の物理名を設定します。
今回はありませんが、孫テーブルがある場合は、{{{{項目物理名}}}}と四重の波括弧と項目の物理名を設定します。

プリザンターの項目物理名は以下を参照ください。

例えば、タイトルなら「Title」、分類Aなら「ClassA」、有償ライセンスで分類項目を増やしているなら「Claas001」となります。

項目名とデータベース上のカラム名の対応 | Pleasanter

プリザンターの項目名とデータベース上のカラム名の対応について説明します。データベースのカラム名は「API」でパラメータを指定するときや、「スクリプト」で入力項目を指定するときに利用してください。

設定後のテンプレート結果です。

今回は、見積明細15行版と25行版の2つのテンプレートを作成しました。

テンプレートファイル名に波括弧を入れると置換されます。
今回は、見積管理アプリの見積番号と件名を入れて作成します。
・明細15行版：{{Title}}-{{ClassB}}-見積書テンプレート15行版.xlsx
・明細25行版：{{Title}}-{{ClassB}}-見積書テンプレート25行版.xlsx

テンプレート内にオブジェクトがあるとエラーになるため入れないください。

Excel起動時、「実行時エラー1004 OｎKeyメソッドが失敗しました。Applicationオブジェクト」と表示されるときがあります。