テンプレート記法

このページではkinToysのテンプレート記法について解説します。

%記法

kinToysでは、kintoneのフィールドを埋め込むテンプレートを実装しています。埋め込みはフィールドコードを指定してください。

%SINGLE_LINE_TEXT%

このように記述することで、SINGLE_LINE_TEXTというフィールドコードを持ったフィールドの値と置換されます。

フィールド単体の置換

例えばkintoneアプリに一行文字列フィールドを指定して、そのフィールドコードがSINGLE_LINE_TEXTだった場合に

このフィールドには『%SINGLE_LINE_TEXT%』と記入されています。

というテンプレートを記述したとします。このフィールドにあいうえおと記入してあるとすると、埋込後は以下の文章がクリップボードにコピーされます。

このフィールドには『あいうえお』と記入されています。

ループ記法

kinToysテンプレートはkintoneアプリにあるテーブルを展開できます。ループ記法は%fieldcode{で始まり、}%で終わります。

例えば、以下のようにテンプレートを記述することでJSONを出力できます。

[
%table{
  {
    "action": "%action%",
    "text": "%text%"
  } %joint%
}%
]

kinToysは今のところ条件分岐を持ちません。JSONでは繰り返しをカンマで表現しますが、繰り返しの終わりを判定できないため、kintoneアプリ側でカンマの要否を判定するフィールドを作成してください。

この例では%joint%というkintoneのフィールドにカンマを持たせることで繰り返しの最終要素を記述させました。他にもkintoneが持つ計算式を応用することで柔軟な記述が可能になるかと思います。

もしkintoneの機能を活用しても「この書き方ができない！」という場面があればご要望ください。