基本概念

設定の構造

Visual Customize の設定は ルール → アクション の2階層で構成されます。

ルール（いつ実行するか）
├── アクション 1（何をするか）
├── アクション 2
└── 条件分岐アクション
    ├── then → アクション 3
    └── else → アクション 4

ルール

ルール は kintone のイベントに紐づく実行単位です。

ルールのプロパティ

プロパティ	説明
イベント	ルールが実行されるタイミング（複数選択可）
フィールドコード	change イベント時の対象フィールド
コメント	ルールの説明（管理用）
グループ	ルールの分類（フィルタ用）
有効/無効	ルールの有効状態

ルールの実行順序

同一イベントに複数のルールが登録されている場合、ルール一覧の上から順に実行されます。ドラッグ&ドロップで順序を変更できます。

イベント

イベント は kintone の画面操作に対応するトリガーです。

画面別イベント

レコード追加

イベント	タイミング
追加画面を表示した時	フォームが描画された直後
値を変更した時	フィールド値が変更された時
保存する時	保存ボタン押下後、保存処理の前
保存成功後	サーバーへの保存が完了した後

レコード編集

イベント	タイミング
編集画面を表示した時	フォームが描画された直後
値を変更した時	フィールド値が変更された時
保存する時	保存ボタン押下後、保存処理の前
保存成功後	サーバーへの保存が完了した後

レコード詳細

イベント	タイミング
詳細画面を表示した時	詳細画面が描画された直後
削除する時	削除ボタン押下後、削除処理の前
ステータス変更時	プロセス管理のステータス変更前

一覧

イベント	タイミング
一覧を表示した時	一覧画面が描画された直後

ショートカット

イベント	説明
値を変更した時	追加・編集・インライン編集のすべての change イベント
保存する時	追加・編集のすべての submit イベント
保存成功後	追加・編集のすべての submit.success イベント

モバイル対応

すべてのイベントにモバイル版が存在します。設定画面でモバイルイベントを選択すると、kintone モバイルアプリでも同じカスタマイズが適用されます。

アクション

アクション はルール内で実行される個々の操作です。

アクションのカテゴリ

カテゴリ	概要	代表的なアクション
フィールド操作	フィールド値の設定・取得	値セット、自動採番、ルックアップ取得
外観制御	見た目の変更	フィールド制御、条件書式、行色変更
条件分岐	条件による実行制御	if/else if、switch/case
ダイアログ	ユーザーへの通知・入力	アラート、確認ダイアログ
データ操作	他アプリとのデータ連携	レコード参照、在庫管理、同期
バリデーション	入力チェック・整形	バリデーション、値の整形
UI制御	画面要素の操作	ボタン制御、タブ表示、リダイレクト
カスタムビュー	独自の一覧表示	ダッシュボード、ガント、カンバン

アクションの実行順序

ルール内のアクションは上から順に実行されます。前のアクションの実行結果を後のアクションで参照できます（式テンプレートの {{result:アクションID}} を使用）。

ネストしたアクション

条件分岐アクション（if/else、switch/case 等）の内部にさらにアクションを配置できます。ネストの深さに制限はありません。

条件分岐（部門 = 営業）
├── then:
│   ├── フィールド値セット（割引率 = 10）
│   └── 条件分岐（金額 > 100万）   ← ネスト
│       ├── then: フィールド制御（特別承認欄を表示）
│       └── else: フィールド制御（特別承認欄を非表示）
└── else:
    └── フィールド値セット（割引率 = 0）

条件

条件 は分岐アクション（ifCondition）で使用する判定式です。

条件のロジック

• AND — すべての条件を満たす場合に実行
• OR — いずれかの条件を満たす場合に実行

条件の種類

種類	判定対象
フィールド値	レコードのフィールド値
ログインユーザー	現在のログインユーザー情報
画面種別	表示中の画面（一覧/詳細/追加/編集）
ビュー	選択中の一覧ビュー名・種別
レコードID	レコードの存在有無
プロセス	ステータス・アクション名
アクション結果	前のアクションの実行結果

詳しくは 条件式リファレンス を参照してください。

式テンプレート

アクションのパラメータ内で 式テンプレート を使うと、フィールド値やユーザー情報を動的に埋め込めます。

{{field:会社名}} 様　ご担当: {{user.name}}

構文	説明	例
{{field:コード}}	フィールド値を参照	{{field:会社名}}
{{user.name}}	ログインユーザー名	山田太郎
{{user.code}}	ログインユーザーコード	yamada
{{user.email}}	メールアドレス	yamada@example.com
{{calc:式}}	計算式	{{calc:{{field:単価}}*{{field:数量}}}}
{{result:ID}}	アクション結果の参照	{{result:act_001}}

詳しくは 式テンプレート構文 を参照してください。

テーマ

設定画面と実行時の UI に適用されるカラーテーマを選択できます。

テーマ	色調
kintone	青（kintone 標準色）
wa	グレー
earth	茶色
green	濃緑
mono	黒

スタンドアロン JS

設定した内容を プラグイン不要の JavaScript として出力できます。出力された JS ファイルを kintone の「JavaScript / CSS でカスタマイズ」に登録すれば、プラグイン枠を消費せずにカスタマイズを適用できます。

詳しくは スタンドアロン JS を参照してください。