テンプレート挿入プラグイン（無料）
文字列(複数行)またはリッチエディターフィールドに、あらかじめ登録した定型文(テンプレート)を 挿入するプラグインです。テンプレート本文には他フィールドの値を埋め込むプレースホルダーを 書けます。本文の一部を「[[ ]]」で囲むと、その部分だけをサブテーブルの行数ぶん繰り返し展開 できるため、固定の前置き・後書きの文章とテーブル明細の繰り返し部分を1つのテンプレートの中で 自由に組み合わせられます。複数のテンプレートをヘッダーのドロップダウンから選んで挿入する 通常モードのほか、フォーム上のラジオボタンの選択肢に応じて挿入するテンプレートが自動的に 決まる連動モードにも対応しています。
こんな方におすすめ
- 問い合わせ対応や議事録など、決まり文句をレコードに毎回手入力するのが面倒
- 定型文の中に担当者名や件名などレコードの値を差し込みたい
- ステータスやカテゴリーの選択肢に応じて、挿入する文面を自動で切り替えたい
- サブテーブルの明細行から、箇条書きの本文をまとめて自動生成したい
- 「kintone 定型文 挿入」「kintone テンプレート 自動入力」を探している
紹介動画
ユースケース
ヘッダーのドロップダウンから「お礼メール」「一次回答」などのテンプレートを選び、「テンプレ挿入」ボタンを押すだけで、担当者名や件名といったレコードの値が埋め込まれた定型文を挿入できます。追加(末尾に追記)/上書き(既存の内容を置き換える)を切り替えられるので、書き足したいときも、書き直したいときも同じボタンで対応できます。複数のテンプレートを切り替えながら使えるので、対応内容ごとに文面を書き分けられます。
ラジオボタン連動モードを使うと、ヘッダーにはドロップダウンを出さず挿入ボタンだけを表示し、その時点で選ばれているラジオボタンの値(承認/却下など)に対応するテンプレートを自動で判定して挿入します。対応するテンプレートが無い選択肢のときはボタンが無効になり、選び間違いによる誤挿入を防げます。
本文中の繰り返したい部分を「[[ ]]」で囲むと、その部分だけを対象のサブテーブルの行数ぶん展開し、1行ずつ連結してまとめて挿入できます。「見積内容:\n[[・{品名}({数量}個)]]\n以上、よろしくお願いいたします。」のようなテンプレートを設定しておけば、固定の前置き・後書きはそのまま、明細行だけが行数ぶん繰り返された箇条書き本文を1回の挿入操作で生成できます。
セットアップ手順
- プラグインをアプリに追加し、設定画面を開く。
- 表示モード(通常モード/ラジオボタン連動モード)を選ぶ。ラジオボタン連動モードの場合は、連動させるラジオボタンフィールドも選ぶ。
- 「+ テンプレートを追加」でテンプレートを作成し、テンプレート名・挿入先フィールド(文字列複数行/リッチエディターのみ)・本文を設定する。本文中の「{フィールドコード}」は挿入時にそのフィールドの値へ置き換わる(プレースホルダー挿入ツールバーからワンクリックで本文に追加できる)。サブテーブルの行を繰り返し挿入したい部分は「[[ ]]」で囲む(「選択範囲を[[ ]]で囲む」ボタンで補助できる)。
- ラジオボタン連動モードの場合は、ラジオボタンの選択肢ごとに対応するテンプレートを選んで保存する(対応させないままでもよい)。
- 保存後、アプリを更新する(kintoneのアプリ設定は保存しただけでは反映されず、更新〈デプロイ〉して初めてレコード画面に反映されます)。
「テンプレ挿入」ボタンの隣で追加/上書きを切り替えられます。追加は既存の内容の末尾への追記(カーソル位置への挿入ではありません)、上書きは既存の内容を破棄してテンプレートの内容に置き換えます。既存値が空の場合、追加でも区切り文字を挟まずそのまま設定されます。値マップに存在しないフィールドコードを指定した場合、プレースホルダーはそのまま(置換されずに)残ります。リッチエディターへ挿入するテンプレート本文にはHTMLタグ(太字・リンク等)を直接書けます(挿入されるフィールドの値そのものは安全のため常にエスケープされます)。PC・モバイルの両方に対応しています。
セキュリティレビュー結果サマリ
kintoneセキュアコーディングガイドラインに沿って実装時にチェックしています。特に重要な点は次のとおりです。
- リッチエディター(HTMLとして描画されるフィールド)へ挿入する場合、テンプレート本文(アプリ管理権限を持つユーザーのみ編集可能)はHTMLタグをそのまま反映しますが、置換される各プレースホルダーの値(他ユーザーが入力しうるレコードの実データ)は必ずHTMLエスケープしています。他のフィールドの値に
<script>等が含まれていても、タグとして解釈されずXSSにつながりません(ユニットテストで確定的に検証済み)。 - REST APIは一切使用せず、すべてJavaScript API(
kintone.app.record.get()/set()、getHeaderMenuSpaceElement()、getFormFields())のみで完結しています。kintone以外の外部サーバーへの通信・外部ライブラリも一切使用していません。 - 設定画面でのフィールド一覧・エラーメッセージの描画は
innerHTMLではなくtextContentのみを使用しており、DOMへ構造として解釈されません。 - 保存前のバリデーションで、テンプレート名・本文の未入力、挿入先フィールドの型不正、本文中の「[[」「]]」の対応の崩れ、繰り返しブロックがどのテーブルの列も指していない(または複数のテーブルにまたがる)ケース、ラジオボタン連動モードでの連動フィールド未選択など、不正な設定を検出して保存させません。
- 設定に含まれる挿入先フィールド・サブテーブルが実際のレコードに存在しない場合は早期リターンし、画面をクラッシュさせません。
詳細な確認項目・確認日は下記GitHubのチェックリストに全項目を掲載しています。
設定画面イメージ
![テンプレート挿入プラグインの設定画面。表示モード(通常モード/ラジオボタン連動モード)、テンプレート名・挿入先フィールド・本文、プレースホルダー挿入ツールバーと「選択範囲を[[ ]]で囲む」ボタンを設定する画面のスクリーンショット。](screenshots/config-screen.png)
API実行数について
このプラグインは、テンプレートの挿入・プレースホルダーの解決をすべてJavaScript API(kintone.app.record.get()/set())のみで行っており、kintoneのREST APIは一切実行しません。挿入ボタンを押したときにのみ、その場でレコードの値を読み書きします。