Job Runner

CSVを出力する

概要

テンプレートファイルとレコードデータをもとに CSV ファイルを生成・出力します。

使い方

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

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

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

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

Customineのカスタマイズでは、適用するテンプレートを保存したレコードと、出力するデータとなるレコードを選択するようなカスタマイズを作成します。

最後に、カスタマイズ内に「CSVを出力する」を設置し、テンプレートや出力レコードなどをパラメーターとして設定します。

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

テンプレートにシートが複数ある場合、Excel上でアクティブなシート(Excelを保存するときに開いていたシート)のみが出力されます。

設定するパラメーター

「gusuku APIキー」「データレコード」「テンプレートレコード」「テンプレートフィールド」「文字コード」「ファイル名」を設定します。

gusuku APIキー

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

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

データレコード

出力したいデータとなるレコードを選択します。

テンプレートレコード

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

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

テンプレートフィールド

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

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

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

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

文字コード

出力する CSV の文字コードを選択します。

UTF-8 を選択した場合、いわゆる「BOMなし」形式になります。この形式は出力ファイルをダブルクリックして Excel で開くと文字化けします。この形式のファイルを Excel で開きたい場合は、いったん新規ファイルで Excel を立ち上げ、Excel の「外部データの取り込み」機能で取り込んでください。

ファイル名

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

制限事項

  • 図や画像、セルの書式といったCSVで表現できない内容は出力時に失われます。

  • 出力処理が10分以内に終わらなかった場合はエラーになります。