株式会社XenoX

マニュアル›自動入力プラグイン

自動入力プラグイン マニュアル

このプラグインでできること

「自動入力プラグイン」は、条件に合うときに、式の結果やほかのフィールドの値をフィールドへ自動で入れるプラグインです。
金額や税込の計算、翌月末の期限、会社名の略称、テーブルの小計など、毎回手で入れていた値をルールにしておけます。式は kintone の計算式と同じ書き方です。

自動入力プラグインの紹介ページを見る

主な機能は次のとおりです。

  • 「いつ」「どんな条件のとき」「どのフィールドに」「何を入れるか」をルールにして、自動で入力する
  • 入れる値は「式の結果」「ほかのフィールドの値」「固定の値」「ログインユーザー」「空にする」から選べる
  • 式は kintone の計算式と同じ書き方で、日付・文字・数値・テーブルの関数が42種類使える
  • テーブルの中のフィールドには、行ごとに計算して入れる
  • ルールは複数作れて、タブの順に動く。あるルールが入れた値を使うルールも続けて動く
  • PC版・モバイル版の追加・編集画面と、一覧のインライン編集で動作する

プラグインを入れる前。略称・日付・金額・税込・小計・備考は、ひとつずつ計算して手で入れる

プラグインを入れる前。略称・日付・金額・税込・小計・備考は、ひとつずつ計算して手で入れる

プラグインを入れた後。会社名・数量・単価・区分・明細を入れると、黄色の欄が自動で入る

プラグインを入れた後。会社名・数量・単価・区分・明細を入れると、黄色の欄が自動で入る

こんな場面で役立ちます。

  • 見積や案件のアプリで、数量×単価の金額・税込・支払期限を毎回計算している
  • レコードを追加するたびに、受付日に今日、担当者に自分、といった同じ値を入れている
  • 区分や種別によって、入れる値や印を変えたい
  • 計算フィールドでは作れない「月末の日付」「文字の置き換え」「和暦」などを使いたい

💡 計算フィールドとは違い、値は普通のフィールドに入ります。入ったあとに手で直すこともできます(「入力先が空のときだけ入れる」にすると、手で入れた値を上書きしません)。

動作環境・前提条件

2-1. 事前に必要な設定

値を入れるフィールド(入力先)と、式や条件で使うフィールドを、アプリに用意しておきます。
専用のフィールドを追加する必要はありません。

2-2. 必要な権限

対象必要な権限
プラグインを設定する人アプリの管理権限
レコードを入力する人入力先のフィールドを編集できる権限(kintone 標準のフィールドの権限に従います)

2-3. 対応する画面

画面対応
レコード追加・編集画面(PC版・モバイル版)対応
レコード一覧のインライン編集「値が変わったとき」「保存するとき」だけ対応(テーブルは対象外)
レコード詳細画面対象外
CSVの読み込み、API・ほかのプラグインによる更新対象外

2-4. 入力先にできるフィールド

文字列(1行・複数行)、リッチエディター、数値、リンク、ドロップダウン、ラジオボタン、チェックボックス、複数選択、日付、時刻、日時、ユーザー選択、組織選択、グループ選択です。

次のフィールドは kintone が値を決めるため、入力先にできません。

  • 計算フィールド
  • ルックアップのコピー先のフィールド
  • 自動計算を設定した文字列(1行)
  • 添付ファイル、レコード番号、作成者・更新者・作成日時・更新日時、ステータス、作業者、カテゴリー

💡 ルックアップのフィールド(キー側)には値を入れられます。値を入れると、そのまま参照先のデータの取得まで行います。

設定手順

3-1. プラグインを追加する

  1. アプリの設定画面を開き、「設定」タブの「プラグイン」をクリックします。
  2. 「追加する」をクリックし、「自動入力プラグイン」にチェックを入れて「追加」をクリックします。
  3. プラグインの一覧で、自動入力プラグインの歯車のアイコンをクリックすると、設定画面が開きます。

3-2. ルールを作る

  1. タブの「+」をクリックして、ルールを追加します。
  2. 「ルール名」を入力します(例:金額の計算)。右のスイッチで、ルールの有効・無効を切り替えられます。
  3. 「実行するタイミング」を選びます(3-3 を参照)。
  4. 必要なら「条件」を設定します(3-4 を参照)。条件が無いときは、いつも実行します。
  5. 「入力する内容」で、入力先のフィールドと入れる値を設定します(3-5 を参照)。

