テンプレートファイルとレコードデータをもとに CSV ファイルを生成・出力します。
事前にいくつかの準備が必要です。
gusukuのAPIキーが必要になります。この APIキーは kintone アプリの APIトークンとは異なります。gusuku の APIキーは gusuku 共通管理画面から発行・取得することができます。
テンプレートファイルを準備します。テンプレートファイルの作成方法については、Excel/PDF出力テンプレート リファレンスマニュアルのページをご覧ください。
また、テンプレートを保存するためのkintoneアプリも必要です。作成したアプリに添付ファイルフィールドを設置し、このフィールドに１テンプレートにつき１レコードになるようにレコードを作成しておきます。
Customineのカスタマイズでは、適用するテンプレートを保存したレコードと、出力するデータとなるレコードを選択するようなカスタマイズを作成します。
最後に、カスタマイズ内に「CSVを出力する」を設置し、テンプレートや出力レコードなどをパラメーターとして設定します。
生成されたCSVファイルはkintoneへアップロードされた状態になります。「レコードを追加する」などのフィールドマッピングで、「=$1」等として「CSVを出力する」の結果をセットすることで添付ファイルフィールドにセットすることができます。
テンプレートにシートが複数ある場合、Excel上でアクティブなシート（Excelを保存するときに開いていたシート）のみが出力されます。
「gusuku APIキー」「データレコード」「テンプレートレコード」「テンプレートフィールド」「文字コード」「ファイル名」を設定します。
gusuku の APIキーを指定します。
kintone アプリの APIトークンのことではありませんので注意してください。
出力したいデータとなるレコードを選択します。
テンプレートファイルの入ったレコードを選択します。
選択したレコードが実行時に１行もなかった場合はエラーになります。
テンプレートファイルの入った「テンプレートレコード」内の添付ファイルフィールドを選択します。
添付ファイルフィールドのみ選択可能です。テーブル内のフィールドは選択できません。
添付ファイルフィールド内にファイルが１つも添付されていない場合は、実行時にエラーになります。
添付ファイルのファイル拡張子が .xlsx である必要があります。それ以外の拡張子のファイルだった場合は、実行時にエラーになります。
出力する CSV の文字コードを選択します。
UTF-8 を選択した場合、いわゆる「BOMなし」形式になります。この形式は出力ファイルをダブルクリックして Excel で開くと文字化けします。この形式のファイルを Excel で開きたい場合は、いったん新規ファイルで Excel を立ち上げ、Excel の「外部データの取り込み」機能で取り込んでください。
添付ファイルフィールドにつけるファイル名を入力します。
図や画像、セルの書式といったCSVで表現できない内容は出力時に失われます。
出力処理が10分以内に終わらなかった場合はエラーになります。