フォームスタジオ（入力規則） 詳細マニュアル

基本情報

プラグインID	field-validation
対象バージョン	v1.5.0(配布中の最新版)
カテゴリ	入力効率化
説明	条件や数式による入力チェック・警告・整形をレコード保存時に適用します。Web公開ライセンスで Web フォームとしても公開できます。

動作条件

対応環境	kintone スタンダードコース。デスクトップ版UIとモバイル版UI(ブラウザ)の両方で動作します。最新版の Chrome / Edge / Safari / Firefox に対応。
動作画面	レコードの追加・編集画面、一覧画面のインライン編集、モバイル画面、プロセス管理のアクション(設定したルールのみ)。一覧画面には「入力規則をチェック」ボタンが表示されます。
必要な権限	プラグインの設定にはアプリ管理権限。利用者側は通常のレコード追加・編集権限だけで動作します。
設定	入力ルールを1つ以上設定してください(整形・テーブル設定・住所セットだけでも動作します)。

設定項目リファレンス

プラグイン設定の全項目です。「項目」は設定データ(エクスポートファイルの config)のキーを表し、[] は配列の要素を意味します。設定画面での入力項目と1対1に対応します。この構造の正式な定義はJSON Schema(catalog.json の configSchema)として公開しています。

設定のポイント

• rules(入力ルール)は上から順に評価されます。各ルールは 対象フィールド(field: エラーを表示するフィールド1つ)・条件(when)・結果(action: BLOCK=エラー / WARN=警告)・メッセージ(message)で構成します。設定画面の「ルールを追加」で対象フィールドを選ぶと、その型に合う「よくあるルール」(必須・書式・範囲・日付の前後関係など)がおすすめされ、選ぶだけで条件とメッセージが埋まります。
• 条件は「選択式」(when.builder: フィールド・演算子・値のフォームパーツ)と「数式」(when.formula)を1つのルールに両方持て、when.mode でどちらを採用するかを選びます。数式はフィールドコードで値を参照し、AND / OR / NOT / ISBLANK / ISPICKVAL / REGEX / LEN / TODAY / DATEDIFF / ISNEW / ISCHANGED / PRIORVALUE などの関数が使えます(関数一覧は設定画面の「関数」ボタンで確認できます)。
• message には {フィールドコード} で値、{フィールドコード:label} でフィールド名、{$rule} でルール名を埋め込めます。言語別({ja, en, zh, zh-TW})に書くと、利用者の表示言語に合わせて切り替わります。「自動生成」ボタンで条件から文面を作れます。
• screens(適用する画面)は既定で 追加・編集・一覧のインライン編集・モバイル・Webフォーム に適用されます。プロセス管理のアクション(process)だけは明示的に選び、必要なら process.nextStatus で「このステータスへ進めるときだけ」に絞れます。applyTo で新規のみ・編集のみに限定できます。
• trigger.onChange を有効にすると、条件が参照するフィールドの値が変わったその場でも評価し、フィールドの脇に結果を表示します(保存時の評価も行われます)。
• scope.table を指定すると、テーブルの各行でルールを評価します(対象フィールドはその列)。数式では行の列をフィールドコードで参照でき、ROWINDEX() で行番号を取れます。テーブル全体の行数の下限・上限や重複禁止列は table(テーブル設定)で指定します。
• users(適用するユーザー)で、特定のユーザー・グループ・組織にだけ適用する/適用しないを指定できます。
• formatters(整形)は保存時、入力ルールの評価より前に適用されます。前後の空白除去、全角・半角の統一、カタカナ/ひらがな変換、大文字・小文字、ハイフンの統一、電話番号・郵便番号の書式、数字だけ残す、Unicode正規化(NFKC)を順に組み合わせられます。
• addressSets(住所セット)は、郵便番号・都道府県・市区町村・住所1(町域・番地)・住所2(建物名)・住所(結合)のフィールドを割り当てる設定です。郵便番号が7桁になったときに都道府県・市区町村・町域を自動入力し、保存時に郵便番号の整形と結合住所の生成を行います。検証ルール(書式・条件付き必須・郵便番号と住所の不一致・番地未入力の警告)は rules に source:{type:"address"} 付きで自動生成されるので、手で編集せず住所セット側を変更してください。自動入力には郵便番号の先頭3桁を当社サーバー(api.kintauros.site)へ送るため、初回設定時に管理者の同意(options.postalConsent)が必要です。
• options.showSummaryOnTop(既定 true)で、エラー時に画面上部へメッセージをまとめて表示するかを切り替えられます。options.warnTitle で警告の確認ダイアログの見出しを変えられます。
• publish(Web公開)は、Web公開ライセンス(KINTAUROS Publish)を利用する場合の設定で、設定画面の「Web公開機能を利用する」から共通ランタイムが管理します。公開するフォーム(publish.forms: 1アプリに5つまで)ごとに、含めるフィールド・表示/読み取り専用/非表示・初期値・URLパラメータ名・ラベルの上書き・完了メッセージ・転送先・ボット対策・受付停止を設定できます。追加専用APIトークンと復号鍵はこの設定には保存されません。