ルールの設定画面。目的ごとのルールがタブで並び、ルール名・実行するタイミング・条件を設定する

ルールの設定画面。目的ごとのルールがタブで並び、ルール名・実行するタイミング・条件を設定する

ルールは左のタブから順に実行します。タブはドラッグで並べ替えられます。
あるルールが入れた値を条件や式で使っている別のルールも、続けて実行します(例:「金額」を計算したあと、「金額」を使う「税込」を計算する)。

3-3. 実行するタイミング

複数選べます。

タイミング動くとき
追加画面を開いたときレコードの追加画面を開いたとき(再利用は含みません)
レコードを再利用したとき「再利用する」で追加画面を開いたとき
編集画面を開いたときレコードの編集画面を開いたとき
値が変わったとき条件・式・コピー元で参照しているフィールドの値が変わったとき
保存するとき保存ボタンを押したとき(保存の直前)

💡 「値が変わったとき」は、条件・式・コピー元でフィールドを参照しているルールだけが動きます。どのフィールドも参照していないルールでは、設定画面に注意が出ます。

3-4. 条件

  1. 「すべての条件を満たす」(AND)か「いずれかの条件を満たす」(OR)を選びます。
  2. 「+ 条件を追加」をクリックし、フィールド(またはステータス)、比べ方、値を設定します。条件は10件まで設定できます。
比べ方使えるフィールドの例
=(一致する)・≠(一致しない)文字列、数値、日付など
>・<・≧・≦数値、日付、時刻、日時
次のいずれかに一致する・次のいずれにも一致しないドロップダウン、チェックボックス、ユーザー選択など
次を含む・次を含まない文字列
空欄である・空欄でない多くのフィールド

値には固定の値のほか、関数として「今日」「昨日」「明日」「今日から○○後」「現在日時」「ログインユーザー」を選べます(フィールドの種類によります)。
ステータスはプロセス管理が有効なアプリで使えます。

💡 テーブルの中のフィールドを条件にすると、入力先が同じテーブルにあるときは行ごとに判定します。

「区分がBのとき」の条件と、色に「青」、備考に式の結果を入れる設定

「区分がBのとき」の条件と、色に「青」、備考に式の結果を入れる設定

3-5. 入力する内容

「+ 入力先を追加」をクリックし、次の項目を設定します。1つのルールに30件まで設定できます。

項目内容
入力先のフィールド値を入れるフィールド
入れる値式の結果/ほかのフィールドの値/固定の値/ログインユーザー(ユーザー選択のみ)/空にする
入力先が空のときだけ入れるチェックすると、入力先にすでに値があるときは上書きしません

追加画面を開いたときに、受付日に今日、担当者にログインユーザー、期限に翌月末を入れる設定

追加画面を開いたときに、受付日に今日、担当者にログインユーザー、期限に翌月末を入れる設定

  • 「ほかのフィールドの値」は、入力先と同じ種類の値を持つフィールドから選びます(例:数値には数値・計算・文字列(1行)など)。
  • 「固定の値」は、入力先の種類に合わせた入力欄(選択肢・日付・ユーザーなど)で入れます。
  • ラジオボタンは「空にする」を選べません。

3-6. 式の書き方

式は kintone の計算式と同じ書き方です。設定画面の「式の書き方と、使える関数」でも確かめられます。

  • フィールドの値は、フィールドコードをそのまま書きます(例:数量*単価)。
  • 文字は "" で囲みます(例:"区分:")。囲んだものは必ず文字として扱います。
  • 文字をつなげるときは & を使います(例:区分 & "区分:" & DATE_FORMAT(TODAY(),"Y/m/d"))。
  • 計算は + - * / %、比較は = != < <= > >= です。+ は数値の足し算だけで、文字はつなげません。
  • 全角の記号(()+*& など)は半角として読みます。
  • 0で割ると、結果は空になります。

式の欄の下の「フィールドを挿入」「関数を挿入」から、カーソルの位置にフィールドや関数を差し込めます。
入力するたびに式を確かめ、誤りがあれば何文字目かと直し方を表示します。

文字を + でつないだ式に、「+ は数値の足し算です。文字をつなげるときは & を使ってください(27文字目)」と表示されている

文字を + でつないだ式に、「+ は数値の足し算です。文字をつなげるときは & を使ってください(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. 「設定出力」で保存したファイルを、ほかのアプリの設定画面の「設定読込」で読み込みます。フィールドコードが違う箇所は、設定し直してください。

« マニュアルの一覧に戻る