kintoneの「初期値」は、項目ごとに1つの値を決めておく機能です。今日の日付やログインユーザーは標準で入れられますが、「区分が法人なら担当部署に法人営業部」のように条件で入れる値を変えることはできません。 条件で変えたい場合は、JavaScriptを書くか無料プラグインを使います。
標準の初期値でできること
アプリの設定 →「フォーム」→ フィールドの歯車で、項目ごとに初期値を決められます。型によって決められる内容が違います。
| 型 | 標準の初期値で入れられるもの |
|---|---|
| 文字列・数値 | 決まった値(1つ) |
| ドロップダウン・ラジオボタン | 選択肢のどれか1つ |
| チェックボックス・複数選択 | 選択肢の組み合わせ |
| 日付・日時・時刻 | 決まった値、またはレコード登録時の日付・日時 |
| ユーザー選択 | 決まった人、またはログインユーザー |
| 組織選択 | 決まった組織、またはログインユーザーの優先する組織 |
受付日を今日にする、担当者をログインユーザーにする、は標準で足ります。 プラグインを入れる前に、まずここを確認してください。細かな仕様は変わることがあるので、最新はサイボウズの公式ヘルプで「初期値」「ログインユーザー 初期値」と検索して確かめてください。
標準の初期値でできないこと
| やりたいこと | 標準機能 |
|---|---|
| 区分によって担当部署を変える | できない |
| ログインした人の氏名を文字列の項目に入れる | できない |
| ログインした人の所属組織の名前を文字列の項目に入れる | できない |
| 条件を選び直したら、その場で入れ直す | できない |
| ほかの項目の値を初期値にする | できない |
いちばん多い相談は1行目です。「法人なら法人営業部、個人なら個人営業部」は、初期値が1つしか持てない以上、どちらかを選ぶしかありません。結果として毎回手で選び直すか、初期値のまま保存されて間違うかのどちらかになります。
後者のほうが困ります。初期値が「法人営業部」のままだと、個人のお客様のレコードも法人営業部に集計されます。入れ忘れは空欄として目に見えますが、初期値のまま残った値は間違いに見えません。
JavaScriptで書くとどうなるか
新規作成画面を開いたときと、区分を選び直したときに担当部署を入れる例です。
(() => {
'use strict';
const IF_FIELD = '区分';
const TO = '担当部署';
const MAP = { '法人': '法人営業部', '個人': '個人営業部' };
const fill = (event) => {
const r = event.record;
const v = MAP[r[IF_FIELD].value];
if (v && !r[TO].value) r[TO].value = v; // 入力済みなら触らない
// 受付者の氏名を文字列の項目に入れる
if (!r['受付者名'].value) r['受付者名'].value = kintone.getLoginUser().name;
return event;
};
kintone.events.on('app.record.create.show', fill);
kintone.events.on(`app.record.create.change.${IF_FIELD}`, (event) => {
const r = event.record;
const v = MAP[r[IF_FIELD].value];
if (v) r[TO].value = v; // 選び直したら入れ直す
return event;
});
})();
app.record.create.show は新規作成画面を開いたときのイベントです。kintone.getLoginUser() でログインした人のコードや氏名が取れます。
実運用で足りなくなるところ
- 再利用の上書き。「レコードを再利用する」で開いた画面でも
create.showが動く。値の入った項目を上書きしない判定を、項目ごとに書く必要がある - 0 の扱い。
!r[TO].valueの判定だと、数値の項目に入っている「0」を空欄とみなして書き換えてしまう - 所属組織。
getLoginUser()には組織が含まれないので、ユーザーAPIを別に呼ぶ - 型の変換。今の日時を日付の項目に入れる、選択肢とまったく同じ文字にそろえる、などの処理が要る
JavaScriptを書くかどうかの判断は13章 JavaScript・API・外部連携にまとめています。
設定だけで済ませる:初期値の条件設定(無料)
COTSUBUの無料プラグイン初期値の条件設定は、上の処理を設定画面で作れます。
- アプリの設定 →「プラグイン」→「初期値の条件設定」の歯車アイコン
- 「+ ルールを追加」で、いつ入れるかを選ぶ(常に入れる/すべての条件に当てはまるとき/どれか1つでも当てはまるとき)
- 条件を付ける場合は「もし[項目]が[値][と等しい など]」を作る
- 「そのとき、次の値を入れる」で項目と値の種類を選ぶ(「+ 入れる項目を追加」で増やせる)
- 入力済みの値も入れ直したいときだけ「すでに値が入っていても上書きする」にチェック
- 「保存する」→「アプリを更新」
入れられる値は8種類です。
| 値の種類 | 入る内容 |
|---|---|
| 決まった文字(固定値) | 設定した文字 |
| 今日の日付/今の日時 | 画面を開いた日付・時刻 |
| ログインしている人 | ユーザー選択の項目にその人 |
| ログインしている人の氏名/ログイン名 | 文字列として |
| ログインしている人の所属組織 | 組織選択、または文字列に組織名 |
| ほかの項目の値 | その項目の値をそのまま |
動きのルールは次のとおりです。
- 動くのは新規作成画面だけ。値の入っている項目は、上書き指定が無ければ触らない(数値の 0 も「入っている」扱い)
- 「条件に使った項目を変えたときも入れ直す」を付けると、区分を選び直した瞬間に入る
- 入れ先と値の型が合わないときは何もしない。保存は止めない
できないこともあります。サブテーブルの中の列には入れられず、一覧のインライン編集・CSV読み込み・APIからの登録では入りません。所属組織は、複数の組織に所属している人ならいちばん上の組織が入ります。モバイル画面にはまだ対応していません。連番が必要なら、別の無料プラグイン自動採番を使います(→kintoneで連番・自動採番を作る方法)。
無料・会員登録不要で、外部と通信しません。プラグインを使うにはスタンダードコース以上が必要です。
どれを使うかの早見表
| 状況 | 使うもの |
|---|---|
| 受付日を今日、担当者をログインユーザーにする | 標準の初期値 |
| 区分によって担当部署を変える | 初期値の条件設定 |
| 申請者の部署名を文字列で残す | 初期値の条件設定 |
| 前回と同じ内容で作る | 標準の「レコードを再利用する」 |
| 別アプリのマスタを見て初期値を決める | ルックアップ、またはJavaScript |
初期値を入れすぎない
初期値は入力を楽にしますが、入れすぎると確かめずに保存される値が増えます。
- その値が8割以上当たるか。当たらない項目に初期値を入れると、直し忘れがそのまま残る
- 間違ったときに気づけるか。集計に使う項目(担当部署・区分)は、初期値を入れずに空欄から選ばせるほうが安全な場合がある
- 必須と組み合わせる。空欄にしておいて必須にすれば、選び忘れは保存時に止まる
問い合わせ管理アプリなら、たとえば次のように分けます。
| 項目 | 初期値 | 理由 |
|---|---|---|
| 受付日 | 今日の日付 | ほぼ必ず当たる。違えば目で見て気づける |
| 受付者 | ログインユーザー | 入力した人が受付者であることが多い |
| 担当部署 | 区分に合わせて入れる | 区分で決まる。区分を選び直せば入れ直す |
| 対応状況 | 入れない(必須にする) | 集計に使う。初期値のまま残ると気づけない |
どの項目を入力補助で楽にして、どの項目を入力チェックで守るかの判断は7章 入力を守るにまとめています。
まとめ
- 標準の初期値は項目ごとに1つ。今日の日付・ログインユーザーは標準で入れられる
- 条件で値を変える、氏名や組織名を文字列で入れる、は標準ではできない
- JavaScriptなら書けるが、再利用時の上書きや 0 の扱いに注意が要る
- 設定だけで済ませるなら無料の初期値の条件設定
- 初期値は当たる項目にだけ入れる。外れると気づけない間違いになる
→ kintone導入支援の詳細 → kintone無料プラグイン一覧 → kintoneで別のフィールドに値をコピーする方法
よくある質問
kintoneの初期値に、今日の日付やログインユーザーを入れられますか
標準で入れられます。日付・日時のフィールドには「レコード登録時の日付(日時)を初期値にする」設定があり、ユーザー選択のフィールドには初期値として「ログインユーザー」を指定できます。できないのは、条件によって入れる値を変えることと、ログインした人の氏名や所属組織を文字列の項目に入れることです。
初期値は、一覧のインライン編集やCSV読み込みでも入りますか
JavaScriptやプラグインで入れる初期値は、新規作成画面を開いたときに動くため、インライン編集・CSV読み込み・APIからの登録では入りません。標準の初期値とは動く経路が違う点に注意してください。
「レコードを再利用する」で作ったときに、初期値で上書きされませんか
再利用で開いた画面も新規作成画面なので、JavaScriptで何も考えずに書くと上書きします。値が入っている項目は触らない書き方にしてください。無料プラグインの初期値の条件設定は、上書きを指定したルール以外は、値の入った項目に触りません。


