営業管理アプリ (SFA)
代理店への定期訪問と発注管理を軸にした営業管理アプリ。7 段階のステージ管理・カンバン・訪問カレンダー・パイプラインダッシュボードに加え、見積承認フロー・納品実績の予実比較・案件停滞検知などを含む 61 のルール（SFA 48 + 案件タスク 13）で実現。
スクリーンショット
Section titled “スクリーンショット”一覧画面 — ステージごとの行色分け
Section titled “一覧画面 — ステージごとの行色分け”
詳細画面 — 最終調整ステージ（バッジ・見積明細・活動履歴）
Section titled “詳細画面 — 最終調整ステージ（バッジ・見積明細・活動履歴）”
詳細画面 — 受注ステージ
Section titled “詳細画面 — 受注ステージ”
詳細画面 — 失注ステージ
Section titled “詳細画面 — 失注ステージ”
ステージ別の画面表示 — フィールド・バッジが連動
Section titled “ステージ別の画面表示 — フィールド・バッジが連動”ステージごとに表示されるフィールドやバッジが自動的に切り替わります。見込→提案→見積→発注→納品→完了/失注の順に、発注日・失注理由の表示/非表示、確度の自動設定、バッジ表示が連動する様子をご覧ください。
カレンダービュー — 月/週の切替・ナビゲーション
Section titled “カレンダービュー — 月/週の切替・ナビゲーション”追加画面 — 提案日初期値
Section titled “追加画面 — 提案日初期値”
設定画面 — ルール一覧
Section titled “設定画面 — ルール一覧”
設定画面 — アクション詳細（色変更の条件設定）
Section titled “設定画面 — アクション詳細（色変更の条件設定）”
このサンプルでは以下を実現しています。
案件ライフサイクル:
- 案件番号の自動採番（
DL-00001形式） - 7 段階ステージ管理（見込→提案→見積→発注→納品→完了/失注）
- ステージ連動の確度自動設定と期待売上計算
- 見積明細テーブルでの金額自動計算
- 完了/失注案件のフィールドロック（二重防御）
ワークフロー:
- 見積承認フロー（ステージ=見積かつ承認者空で「承認待ち」バッジ、発注への変更時に承認者を自動記録）
- マネージャー金額上限チェック（売上金額 > 金額上限でエラー、金額上限は管理者のみ表示）
- 受注確定時に担当者自動変更・kintone プロセス管理統合
予実管理:
- 納品実績管理（ステージ=完了で納品実績日を今日に自動セット）
- 納品遅延バッジ（納品実績日 > 納品予定日 を fieldCompare で判定）
- 案件停滞検知（次回アクション日が 7 日以上前で「停滞中」バッジ）
失注分析:
- 失注理由の必須バリデーション
- 競合先フィールド（ステージ=失注のみ表示）
- 失注時の編集ボタン非表示
連携機能:
- 類似案件の複製（案件番号・受注日・ステージを除外）
- 案件タスク自動作成＆遷移（保存成功時）
- 完了案件を売上実績アプリに登録（copyRecord 別アプリ）
可視化:
- カンバン・訪問カレンダー・パイプラインダッシュボード・表計算
- ステージ別行色分け・期限超過ハイライト・確度色分け
- 詳細画面で拡張タブ（競合・受注情報）
必要なアプリ
Section titled “必要なアプリ”案件管理アプリ（メイン）
Section titled “案件管理アプリ（メイン）”案件情報を管理するアプリです。ルールはすべてこのアプリに設定します。
| フィールド名 | フィールドコード | フィールドタイプ | 説明 |
|---|---|---|---|
| 案件番号 | 案件番号 | 文字列（1行） | 自動採番 DL-{SEQ:5} |
| 案件名 | 商談名 | 文字列（1行） | 案件タイトル |
| 取引先コード | 顧客コード | ルックアップ | 取引先マスタへのルックアップ |
| 取引先名 | 顧客名 | 文字列（1行） | ルックアップコピー |
| 業種 | 業種 | 文字列（1行） | ルックアップコピー |
| 担当者 | 担当者 | ユーザー選択 | 案件担当者 |
| ステージ | ステージ | ドロップダウン | 見込 / 提案 / 見積 / 発注 / 納品 / 完了 / 失注 |
| 優先度 | 優先度 | ドロップダウン | 通常 / 重要 / 最重要 |
| 確度 | 確度 | 数値 | 受注確度（%）。ステージに応じて自動設定 |
| 売上金額 | 売上金額 | 数値 | 見込み売上金額 |
| 期待売上 | 期待売上 | 数値 | 自動計算（売上金額 × 確度 / 100） |
| 提案日 | 提案日 | 日付 | 初期値は今日の日付 |
| 受注予定日 | 受注予定日 | 日付 | クロージング予定日 |
| 発注日 | 受注日 | 日付 | 発注受付日（ステージ=発注で自動セット） |
| 納品予定日 | 納品予定日 | 日付 | 納品予定日 |
| 納品実績日 | 納品実績日 | 日付 | ステージ=完了で自動セット（予定日を超えると「遅延」バッジ） |
| 見積承認者 | 見積承認者 | 文字列（1行） | ステージ=発注への変更時に自動記録 |
| 競合先 | 競合先 | 文字列（1行） | ステージ=失注のみ表示（失注分析用） |
| 次回訪問日 | 次回アクション日 | 日付 | フォロー期限 |
| 次回アクション | 次回アクション | 文字列（1行） | 次回の対応内容 |
| 競合情報 | 競合情報 | 文字列（複数行） | 競合他社の情報 |
| 失注理由 | 失注理由 | ドロップダウン | 価格 / 競合 / 予算凍結 / タイミング / その他 |
| メモ | メモ | 文字列（複数行） | 備考 |
| 見積明細（テーブル） | 見積明細 | テーブル | 見積のサブテーブル |
| - 品目 | 品目 | 文字列（1行） | 品目名 |
| - 単価 | 見積単価 | 数値 | 品目単価 |
| - 数量 | 見積数量 | 数値 | 数量 |
| - 小計 | 見積小計 | 数値 | 自動計算（単価 × 数量） |
| 活動履歴（テーブル） | 活動履歴 | テーブル | 活動記録のサブテーブル |
| - 活動日 | 活動日 | 日付 | 活動日 |
| - 種別 | 活動種別 | ドロップダウン | 訪問 / 電話 / メール / 見積提出 / 納品 |
| - 内容 | 活動内容 | 文字列（複数行） | 活動の詳細 |
取引先マスタアプリ
Section titled “取引先マスタアプリ”取引先情報を管理するアプリです。在庫管理サンプルと共有します。ルックアップの参照先として使用します。
| フィールド名 | フィールドコード | フィールドタイプ | 説明 |
|---|---|---|---|
| 取引先コード | 取引先コード | 文字列（1行） | 一意の取引先識別コード |
| 会社名 | 会社名 | 文字列（1行） | 取引先名称 |
| 取引先区分 | 取引先区分 | チェックボックス | 仕入先 / 代理店 / 一般顧客（複数可） |
| 業種 | 業種 | ドロップダウン | IT / 製造 / 小売 / 教育 / 官公庁 / サービス |
| 住所 | 住所 | 文字列（1行） | 所在地 |
| 電話番号 | 電話番号 | 文字列（1行） | 連絡先電話番号 |
| 担当者名 | 担当者名 | 文字列（1行） | 先方担当者 |
| メールアドレス | メールアドレス | リンク | 連絡先メール |
| 与信限度額 | 与信限度額 | 数値 | 代理店向け与信 |
| 支払条件 | 支払条件 | ドロップダウン | 現金 / 月末締翌月払 / 月末締翌々月払 |
追加画面・編集画面（22ルール）
Section titled “追加画面・編集画面（22ルール）”| # | ルール名 | イベント | アクション | 説明 |
|---|---|---|---|---|
| 1 | 案件番号自動採番 | 保存する時 | 自動採番 | DL-{SEQ:5} 形式で採番 |
| 2 | 提案日初期値 | 追加画面を表示した時 | 値セット | 提案日に {{TODAY()}} をセット |
| 3 | タブレイアウト | 追加画面を表示した時 / 編集画面を表示した時 | タブ表示 | 案件情報 / 見積明細 / 活動履歴 / メモの4タブ構成 |
| 4 | 拡張タブ（フィールド配置） | 追加画面を表示した時 / 編集画面を表示した時 | タブ表示 | グループフィールドをタブに整理 |
| 5 | 取引先ルックアップ連動 | 値を変更した時 | ルックアップ実行 → 値セット | 取引先コード変更時に取引先名・業種を自動コピー |
| 6 | ステージ別フィールド制御 | 追加画面を表示した時 / 編集画面を表示した時 / 値を変更した時 | 値で分岐 → フィールド制御 | ステージに応じて失注理由・発注日等の表示/非表示を制御 |
| 7 | 確度自動設定 | 値を変更した時 | 値で分岐 → 値セット | ステージ変更時に確度を自動セット（見込=20, 提案=40, 見積=60, 発注=90, 納品=95, 完了=100, 失注=0） |
| 8 | 期待売上自動計算 | 値を変更した時 | 値セット | {{CALC(売上金額*確度/100)}} で期待売上を自動計算 |
| 9 | 見積小計計算 | 値を変更した時 | サブテーブルループ → 値セット | 見積明細の小計に {{CALC(見積単価*見積数量)}} をセット |
| 10 | 見積合計表示 | 追加画面を表示した時 / 値を変更した時 | テーブル小計 | 見積明細テーブルの小計合計を表示 |
| 11 | 金額フォーマット | 追加画面を表示した時 / 編集画面を表示した時 | 値フォーマット | 売上金額・期待売上にカンマ区切りを適用 |
| 12 | フォロー期限バッジ | 追加画面を表示した時 / 編集画面を表示した時 / 値を変更した時 | 条件分岐 → バッジ表示 | 次回訪問日が過去日の場合に「要フォロー」バッジを赤表示 |
| 13 | 発注バッジ | 詳細画面を表示した時 / 編集画面を表示した時 | 条件分岐 → バッジ表示 | ステージ=発注時に「発注済」バッジを青表示 |
| 14 | 完了バッジ | 詳細画面を表示した時 / 編集画面を表示した時 | 条件分岐 → バッジ表示 | ステージ=完了時に「完了」バッジを緑表示 |
| 15 | 失注バッジ | 詳細画面を表示した時 / 編集画面を表示した時 | 条件分岐 → バッジ表示 | ステージ=失注時に「失注」バッジを灰表示 |
| 16 | 優先度スタイル | 詳細画面を表示した時 / 編集画面を表示した時 | 条件付き書式 | 優先度=最重要の場合に赤背景でスタイリング |
| 17 | メニューテキスト | 追加画面を表示した時 / 編集画面を表示した時 | テキスト表示 | ヘッダーにステージ別の案内テキストを表示 |
| 18 | ステージ変更確認 | 値を変更した時 | 確認ダイアログ | 「発注」「完了」「失注」に変更する際に確認ダイアログを表示 |
| 19 | 発注日自動セット | 値を変更した時 | 条件分岐 → 値セット | ステージ=発注に変更した時に発注日を今日の日付で自動セット |
| 20 | 担当者制御 | 編集画面を表示した時 | ログインユーザー判定 → フィールド制御 | ログインユーザーが担当者でない場合、主要フィールドを編集不可に |
| 21 | 完了/失注フィールドロック | 編集画面を表示した時 | 条件分岐 → フィールド制御 | ステージが完了/失注の場合、全フィールドを無効化し保存ボタンを非表示に |
| 22 | 活動記録ダイアログ | 詳細画面を表示した時 | ボタン追加 → 入力ダイアログ | 「活動記録」ボタンクリックでダイアログを表示し、活動履歴テーブルに行を追加 |
バリデーション（5ルール）
Section titled “バリデーション（5ルール）”| # | ルール名 | イベント | アクション | 説明 |
|---|---|---|---|---|
| 23 | 取引先必須 | 保存する時 | バリデーション | 取引先コードの必須チェック |
| 24 | 売上金額必須（見積以降） | 保存する時 | 条件分岐 → バリデーション | ステージが見積/発注/納品/完了の場合、売上金額 > 0 を確認 |
| 25 | 失注理由必須 | 保存する時 | 条件分岐 → バリデーション | ステージ=失注時に失注理由の必須チェック |
| 26 | 確度範囲 | 保存する時 | バリデーション | 確度が 0〜100 の範囲内であることを確認 |
| 27 | 次回訪問日必須（活動中） | 保存する時 | 条件分岐 → バリデーション | ステージが見込/提案/見積/発注の場合、次回訪問日の必須チェック |
一覧画面・カスタムビュー（8ルール）
Section titled “一覧画面・カスタムビュー（8ルール）”| # | ルール名 | イベント | アクション | 説明 |
|---|---|---|---|---|
| 28 | ステージ別行色分け | 一覧画面を表示した時 | 色変更 x7 | ステージ別に行を色分け（見込=薄灰、提案=薄青、見積=薄紫、発注=薄オレンジ、納品=薄黄、完了=薄緑、失注=薄赤） |
| 29 | 期限超過行色分け | 一覧画面を表示した時 | 色変更 | 次回訪問日が過去日の行を赤枠でハイライト |
| 30 | 類似案件複製ボタン | 一覧画面を表示した時 | ボタン追加 → レコード複製 | 案件番号・発注日・ステージを除いて現在の案件を複製する |
| 31 | 取引先マスタ遷移ボタン | 一覧画面を表示した時 | ボタン追加 → リダイレクト | 取引先マスタの該当レコードへ遷移するボタン |
| 32 | 案件カンバン | 一覧画面を表示した時 | カンバンビュー | ステージを列としたカンバンボード。案件名・取引先名・売上金額・次回訪問日をカードに表示 |
| 33 | 訪問カレンダー | 一覧画面を表示した時 | カレンダービュー | 次回訪問日をベースにした訪問スケジュールカレンダー |
| 34 | パイプラインダッシュボード | 一覧画面を表示した時 | ダッシュボードビュー | KPI（案件数/期待売上合計）、ステージ別金額棒グラフ、業種別構成円グラフ |
| 35 | 案件一覧表計算 | 一覧画面を表示した時 | 表計算ビュー | 主要フィールドをフィルタ付きの表計算形式で表示 |
Phase 2 拡張機能（6ルール: 納品実績・見積承認・失注分析・停滞検知）
Section titled “Phase 2 拡張機能（6ルール: 納品実績・見積承認・失注分析・停滞検知）”| # | ルール名 | イベント | アクション | 説明 |
|---|---|---|---|---|
| 36 | 納品実績日 自動セット | 保存する時 | 条件分岐 → 値セット | ステージ=完了 かつ 納品実績日が空のとき今日の日付を自動セット |
| 37 | 納品遅延バッジ | 詳細 / 編集画面 | 条件分岐 → バッジ表示 | fieldCompare で 納品実績日 > 納品予定日 のとき「遅延」バッジ |
| 38 | 見積承認待ちバッジ | 画面表示 / ステージ変更 | 条件分岐 → バッジ表示 | ステージ=見積 かつ 見積承認者が空のとき「承認待ち」バッジ |
| 39 | 見積承認者 自動記録 | ステージ変更 | 条件分岐 → 値セット | 発注への変更時に {{loginUser.name}} を見積承認者にセット |
| 40 | 競合先フィールド制御 | 画面表示 / ステージ変更 | 条件分岐 → フィールド制御 | ステージ=失注 のときのみ競合先フィールドを表示 |
| 41 | 案件停滞バッジ | 詳細画面 | 条件分岐 → バッジ表示 | 次回アクション日が 7 日以上前 かつ 完了/失注以外で「停滞中」バッジ |
プロセス管理統合（3ルール）
Section titled “プロセス管理統合（3ルール）”| # | ルール名 | イベント | アクション | 説明 |
|---|---|---|---|---|
| 42 | 次フェーズへボタン | 詳細画面 | ボタン追加 → プロセスステータス変更 | kintone プロセス管理の次ステータスへ順送り |
| 43 | 失注ボタン | 詳細画面 | ボタン追加 → プロセスステータス変更 | 直接「失注」ステータスに遷移 |
| 44 | 受注確定時の担当者変更 | 保存成功後 | 条件分岐 → 担当者変更 | ステージ=受注のとき担当者を自動変更 |
連携・複製機能（4ルール）
Section titled “連携・複製機能（4ルール）”| # | ルール名 | イベント | アクション | 説明 |
|---|---|---|---|---|
| 45 | 案件複製ボタン | 詳細画面 | ボタン追加 → レコード複製 | 案件番号・受注日・ステージを除外してコピー |
| 46 | 案件タスク作成ボタン | 一覧 / 詳細画面 | イベント分岐 → ボタン追加 | 一覧=menuBottom / 詳細=menuTop に配置 |
| 47 | 保存後タスク作成 | 保存成功後 | リダイレクト | 保存成功時に案件タスクを自動作成してタスクへ遷移 |
| 48 | 売上実績登録ボタン | 詳細画面 | ボタン追加 → レコード複製 | 完了案件を売上実績アプリ(copyRecord 別アプリ)に登録 |
カスタムビュー
Section titled “カスタムビュー”案件カンバン
Section titled “案件カンバン”カンバンビューを使用して、ステージごとにカード形式で案件を管理します。
- ステータスフィールド:
ステージ - タイトルフィールド:
商談名 - カード追加情報: 取引先名、売上金額、次回訪問日
訪問カレンダー
Section titled “訪問カレンダー”カレンダービューを使用して、次回訪問日ベースの訪問スケジュールを表示します。
- 日付フィールド:
次回アクション日 - イベントタイトル:
商談名（+ 取引先名） - 月/週/日ビューの切り替えに対応
パイプラインダッシュボード
Section titled “パイプラインダッシュボード”ダッシュボードビューを使用して、パイプライン全体を俯瞰します。
- KPI: 案件数合計、期待売上合計
- 棒グラフ: ステージ別の売上金額
- 円グラフ: 業種別の案件構成比
設定のポイント
Section titled “設定のポイント”ステージ駆動のフィールド制御（switchCaseの7パターン）
Section titled “ステージ駆動のフィールド制御（switchCaseの7パターン）”このサンプルの核となるのは、ステージ（案件フェーズ）に応じてフォームの表示内容を動的に切り替えるパターンです。値で分岐 を使い、1つのルールで全ステージのフィールド制御をまとめています。
switchCase（ステージ）├── case 「見込」 : 見積明細=非表示、失注理由=非表示、発注日=非表示├── case 「提案」 : 見積明細=非表示、失注理由=非表示、発注日=非表示├── case 「見積」 : 見積明細=表示、失注理由=非表示、発注日=非表示├── case 「発注」 : 見積明細=表示、失注理由=非表示、発注日=表示├── case 「納品」 : 見積明細=表示、失注理由=非表示、発注日=表示├── case 「完了」 : 見積明細=表示、失注理由=非表示、主要フィールド=無効化└── case 「失注」 : 見積明細=非表示、失注理由=表示、主要フィールド=無効化確度の自動設定（ステージ→確度のマッピング）
Section titled “確度の自動設定（ステージ→確度のマッピング）”ステージが変更されると確度が自動で更新されます。手動で確度を変更することも可能ですが、ステージ変更時には常に上書きされます。
| ステージ | 確度 |
|---|---|
| 見込 | 20% |
| 提案 | 40% |
| 見積 | 60% |
| 発注 | 90% |
| 納品 | 95% |
| 完了 | 100% |
| 失注 | 0% |
代理店ルート営業でのフォロー期限管理
Section titled “代理店ルート営業でのフォロー期限管理”条件分岐 で次回訪問日と今日の日付を比較し、期限切れの場合にバッジで警告します。一覧画面でも同様に期限超過行を赤枠でハイライトすることで、フォローが必要な案件を即座に把握できます。
活動記録ダイアログの仕組み（addButton + showInputDialog）
Section titled “活動記録ダイアログの仕組み（addButton + showInputDialog）”詳細画面に「活動記録」ボタンを追加し、クリックすると入力ダイアログが表示されます。ダイアログで入力した活動日・種別・内容は、活動履歴テーブルに自動追加されます。これにより、詳細画面を離れることなく訪問記録や電話対応を記録できます。
addButton(「活動記録」) → showInputDialog(活動日, 種別, 内容) → refRecord(活動履歴テーブルに行追加)カンバンボードでのパイプライン管理
Section titled “カンバンボードでのパイプライン管理”カンバンビュー でステージを列として案件カードを表示します。ドラッグ&ドロップでステージを変更でき、パイプライン全体の流れを視覚的に管理できます。
完了/失注案件の保護
Section titled “完了/失注案件の保護”ステージが完了または失注になった案件は、誤った修正を防ぐために全フィールドを無効化し保存ボタンを非表示にします。条件分岐 で編集画面表示時にステージを判定し、フィールド制御 でロックします。
関連アクションリファレンス
Section titled “関連アクションリファレンス”- フィールド値セット（setFieldValue）
- 自動採番（autoNumber）
- ルックアップ実行（triggerLookup）
- フィールド制御（conditionalFieldControl）
- 条件付き書式（conditionalFormat）
- バッジ設定（setFieldBadge）
- メニューテキスト（showMenuText）
- 条件分岐（ifCondition）
- 多分岐（switchCase）
- ログインユーザー判定（checkLoginUser）
- 確認ダイアログ（showConfirmDialog）
- 入力ダイアログ（showInputDialog）
- サブテーブルループ（loopSubtable）
- サブテーブル小計（insertSubtableSubtotals）
- レコード複製（copyRecord）
- バリデーション（validate）
- 値フォーマット（formatFieldValue）
- タブグループ（createTabGroup）
- ボタン追加（addButton）
- リダイレクト（redirectUrl）
- カンバンビュー（customViewKanban）
- カレンダービュー（customViewCalendar）
- ダッシュボードビュー（customViewDashboard）
- 表計算ビュー（customViewSpreadsheet）