VBScriptでLotusScriptを利用する

　使い方を聞かれたので簡単にまとめてみました。
　注意点にも記載しましたが、今後のことを考えると、ローカル環境でWindowsの機能を使いつつLotusScriptで何かしたい場合はWindows PowerShellで実装するのがお勧めです。

※PowerShellからLotusScirptのクラスを呼んだときのGetFirstDocumentの挙動について - Qiitaに記載しましたが、GetFirstDocumentの挙動がおかしいため、この問題が解消してからのほうがよいかもしれません。

概要

　Component Object Model（COM）セッションを利用して Dominoオブジェクトへのアクセスが可能です。

　DBに直接LotusScript書くほうが早そうですが、以下のようなメリットがあります。Windowsの各種機能と組み合わせてLotusScriptでNotesDBをつつけるので、色々と便利な場面があります。

ユーザーのローカル環境から実行するときに、処理が終わるまでNotesクライアントが固まらない（バックグラウンドで実行できる）
VBScript側で用意されている機能のいいとこ取りができる
Windowsの機能のいいとこ取りもできる
- 例：ユーザーのローカル環境で定期的に実行させたいエージェントがあった場合に、Windowsのタスクスケジューラなどの機能を使って実行する

　一方でデメリットもあります。

フォアグラウンドのクラス(NotesUIWorkSpaceから派生するクラス、ユーザーインターフェースに関するクラス、など)は使えない
バックグラウンドのクラスでもCOMでは使えないものもある
IBM Notes/IBM Domino 上とCOMで実行したときで、挙動が異なるクラス・メソッドがある

　上手く使えば仕事を楽にしてくれるので、知っていると便利です。

サンプルコード

　VBScriptからLotusScriptのNotesSessionを利用する簡単なスクリプトはこちら。

sample.vbs

	' VBScriptでLotusScriptのクラスやオブジェクトを利用するためのシンプルな例

	Option Explicit


	' 初期設定
	' 変数の設定
	Dim objWsh				' バッチファイルをウィンドウ開かずに実行させるときに必要
	Dim objSS				' NotesSessionクラスのオブジェクト


	' Notesのセッションを用意する
	' Initialize メソッドに引数を渡さないことで、デフォルトのパスワード入力ウィンドウを表示させる
	Set objSS = WScript.CreateObject("Lotus.NotesSession")
	Call objSS.Initialize


	' NotesSession のプロパティを呼んでみる（今回はユーザー名の共通部分を出力してみる）
	Wscript.Echo objSS.CommonUserName

　上記コードを適当なフォルダに保存し、前提条件を満たした環境下で以下のように実行してあげると、ユーザー名の共通部分が表示されます。

実行例

	C:\>C:\Windows\SysWOW64\CScript.exe //nologo sample.vbs
	Hoge Fuga

注意点

　64bit環境下では、32bit版のCScript.exe(またはWScript.exe)からVBSを呼ぶ必要があります。64bit環境下では通常64bit版のCScript.exeが呼ばれてしまうのですが、このCScript.exeではオブジェクトを作成できず、以下のようなエラーになります。

失敗例

	C:\>cscript //nologo sample.vbs
	C:\sample.vbs(14, 1) WScript.CreateObject: "Lotus.NotesSession" というオブジェクトを作成できませんでした。

　このため、上の例のように C:\Windows\SysWOW64\CScript.exe から実行する必要があるのですが、知らないとハマります。昔のコードが新しい環境で動かない……ということで焦ることになります。

＃"WOW64"は"Windows-On-Windows 64"の略で、64bit Windows で 32bit Windows アプリケーションを動作させる仕組みのことなのだけど、見ただけならこっちが64bit版のCScript.exeだと思っちゃいますよね……。なんて分かり辛い。

　また、VBScriptがいつ打ち切られてしまうか分からないため、そうなった場合はWindows PowerShell への移行を迫られることになります。

「Windows PowerShellでもLotusScriptを利用できるの？」という声が聞こえてきそうですが、できるので続きは後ほど……。

2017/10/22 追記：
　だいぶ時間がたってしまいましたが、PowerShellからLotusScriptを呼び出す方法についてエントリを用意しました。
PowershellでLotusScriptを利用する - Qiita