このプラグインでできること
「自動入力プラグイン」は、条件に合うときに、式の結果やほかのフィールドの値をフィールドへ自動で入れるプラグインです。
金額や税込の計算、翌月末の期限、会社名の略称、テーブルの小計など、毎回手で入れていた値をルールにしておけます。式は kintone の計算式と同じ書き方です。
主な機能は次のとおりです。
- 「いつ」「どんな条件のとき」「どのフィールドに」「何を入れるか」をルールにして、自動で入力する
- 入れる値は「式の結果」「ほかのフィールドの値」「固定の値」「ログインユーザー」「空にする」から選べる
- 式は kintone の計算式と同じ書き方で、日付・文字・数値・テーブルの関数が42種類使える
- テーブルの中のフィールドには、行ごとに計算して入れる
- ルールは複数作れて、タブの順に動く。あるルールが入れた値を使うルールも続けて動く
- PC版・モバイル版の追加・編集画面と、一覧のインライン編集で動作する
プラグインを入れる前。略称・日付・金額・税込・小計・備考は、ひとつずつ計算して手で入れる
プラグインを入れた後。会社名・数量・単価・区分・明細を入れると、黄色の欄が自動で入る
こんな場面で役立ちます。
- 見積や案件のアプリで、数量×単価の金額・税込・支払期限を毎回計算している
- レコードを追加するたびに、受付日に今日、担当者に自分、といった同じ値を入れている
- 区分や種別によって、入れる値や印を変えたい
- 計算フィールドでは作れない「月末の日付」「文字の置き換え」「和暦」などを使いたい
💡 計算フィールドとは違い、値は普通のフィールドに入ります。入ったあとに手で直すこともできます(「入力先が空のときだけ入れる」にすると、手で入れた値を上書きしません)。
動作環境・前提条件
2-1. 事前に必要な設定
値を入れるフィールド(入力先)と、式や条件で使うフィールドを、アプリに用意しておきます。
専用のフィールドを追加する必要はありません。
2-2. 必要な権限
| 対象 | 必要な権限 |
|---|---|
| プラグインを設定する人 | アプリの管理権限 |
| レコードを入力する人 | 入力先のフィールドを編集できる権限(kintone 標準のフィールドの権限に従います) |
2-3. 対応する画面
| 画面 | 対応 |
|---|---|
| レコード追加・編集画面(PC版・モバイル版) | 対応 |
| レコード一覧のインライン編集 | 「値が変わったとき」「保存するとき」だけ対応(テーブルは対象外) |
| レコード詳細画面 | 対象外 |
| CSVの読み込み、API・ほかのプラグインによる更新 | 対象外 |
2-4. 入力先にできるフィールド
文字列(1行・複数行)、リッチエディター、数値、リンク、ドロップダウン、ラジオボタン、チェックボックス、複数選択、日付、時刻、日時、ユーザー選択、組織選択、グループ選択です。
次のフィールドは kintone が値を決めるため、入力先にできません。
- 計算フィールド
- ルックアップのコピー先のフィールド
- 自動計算を設定した文字列(1行)
- 添付ファイル、レコード番号、作成者・更新者・作成日時・更新日時、ステータス、作業者、カテゴリー
💡 ルックアップのフィールド(キー側)には値を入れられます。値を入れると、そのまま参照先のデータの取得まで行います。
設定手順
3-1. プラグインを追加する
- アプリの設定画面を開き、「設定」タブの「プラグイン」をクリックします。
- 「追加する」をクリックし、「自動入力プラグイン」にチェックを入れて「追加」をクリックします。
- プラグインの一覧で、自動入力プラグインの歯車のアイコンをクリックすると、設定画面が開きます。
3-2. ルールを作る
- タブの「+」をクリックして、ルールを追加します。
- 「ルール名」を入力します(例:金額の計算)。右のスイッチで、ルールの有効・無効を切り替えられます。
- 「実行するタイミング」を選びます(3-3 を参照)。
- 必要なら「条件」を設定します(3-4 を参照)。条件が無いときは、いつも実行します。
- 「入力する内容」で、入力先のフィールドと入れる値を設定します(3-5 を参照)。
ルールの設定画面。目的ごとのルールがタブで並び、ルール名・実行するタイミング・条件を設定する
ルールは左のタブから順に実行します。タブはドラッグで並べ替えられます。
あるルールが入れた値を条件や式で使っている別のルールも、続けて実行します(例:「金額」を計算したあと、「金額」を使う「税込」を計算する)。
3-3. 実行するタイミング
複数選べます。
| タイミング | 動くとき |
|---|---|
| 追加画面を開いたとき | レコードの追加画面を開いたとき(再利用は含みません) |
| レコードを再利用したとき | 「再利用する」で追加画面を開いたとき |
| 編集画面を開いたとき | レコードの編集画面を開いたとき |
| 値が変わったとき | 条件・式・コピー元で参照しているフィールドの値が変わったとき |
| 保存するとき | 保存ボタンを押したとき(保存の直前) |
💡 「値が変わったとき」は、条件・式・コピー元でフィールドを参照しているルールだけが動きます。どのフィールドも参照していないルールでは、設定画面に注意が出ます。
3-4. 条件
- 「すべての条件を満たす」(AND)か「いずれかの条件を満たす」(OR)を選びます。
- 「+ 条件を追加」をクリックし、フィールド(またはステータス)、比べ方、値を設定します。条件は10件まで設定できます。
| 比べ方 | 使えるフィールドの例 |
|---|---|
| =(一致する)・≠(一致しない) | 文字列、数値、日付など |
| >・<・≧・≦ | 数値、日付、時刻、日時 |
| 次のいずれかに一致する・次のいずれにも一致しない | ドロップダウン、チェックボックス、ユーザー選択など |
| 次を含む・次を含まない | 文字列 |
| 空欄である・空欄でない | 多くのフィールド |
値には固定の値のほか、関数として「今日」「昨日」「明日」「今日から○○後」「現在日時」「ログインユーザー」を選べます(フィールドの種類によります)。
ステータスはプロセス管理が有効なアプリで使えます。
💡 テーブルの中のフィールドを条件にすると、入力先が同じテーブルにあるときは行ごとに判定します。
「区分がBのとき」の条件と、色に「青」、備考に式の結果を入れる設定
3-5. 入力する内容
「+ 入力先を追加」をクリックし、次の項目を設定します。1つのルールに30件まで設定できます。
| 項目 | 内容 |
|---|---|
| 入力先のフィールド | 値を入れるフィールド |
| 入れる値 | 式の結果/ほかのフィールドの値/固定の値/ログインユーザー(ユーザー選択のみ)/空にする |
| 入力先が空のときだけ入れる | チェックすると、入力先にすでに値があるときは上書きしません |
追加画面を開いたときに、受付日に今日、担当者にログインユーザー、期限に翌月末を入れる設定
- 「ほかのフィールドの値」は、入力先と同じ種類の値を持つフィールドから選びます(例:数値には数値・計算・文字列(1行)など)。
- 「固定の値」は、入力先の種類に合わせた入力欄(選択肢・日付・ユーザーなど)で入れます。
- ラジオボタンは「空にする」を選べません。
3-6. 式の書き方
式は kintone の計算式と同じ書き方です。設定画面の「式の書き方と、使える関数」でも確かめられます。
- フィールドの値は、フィールドコードをそのまま書きます(例:
数量*単価)。 - 文字は
""で囲みます(例:"区分:")。囲んだものは必ず文字として扱います。 - 文字をつなげるときは
&を使います(例:区分 & "区分:" & DATE_FORMAT(TODAY(),"Y/m/d"))。 - 計算は
+ - * / %、比較は= != < <= > >=です。+は数値の足し算だけで、文字はつなげません。 - 全角の記号(()+*& など)は半角として読みます。
- 0で割ると、結果は空になります。
式の欄の下の「フィールドを挿入」「関数を挿入」から、カーソルの位置にフィールドや関数を差し込めます。
入力するたびに式を確かめ、誤りがあれば何文字目かと直し方を表示します。
文字を + でつないだ式に、「+ は数値の足し算です。文字をつなげるときは & を使ってください(27文字目)」と表示されている
使える関数は次のとおりです。
| 分類 | 関数 |
|---|---|
| 条件 | IF、AND、OR、NOT、LIKE |
| 日付 | TODAY、NOW、DATE_CALC、DATE_DIFF、DATE_FORMAT、DATE_STRING(和暦)、AGE(満年齢)、WEEK_CALC(曜日の番号) |
| 文字 | LEFT、RIGHT、MID、LEN、LENB、LPAD、RPAD、REPLACE、SUBSTITUTE、ASC、TRIM、UPPER、LOWER、LINES、TO_STRING、LOGINUSER |
| 数値 | TO_NUMBER、ROUND、ROUNDUP、ROUNDDOWN、ABS、MATH |
| テーブル | SUM、MAX、MIN、ROWS、FIRST、LAST、ROW_NO |
式の例です。
| 入れたい値 | 式 |
|---|---|
| 金額 | 数量*単価 |
| 税込(切り捨て) | ROUNDDOWN(金額*1.1) |
| 翌月末の日付 | DATE_CALC(TODAY(),"1 month,last-of-month") |
| 会社名の略称 | REPLACE(会社名,"株式会社","(株)") |
| 明細の合計 | SUM(小計) |
3-7. テーブルの中のフィールドに入れる
入力先にテーブルの中のフィールドを選ぶと、テーブルの全行に、行ごとに計算して入れます。式ではその行の値を同じ書き方で参照できます(例:明細数量*明細単価)。
行を追加・削除したときも、計算し直します。
明細の各行に小計が入り、種別が「特急」の行だけ行備考に「急ぎ」が入る
- テーブルの外のフィールドから、テーブルの中のフィールドを参照すると、最後の行の値を使います。合計などがほしいときは SUM などの関数を使います。
- SUM・MAX・MIN・ROWS の2つ目に
trueと書くと、ルールの条件に合う行だけを集計します。 - ROW_NO() で、処理している行が何行目かを使えます。
3-8. 保存する
「設定保存」をクリックします(Ctrl+S でも保存できます)。設定の確認のあと、アプリの更新まで自動で行います。
「設定を保存して、アプリを更新しました」と表示されたら完了です。
💡 設定に誤りがあるときは、「設定に誤りがあります」と内容の一覧が表示されます。直してからもう一度保存してください。
「設定出力」で設定を JSON ファイルに保存し、「設定読込」でほかのアプリに読み込めます。読み込んだあとは「設定保存」を押して確定します。
使い方
4-1. 入力する
設定したアプリでレコードを追加・編集すると、ルールのタイミングで値が自動で入ります。
- 「追加画面を開いたとき」のルールは、画面を開いた時点で値が入ります。
- 「値が変わったとき」のルールは、参照しているフィールドを入力して、カーソルがほかへ移った時点で値が入ります。
- 「保存するとき」のルールは、保存ボタンを押したときに値を入れてから保存します。
4-2. 入った値を直す
自動で入った値は、手で直せます。
ただし、同じルールが「値が変わったとき」や「保存するとき」にもう一度動くと、上書きされます。手で直した値を残したいときは、そのルールで「入力先が空のときだけ入れる」にチェックを入れてください。
4-3. スマートフォンで使う
kintone のモバイル版の追加・編集画面でも、PC版と同じように動きます。
制限事項・注意点
- 詳細画面、CSVの読み込み、API・ほかのプラグインによる更新では動きません。
- 一覧のインライン編集では、「値が変わったとき」「保存するとき」だけ動きます。 テーブルの中のフィールドは対象外です。
- 同じフィールドに複数のルールが値を入れると、後(右)のタブのルールの値が残ります。 設定画面にも注意が出ます。
- ふりがな(PHONETIC)には対応していません。
- 入力先の値と同じ値は書き込みません。 ルックアップのデータを取り直すなどの余計な動きは起きません。
- 値を入れられないときは、その入力先だけを飛ばします。 選択肢にない値、数値や日付として読めない値などは入れず、ほかの入力先は続けて入れます。レコードの保存は止めません。
- ステータスを条件にしたルールは、追加画面では動きません。 追加画面ではステータスがまだ無いためです。
- 上限は、ルール50件、1ルールの条件10件、入力先30件です。
困ったときは
6-1. 表示されるメッセージ(設定画面)
| メッセージ | 内容 |
|---|---|
| 設定に誤りがあります | 保存できない設定があります。一覧に出た箇所を直してください |
| 「+ は数値の足し算です。文字をつなげるときは & を使ってください」 | 文字をつなぐときは & を使います |
| 「「○○」というフィールドがありません。文字は "" で囲んでください」 | フィールドコードの書き間違いか、文字を "" で囲んでいません |
| 「文字("○○")は計算できません。…」 | フィールドを "" で囲んでいます。"" を外してください |
| 設定は保存しましたが、アプリを更新できませんでした | アプリの設定画面で「アプリを更新」を押してください |
レコード画面では、このプラグインが独自に出すメッセージはありません。
6-2. 確認ポイント
| 症状 | 確認すること |
|---|---|
| 値が入らない | ルールが「有効」になっているか。タイミングと条件が合っているか |
| 「値が変わったとき」で動かない | そのルールの条件・式・コピー元で、変えたフィールドを参照しているか |
| 再利用したときに動かない | 「レコードを再利用したとき」にチェックが入っているか(追加とは別のタイミングです) |
| 入力先の一覧に目的のフィールドが出ない | 計算フィールド、ルックアップのコピー先、自動計算の文字列ではないか |
| ドロップダウンなどに値が入らない | 入れようとした値が、選択肢にあるか |
| すでに値があると変わらない | 「入力先が空のときだけ入れる」にチェックが入っていないか |
| テーブルの外に入れた値が最後の行の値になる | テーブルの中のフィールドを直接参照しています。合計なら SUM を使ってください |
| 2つのルールで値が意図と違う | 後(右)のルールの値が残ります。タブの順番を確かめてください |
6-3. よくある質問
Q. 計算フィールドとの違いは?
A. 計算フィールドは式の結果がそのまま値になり、手で直せません。このプラグインは普通のフィールドに値を入れるので、条件で入れる値を変えたり、文字や日付を加工したりできます。
Q. 手で入れた値を上書きしたくない
A. 「入力先が空のときだけ入れる」にチェックを入れてください。
Q. ほかのアプリにも同じ設定を使いたい
A. 「設定出力」で保存したファイルを、ほかのアプリの設定画面の「設定読込」で読み込みます。フィールドコードが違う箇所は、設定し直してください。