動作仕様

• 保存時の流れ: 整形(formatters)→ 郵便番号の整形・結合住所の生成(addressSets)→ 入力ルールの評価(rules)→ テーブル設定(table)。エラー(BLOCK)が1つでも当てはまると保存は中止され、対象フィールドの脇と画面上部にメッセージを表示します。エラーが無く警告(WARN)だけのときは確認ダイアログを出し、「このまま保存」で保存できます。
• 入力中の評価(trigger.onChange): 条件が参照するフィールドの change イベントで評価し、対象フィールドの脇にエラー/警告を表示します。保存は止めません(保存時に改めて評価します)。
• ISNEW / ISCHANGED / PRIORVALUE などレコードの変更前の値を使う関数は、画面を開いたときのレコードのスナップショットと比較します。一覧のインライン編集・モバイルでも同じです。Webフォームでは変更前の値が無いため、PRIORVALUE は空、ISCHANGED は FALSE、$User は空になります(数式の $Screen で画面を判別できます)。
• プロセス管理のアクション(screens に process を含むルール)は、アクション実行時にレコードの値で評価し、エラーならアクションを中止します。
• 一覧画面の「入力規則をチェック」: 表示中の一覧(絞り込み条件を含む)の全レコードを、保存時と同じルールで評価し、違反のあるレコードとメッセージを一覧表示します(書き込みは行いません)。REST API や CSV 読み込みで登録・更新されたレコードは保存時のチェックを通らないため、その点検に使います。走査は先頭1万件までです。
• 住所の自動入力: 郵便番号フィールドが7桁になると、都道府県・市区町村・住所1(町域)に値を入れます。同じ郵便番号に複数の住所がある場合は選択ダイアログを表示します。都道府県フィールドがドロップダウンの場合は選択肢のラベル(「東京都」など)に合わせます。取得した郵便番号データはブラウザ内(localStorage)に7日間保持し、同じ先頭3桁は再取得しません。
• ルールの評価中に例外(構文エラーなど)が起きたときは、そのルールだけを「判定不能」として扱い、保存は止めません(フェイルオープン)。ブラウザのコンソールにエラーコード E202 で記録されます。
• 外部通信: 判定はすべてブラウザ内で行われ、レコードの内容が当社(KINTAUROS)のサーバーに送信されることはありません。例外は住所セットの自動入力で、管理者が設定画面で同意したときだけ、郵便番号の先頭3桁のみを当社サーバー(api.kintauros.site)へ送って日本郵便の郵便番号データの該当部分を受け取ります(下4桁・他のフィールド・kintoneのドメイン名・利用者情報は送らず、当社はリクエストを保存・集計しません。到達できないときは自動入力を止めるだけで保存は妨げません)。このほかの通信はライセンス確認(kintoneドメイン名・プラグインID・バージョンのみ)です。Web公開ライセンスでWebフォームを公開した場合は、フォームの定義と送信者の入力内容が当社の運用するCloudflareに届き、kintoneへの登録完了後に削除されます(登録に失敗した分だけ暗号化して最長30日保管し、自動再試行の後はkintone管理者だけが復号できる鍵で保管します)。

