InputBoxの罠 — 「空文字」と「キャンセル」の混同が引き起こす業務破壊
業務自動化の現場において、スクリプトは「正しく動くこと」以上に「予期せぬ操作に対して、いかにエレガントに、かつ安全に振る舞うか」が問われる。
多くのジュニアエンジニアが、ユーザーからの入力を受け取るために `InputBox` を使用する。しかし、その戻り値の扱いを疎かにした結果、「ユーザーが操作を中断したはずなのに、空のパラメータでデータベース更新が走ってしまった」「キャンセルしたはずなのに、ファイル削除処理が継続された」といった、致命的なバグ(ロジックの破綻)を引き起こすケースを私は何度も目にしてきた。
本稿では、VBScriptにおける `InputBox` の挙動の深淵を解き明かし、プロフェッショナルとして実装すべき「堅牢な判定ロジック」の設計思想を伝授する。
1. 致命的な誤解:なぜ `If input = “” Then` では足りないのか
まず、初心者が書く典型的な「脆弱なコード」を見てみよう。
' --- 脆弱なコードの例 ---
Dim userInput
userInput = InputBox("処理対象のファイル名を入力してください", "入力確認")
' ユーザーが「キャンセル」を押しても、何も入力せずに「OK」を押しても、
' userInput は "" (空文字) になる。
If userInput = "" Then
MsgBox "入力がありません。処理を終了します。"
WScript.Quit
End If
' ここで userInput を使ってファイル操作を行うと、
' もしキャンセルが「意図しない空文字での続行」を意味する場合、
' システムは壊滅的なエラー、あるいは予期せぬ動作を起こす。
技術的な真実
WSH(Windows Script Host)環境で `Microsoft.VisualBasic.InputBox` を呼び出した際、戻り値は常に String型 である。
ここで重要なのは、「ユーザーがキャンセルボタンを押した時」と「ユーザーが何も入力せずにOKボタンを押した時」、どちらも戻り値は一律で `””` (空文字) になるという仕様だ。
この仕様を理解せずに、「空文字なら中断」というロジックを組むことは、設計思想として極めて不完全である。なぜなら、「あえて空の値を渡したいケース」と「処理自体を中断したいケース」を区別できていないからだ。
2. アーキテクトの設計思想:曖昧さを排除する3つの戦略
プロフェッショナルは、ツールの限界を理解した上で、設計によってその限界を回避する。`InputBox` の曖昧さを制御するために、以下の3つの戦略を使い分けるべきだ。
戦略A:必須入力パターン(Strict Validation)
入力が「必ず存在する」ことが前提の業務(例:ファイルパスの指定、IDの入力)では、空文字を「エラー」として扱い、キャンセルを「中断」として扱う。この場合、空文字は「不正な入力」としてループさせるか、あるいは中断として扱うかのポリシーを明確にする。
戦略B:デフォルト値パターン(Default Value Pattern)
「未入力ならデフォルト値を使う」という設計にする。これにより、ユーザーが「何も入力せずOK」を押した際の挙動を確定させ、キャンセルとの意味的な差異を(運用ルールとして)吸収する。
戦略C:高精度判定パターン(The Sentinel Pattern)
もし、業務上「キャンセル」と「空文字入力」を厳密に区別しなければならない場合は、`InputBox` の使用を諦めるべきだ。代わりに、HTA(HTML Application)を用いて独自のダイアログを構築するか、あるいは「特定のキーワード(例:`exit`)」を入力させるなどの回避策を講じる。
3. プロダクション・レディ:堅牢な入力制御の実装例
実務でそのまま利用可能な、保守性と堅牢性を兼ね備えた関数ライブラリの設計例を示す。ここでは、「キャンセルを検知し、必要に応じてデフォルト値を適用する」という、最も汎用性の高いロジックをカプセル化している。
' =============================================================================
' Module: InputHandler
' Description: 堅牢なユーザー入力取得ロジック
' =============================================================================
Option Explicit
' 定数の定義:マジックナンバーを避け、意図を明確にする
Const STATUS_CANCEL = 0
Const STATUS_OK = 1
' メイン処理
Call Main()
Sub Main()
Dim targetPath, result
' 1. 必須入力のケース(キャンセルされたら即終了)
targetPath = GetRobustInput("処理対象のディレクトリを入力してください", "", True)
If result = STATUS_CANCEL Then
WScript.Echo "ユーザーにより操作がキャンセルされました。終了します。"
WScript.Quit
End If
' 2. オプション入力のケース(空ならデフォルト値を使用)
Dim logDir
logDir = GetRobustInput("ログ出力先を入力してください (空欄でデフォルトを使用)", "C:\Logs", False)
If result = STATUS_CANCEL Then
WScript.Echo "操作を中断しました。"
WScript.Quit
End If
' 業務ロジックへの受け渡し
WScript.Echo "--- 実行パラメータ ---"
WScript.Echo "Target: " & targetPath
WScript.Echo "LogDir: " & logDir
End Sub
' -----------------------------------------------------------------------------
' Function: GetRobustInput
' Purpose: InputBoxの戻り値を解析し、キャンセルと空文字を制御する
' Arguments:
' strPrompt - 表示するメッセージ
' strDefault - デフォルト値
' blnIsMandatory - Trueの場合、空文字はエラー扱い(キャンセル扱い)とする
' Returns:
' String - 入力された値(またはデフォルト値)
' -----------------------------------------------------------------------------
Function GetRobustInput(strPrompt, strDefault, blnIsMandatory)
Dim vb, strInput, intResult
Set vb = CreateObject("Microsoft.VisualBasic")
' 初期化
GetRobustInput = ""
intResult = STATUS_OK ' デフォルトはOKとする
' InputBoxの呼び出し
strInput = vb.InputBox(strPrompt, "System Input", strDefault)
' 判定ロジックの核心
If strInput = "" Then
If blnIsMandatory Then
' 必須入力において空文字は「キャンセル」と同義とみなす
intResult = STATUS_CANCEL
Else
' オプション入力の場合、デフォルト値を割り当てる
strInput = strDefault
intResult = STATUS_OK
End If
End If
' 結果の格納
If intResult = STATUS_OK Then
GetRobustInput = strInput
Else
GetRobustInput = "" ' キャンセルの場合は空を返す
End If
' 呼び出し元にステータスを伝えるための仕組み(ここでは戻り値の仕組みを利用)
' ※実務では、呼び出し元で「戻り値が空かつキャンセル状態」を判定できるよう設計
' 本サンプルでは簡略化のため、グローバルな判定を模倣
SetGlobalResult intResult
End Function
' ステータスを保持するための簡易的な仕組み
Dim g_Status
Sub SetGlobalResult(status)
g_Status = status
End Sub
' グローバルステータスを読み取るプロパティ(実際はクラス化が望ましい)
Property Get result()
result = g_Status
End Property
*(注: 上記コードは概念を分かりやすくするため、グローバル変数 `g_Status` を用いて判定結果を返しています。大規模な開発では、これらを一つの `Class` にまとめ、`Result` プロパティを持つオブジェクトとして設計するのが正解です。)*
4. 連携時の注意点:ファイルシステムとデータベースへの「毒」
入力値を獲得した後、それをそのまま外部リソースに投入することは、エンジニアとして「禁忌」である。
ファイルシステム連携におけるリスク
`InputBox` で取得した値が、たとえ `””` でなくても、以下のようなケースは防がなければならない。
- ディレクトリトラバーサル: `..\..\Windows\System32` のような入力。
- 存在しないパス: 入力されたパスが実際に存在するか `FileSystemObject.FolderExists` での検証は必須。
データベース連携におけるリスク
SQLクエリを組み立てる際、ユーザー入力をそのまま結合(Concatenate)してはならない。
- SQLインジェクション: `’; DROP TABLE Users; –` といった入力。
- データ型不一致: 数値が期待されるカラムに、空文字や文字列が渡されることによるトランザクションのロールバック。
結論:堅牢なスクリプトは「疑い」から生まれる
優れた自動化エンジニアは、ユーザーが常に「間違った操作をする」ことを前提に設計を行う。
`InputBox` は便利な道具だが、その戻り値には「キャンセル」と「空文字」という、意味の異なる二つの状態が隠されている。この境界条件(Boundary Condition)を正確にハンドリングし、ビジネスロジックの純粋性を保つこと。それこそが、プロフェッショナルな業務自動化ツールを作るための第一歩である。
「動くコード」を書くのではない。「壊れない設計」を書け。
