VBScriptを掌握せよ：WScriptオブジェクトによる「自己位置特定」の極意
業務自動化の現場において、VBScriptは依然として強力な武器だ。だが、多くのエンジニアが「カレントディレクトリ」の罠に足を取られ、スクリプトが環境依存で沈没するのを幾度となく見てきた。
`C:\Windows\System32` がカレントディレクトリだと勘違いし、相対パスでファイルを読み込めずエラーを吐く。そんな稚拙なバグを、今の時代に持ち込むべきではない。
今回は、VBScriptが自身の置かれた場所を正確に把握し、いかなる実行環境においても「自律的に」動作するための設計哲学を伝授する。
—
1. なぜ「相対パス」の記述は失敗するのか
VBScriptの `CreateObject(“Scripting.FileSystemObject”)` でファイルを読み込む際、多くの初心者はこう書く。
‘ 危険：カレントディレクトリ依存のコード
Set fso = CreateObject(“Scripting.FileSystemObject”)
Set file = fso.OpenTextFile(“config.ini”, 1)
これは自殺行為だ。タスクスケジューラからの実行や、ショートカットからの起動、あるいはコマンドプロンプトの階層によって、`OpenTextFile` が見に行く場所は常に変動する。「スクリプトが置かれている場所」と「現在の作業ディレクトリ」は、論理的に全く別物であるという事実を、骨の髄まで理解する必要がある。
—
2. 自己位置特定のための「メタ情報」活用
WSH（Windows Script Host）環境には、スクリプト自身のアイデンティティを保持する `WScript` オブジェクトが存在する。我々が活用すべきは以下のプロパティだ。
- `WScript.ScriptFullName`: スクリプト自身のフルパス（例: `D:\Projects\AutoTask\run.vbs`）
- `WScript.Version`: WSHの実行エンジンバージョン（保守時の環境診断に有用）
これらを `FileSystemObject` の `GetParentFolderName` メソッドと組み合わせることで、「スクリプトがどこに配置されていても、常に自身と同じフォルダを参照する」という堅牢なパス解決が可能になる。
—
3. プロダクション環境に耐えうる「基底パス」設計
保守性の高いスクリプトは、冒頭で必ず「自身の絶対パス」を定数化する。以下のコードは、あらゆる自動化ツールの雛形としてそのまま使えるものだ。
Option Explicit
‘ ———————————————————
‘ 初期化処理：自身のパスを正確に特定する
‘ ———————————————————
Dim fso, scriptFolder, configPath
Set fso = CreateObject(“Scripting.FileSystemObject”)
‘ WScript.ScriptFullName から自身が存在するフォルダパスを抽出
‘ これにより環境依存のディレクトリ問題を完全に排除する
scriptFolder = fso.GetParentFolderName(WScript.ScriptFullName)
‘ 外部ファイルへのフルパスを動的に組み立てる
configPath = fso.BuildPath(scriptFolder, “config.ini”)
‘ — 以下、業務ロジック —
If Not fso.FileExists(configPath) Then
WScript.Echo “Error: 設定ファイルが見つかりません。パス: ” & configPath
WScript.Quit 1
End If
‘ 以降、この configPath を使えばパスの不整合は二度と起きない
この設計のポイント
1. `fso.BuildPath` の利用: パスの結合に `\` を直書きしてはならない。OSがWindowsである限り `\` で繋ぐのが通例だが、FSOのメソッドを通すことで設計意図が明確になり、コードの可読性が格段に上がる。
2. 早期警告（Fail-Fast）: スクリプトの実行開始直後にパスチェックを行う。問題がある場合は即座に `WScript.Quit` で終了させる。中途半端な状態で処理を進め、後半でエラーを吐くのはデバッグコストの無駄である。
—
4. 現場のリーダーからの一言：保守性を高めるために
VBScriptは「動いて当たり前」の古い言語に見えるかもしれない。しかし、「どこでも動く（ポータブル）」という設計思想を盛り込むだけで、その価値は劇的に変わる。
- 環境ログの出力: 障害調査時、`WScript.Version` をログに出力しておくことを強く推奨する。特定のWindowsのバージョンで挙動が異なるケースにおいて、この情報が「命綱」になるからだ。
- ハードコードの禁止: 絶対パスをスクリプト内に直書きするな。今回紹介した自己診断ロジックを使えば、フォルダごと移動・配布しても、スクリプトは自律的に自身の環境に適応する。
自動化エンジニアの腕の見せ所は、いかに「後で泣かない設計」を作れるかだ。まずは、あなたの書いているスクリプトの冒頭に、この「自己位置特定」のロジックを実装することから始めてほしい。
成功を祈る。コードは嘘をつかない。設計の甘さが嘘をつくだけだ。
