VBScriptを掌握する：WScript依存を脱却し、環境無依存の「ポータブル・スクリプト」を構築する極意
多くのエンジニアが犯す最大の過ちは、スクリプトを「Windows Script Host (WSH) の環境下でしか動かないもの」として設計することだ。
`WScript.Echo` や `WScript.Sleep` は便利だが、それらは「WSHという狭い檻の中」でしか機能しない。いざExcel VBAへ移植しようとしたり、あるいはHTAや他アプリケーションの埋め込みスクリプトエンジンに載せ替えた瞬間、君のコードは「オブジェクトがありません」という無慈悲なエラーを吐いて沈黙する。
真のアーキテクトは、環境に依存しない。今回は、VBScript/VBA/WSFを横断し、どこでも動く「環境抽象化レイヤー」の設計思想を伝授する。
—
1. なぜ「WScript」への直接依存がリスクなのか
WSH（cscript/wscript）環境でしか使えない `WScript` オブジェクトは、VBAや他のCOMホスト環境では「未定義」だ。この依存関係をコードの随所に散りばめることは、「将来の自分に技術的負債を利子付きで貸し付けている」のと同義である。
堅牢なスクリプトを書くための鉄則は、「環境依存部分はラップし、抽象インターフェース経由で呼び出す」ことだ。
2. 実践：環境抽象化クラスの設計
すべての環境で安全に動作する「抽象ラッパー」の設計パターンを公開する。これを共通モジュール（あるいはヘッダーファイル）として持たせておけば、環境が変わってもメインロジックを書き換える必要はない。
‘ — 共通環境抽象化モジュール (CommonEnvironment.vbs) —
Class EnvironmentAdapter
Private isWSH
Private Sub Class_Initialize()
‘ WScriptオブジェクトの存在確認を安全に行う
On Error Resume Next
isWSH = IsObject(WScript)
On Error GoTo 0
End Sub
‘ ログ出力の抽象化
Public Sub Log(message)
If isWSH Then
WScript.Echo message
Else
‘ VBAや他環境ならDebug.PrintやMsgBoxへ振り分ける
Debug.Print message
End If
End Sub
‘ 待機処理の抽象化
Public Sub Sleep(ms)
If isWSH Then
WScript.Sleep ms
Else
‘ VBA環境ならAPIのSleepを呼び出すなどの切り替えを行う
Dim shell: Set shell = CreateObject(“WScript.Shell”)
shell.Run “timeout /t ” & (ms / 1000) & ” /nobreak”, 0, True
End If
End Sub
End Class
3. データベース・ファイル連携の注意点
ポータビリティを意識するなら、ファイルパスの取得やDB接続にも注意が必要だ。
- パスの絶対参照を避ける: `WScript.ScriptFullName` をそのまま使うのは危険だ。VBAでは `ThisWorkbook.Path` が正解になる。環境変数や実行時引数からパスを注入する設計にせよ。
- ADO接続の共通化: データベース接続時に `WScript` を参照してはいけない。接続文字列（Connection String）を外部設定ファイル（JSONやINI）から読み込む設計にすれば、スクリプトはロジックのみに集中できる。
4. プロダクションコードの設計原則
現場で「動く」だけでなく「保守できる」コードにするための3つの原則を掲げる。
1. グローバル変数を禁止せよ: 状態はクラスまたは引数で管理する。グローバル変数は、環境移行時に必ずバグの温床となる。
2. エラーハンドリングを標準化せよ: `On Error Resume Next` を使うなら、必ず直後に `Err.Clear` をし、スコープを最小限に限定せよ。環境が異なれば例外発生のタイミングも異なる。
3. インターフェースを分離せよ: 入力（設定ファイル/引数）、処理（メインロジック）、出力（ログ/ファイル出力）を明確に分けろ。
—
結びに：なぜ我々は「抽象化」するのか
コードを書くとき、君は今この瞬間の環境のことしか考えていないかもしれない。しかし、業務自動化のツールは往々にして、部署を超え、OSのアップデートを跨ぎ、最後には「なぜか誰も中身がわからないが、動いているシステム」として生き残る。
WScriptという「杖」を頼りにするな。環境を問わず、ロジックそのものが自立して動くように設計する。それが、伝説的な自動化エンジニアが持つべき「視座」だ。
さあ、君のコードから `WScript.` という接頭辞を排除し、真にポータブルで堅牢なシステムを構築してほしい。質問があればいつでも来い。現場のコードは、妥協のないアーキテクトの魂そのものなのだから。
