【実務・中級編】【ユーザー入力の堅牢化】InputBox における「キャンセル」ボタンと「空文字」を正確に識別し、処理の中断を安全に行う判定ロジック – VBScript (Visual Basic Scripting Edition)解析バイブル

スポンサーリンク
スポンサーリンク

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)を正確にハンドリングし、ビジネスロジックの純粋性を保つこと。それこそが、プロフェッショナルな業務自動化ツールを作るための第一歩である。

「動くコード」を書くのではない。「壊れない設計」を書け。

タイトルとURLをコピーしました