制限事項・既知の仕様

• REST API・CSV読み込み・他プラグインによる登録・更新には入力ルールが適用されません(一覧の「入力規則をチェック」で事後に点検できます)。
• 条件・数式で参照できるフィールドは 文字列(1行/複数行)・リッチエディター・数値・計算・日付・時刻・日時・ドロップダウン・ラジオボタン・チェックボックス・複数選択・ユーザー/組織/グループ選択・リンク・レコード番号・作成者/更新者・作成日時/更新日時・ステータス・テーブルの列 です。添付ファイル・関連レコード一覧は参照できません。
• 数式は4,000文字・ネスト32段まで。REGEX のパターンは500文字までで、入れ子の量指定子など処理が重くなるパターンは警告されます。
• 「入力規則をチェック」の走査は表示中の一覧の先頭1万件までです。
• 住所の自動入力は日本国内の郵便番号(日本郵便の郵便番号データ)のみです。事業所の個別郵便番号にも対応しますが、番地・建物名は自動入力されません(町域までを入れ、番地は利用者が追記します)。データは月次で更新されます。
• Webフォームに出せるフィールドは 文字列(1行/複数行)・数値・日付・時刻・日時・ドロップダウン・ラジオボタン・チェックボックス・複数選択・リンク です。添付ファイル・テーブルは今後の対応予定です。Webフォームでは、フォームに含めたフィールドだけで判定できるルールが適用されます。

設定のインポート / エクスポート

プラグイン設定画面の上部にある「設定のインポート / エクスポート」から、現在の設定をJSONファイルとして書き出し(エクスポート)、別のアプリで読み込み(インポート)できます。検証用アプリから本番アプリへの設定コピーや、バックアップ・復元にご利用ください。

• インポートは取り込む内容の差分を確認してから「設定画面に反映」し、最後に「保存」を押して確定します(反映しただけでは保存されません)。
• 読み込んだファイルはブラウザ内で処理され、KINTAUROSのサーバーには送信されません。
• 別のアプリの設定を取り込んだ場合、このアプリに存在しないフィールドは警告として一覧表示されるので、反映後に該当箇所を選び直してください。

エクスポートファイルは次の形式(封筒形式)です。config の中身が設定本体で、その構造は上の設定項目リファレンスのとおりです。

{
  "kintauros": "config/v1",
  "plugin": "<プラグインID>",
  "pluginName": "<プラグイン名>",
  "pluginVersion": "<バージョン>",
  "exportedAt": "<書き出し日時(ISO 8601)>",
  "sourceApp": "<書き出し元アプリID>",
  "config": { ... 設定本体 ... }
}

AIエージェント向け: ブラウザコンソールAPI

各プラグインは共通ランタイム window.KINTAUROS を搭載しており、ブラウザの開発者コンソールから設定の読み取り・検証・保存ができます。設定の保存(save: true)はkintoneの制約上、プラグイン設定画面でのみ成功します。

KINTAUROS.config.plugins()                   // このページのKINTAUROSプラグインID一覧
KINTAUROS.config.describeAll()               // 同居プラグインすべての設定サマリ
KINTAUROS.config.of('<プラグインID>').schema()    // 設定のJSON Schema
KINTAUROS.config.of('<プラグインID>').export()    // 現在の設定(封筒つき)
KINTAUROS.config.of('<プラグインID>').validate(x) // 保存せず検証
KINTAUROS.config.of('<プラグインID>').diff(x)     // 現在の設定との差分
await KINTAUROS.config.of('<プラグインID>').import(x, { save: true }) // 検証して保存(設定画面のみ)

