検索条件でPDFを出力する

概要

テンプレートファイルとレコードの検索条件をもとに PDF ファイルを生成・出力します。

「PDFを出力する」に比べてより多くのレコードを処理することができます。代わりに制限事項が多くなります。

事前にいくつかの準備が必要です。

gusukuのAPIキーが必要になります。この APIキーは kintone アプリの APIトークンとは異なります。gusuku の APIキーは gusuku 共通管理画面から発行・取得することができます。

テンプレートファイルを準備します。テンプレートファイルの作成方法については、Excel/PDF出力テンプレートリファレンスマニュアルのページをご覧ください。

また、テンプレートを保存するためのkintoneアプリも必要です。作成したアプリに添付ファイルフィールドを設置し、このフィールドに１テンプレートにつき１レコードになるようにレコードを作成しておきます。

Customineのカスタマイズでは、適用するテンプレートを保存したレコードを取得しておき、「検索条件でPDFを出力する」でテンプレートや出力レコードを取得するクエリなどをパラメーターとして設定します。

生成されたPDFファイルはkintoneへアップロードされた状態になります。「レコードを追加する」などのフィールドマッピングで、「=$1」等として「PDFを出力する」の結果をセットすることで添付ファイルフィールドにセットすることができます。

「gusuku APIキー」「データレコード取得アプリ」「データレコード検索条件」「テンプレートレコード」「ファイル名」を設定します。

gusuku の APIキーを指定します。

kintone アプリの APIトークンのことではありませんので注意してください。

出力したいデータをどのアプリから取得するかを選択します。

出力したいデータを取得するための検索条件（クエリ）を入力します。

条件を「すべてのレコード」にすることも可能です。

並び順を指定することも可能ですが、指定しないほうが高速に処理できます。指定しない場合はレコード ID の昇順になります。

テンプレートファイルの入ったレコードを選択します。

選択したレコードが実行時に１行もなかった場合はエラーになります。

テンプレートファイルの入った「テンプレートレコード」内の添付ファイルフィールドを選択します。

添付ファイルフィールドのみ選択可能です。テーブル内のフィールドは選択できません。

添付ファイルフィールド内にファイルが１つも添付されていない場合は、実行時にエラーになります。

添付ファイルのファイル拡張子が .xlsx である必要があります。それ以外の拡張子のファイルだった場合は、実行時にエラーになります。

添付ファイルフィールドにつけるファイル名を入力します。

データレコードの取得は、kintoneアプリのAPIトークンではなく、CustomineまたはDeploitで行ったkintone接続設定におけるユーザーで行われます。