登録が1件だけのページでは of(...) を省略できます(例: KINTAUROS.config.export())。

トラブルシューティング

ルールを設定したのにエラーが出ない

アプリにプラグインが追加され「アプリを更新」済みかを確認してください。ルールの「適用する画面」に該当する画面が含まれているか、「適用する操作」が新規のみ/編集のみになっていないか、「適用するユーザー」で除外されていないかも確認してください。数式に構文エラーがあると、そのルールは判定不能として無視されます(設定画面の構文チェックで確認できます)。

条件に当てはまらないはずなのにエラーになる

条件は「TRUE になったらエラー」です。「必須にしたい」場合は ISBLANK(フィールド) のように「空ならエラー」の形で書きます。選択式と数式の両方を持つルールは、「採用する条件」で選んだ方だけが評価されます。整形(formatters)は評価の前に適用されるため、整形後の値で判定される点にもご注意ください。

住所が自動入力されない

設定画面の「4. 住所」で住所データの取得への同意にチェックが入っているか、郵便番号フィールドの割り当てが正しいかを確認してください。郵便番号は7桁(ハイフンや全角でも可)になった時点で取得します。ブラウザから api.kintauros.site への通信がネットワーク機器などで遮断されている場合も自動入力は動きません(この場合も保存はできます)。

警告の確認ダイアログを出さずに保存させたい

そのルールの結果を「警告」ではなく「エラー」にするか、ルールを無効にしてください。警告は必ず確認ダイアログを伴います。

E001: 設定されたフィールドが見つかりません

設定後にルール・整形・住所セットが参照するフィールドが削除・変更された状態です。プラグイン設定画面を開き、現在のフォームに合わせて対象フィールドを選び直して保存してください。

E202: ルールを評価できませんでした

数式の構文エラーや、フィールドの型に合わない関数の使い方が原因です。設定画面でそのルールを開き、「構文チェック」の結果に従って修正してください。この状態でも保存は止まりません(そのルールだけが無視されます)。

エラーコードと診断情報

フォームスタジオ（入力規則）を含むKINTAUROSプラグインは、エラー発生時にブラウザのコンソールへ統一形式のログを出力します。人間向けの1行に続けて、機械可読なJSON(code / plugin / version / appId / message / doc)を出力し、doc には該当エラーの解説ページのURLが入ります。

[KINTAUROS <プラグインID>@<バージョン>] E001: 設定されたフィールドが見つかりません: ...
{"kintauros":{"code":"E001","plugin":"...","version":"...","appId":"...","message":"...","doc":"https://kintauros.com/docs/errors/E001"}}

各エラーコードの意味と対処はエラーコード一覧を参照してください。また、プラグイン設定画面の「サポート用情報をコピー」から、環境・バージョン・ライセンス状態・直近のエラーを含む診断情報をコピーできます(レコードの内容や個人情報は含まれません)。お問い合わせの際はこの情報を添えてください。

ライセンスについて

• 初回利用時は、プラグイン設定画面の「利用開始」ボタンから60日間の無料トライアルを開始できます(カード登録不要)。
• トライアル・契約の期限が切れるとプラグインの動作は停止し、画面に案内が表示されます。料金プランから契約すると同じ設定のまま再開できます。
• ライセンス確認のための外部通信で送信されるのは、kintoneドメイン名・プラグインID・バージョンのみです。レコードの内容や個人情報が外部に送信されることはありません。
• ライセンスサーバーに一時的に接続できない場合も、プラグインは一定期間動作を継続する設計です。

サポート

解決しない場合はお問い合わせからご連絡ください。その際、プラグイン設定画面の「サポート用情報をコピー」でコピーした診断情報を添えていただくと、調査がスムーズです。

最終更新: 2026-09-12 / 対象バージョン: v1.5.0