メインコンテンツへスキップ
見出し画像

【個人開発・奮闘記#6】知らずに使っていた“あの呪文”への道【GridLogicSheet】

    導入:お約束の“呪文”と、そこにある壁

    VBAを少し触ったことがある人なら、一度はこんなコードを見たことがある、あるいはネットからコピペしたことがあるはずだ。

    Set dict = CreateObject("Scripting.Dictionary")
    

    「お、連想配列を使うためのお約束ね」
    「ファイルを扱うときのお決まりの呪文ね」

    中身の仕組みなんて深く考えず、ただの“お作法”としてありがたくコードの1行目に貼り付ける。動けば正義だから、それでいい。――そう、思っていた。

    私自身、このCOMという仕組みについて、それほど詳しいわけではない。むしろ、「ファイルを扱うときなどのVBAの助っ人機能を使う際のお決まりの呪文(作法)」だと思いながら使っている側の一人でした。

    「バイブコーディングを使って表計算ツールを作ったら、一体どこまで形にできるんだろう?」で始めているので、当然、COM(Component Object Model)の実装は、いずれチャレンジする必要があり避けて通ることはできない。

    「……で、このCOMって一体なんなんだ?」と、COMを扱うのが久しぶりだったので実装前に振り返りも兼ねて調べてみた。

    COM(Component Object Model)とは、Windows環境において異なるプログラム間でソフトウェアの機能を共有・再利用するための仕組みだ。このCOMを利用して作成されたソフトウェア部品を「COMオブジェクト」と呼び、WordやExcelの自動化などに広く使われているものになる。

    色々な言語で開発していると、そう言った境界線が曖昧になり当たり前のように使ってしまっていることが多い機能や仕組み達のことだ。

    だが、開発に触れていない側からすると敷居が高く得体の知れないもののように感じる。私もCOMの存在を知った当時はそう感じた。

    しかし実際は、プログラミング知識が無くても扱えるようにと、機能を持たせた小さいプログラムを集めたパーツ群であり
    高い敷居を下げるために準備された機能、それがCOMの正体です。

    ※VBAに少し触れたことがある方にも気軽に読んで欲しいため、今回はCOMの仕様に関する細かい説明はあえて大幅に削ぎ落としています。
    その点はご容赦ください!


    登山のように刻んだ、実装のロードマップ

    とはいえ、いざ「自前の環境でこれをどう実装するか」となると話は別だ。一気にすべてを完璧にやろうとすれば、間違いなく途中で足がもつれて遭難する。

    だから私は、計画を細かく、執拗なまでに細かく区切ることにした。
    具体的には、実際の検証用として用意した「監査マクロ(30番・31番)」と呼ばれる小さなテストコードをいくつも用意し、一歩ずつパスしていく方法だ。

    ここでは全体像がごちゃつかないよう、今回の主役である「COMに関連する部分(CreateObjectを使った箇所)」だけをピックアップして流れを見てみよう。

    • 監査マクロ30の要点(Dictionaryの検証)
      連想配列(Dictionary)を使ってデータを管理し、キーを指定して値を取り出す基本のパーツだ。

    Set dict = CreateObject("Scripting.Dictionary")
    dict.Add "Key1", "Apple"
    Range("A1").Value = dict.Item("Key1")
    
    • 監査マクロ31の要点(ファイルシステムとの連携)
      Dictionaryだけでなく、ファイルの作成やテキストの書き込みを行う `Scripting.FileSystemObject` も絡めて、外部ファイルとの連携を試す。

    Set fso = CreateObject("Scripting.FileSystemObject")
    Set ts = fso.CreateTextFile("gridlogic_com_audit31.txt", True)
    

    AIと壁打ちを繰り返し、少し進んでは転び、エラーログを確認しながらルートを修正指示をする。そんな地道なマラソンのような開発の末に、ようやくたどり着いたのが今回の 「COM一部対応」 という小さな、しかし確実な足場だ。


    「Excelで動くなら、
    こっちでも全部動くよね?」という誤解

    ここでよくある勘違いがある。
    「Excel VBAで動いていたんだから、GridLogicSheet でも同じようにすべての COM / CreateObject が動くんでしょ?」

    残念ながら、答えはノーだ。

    私たちが実験を重ねて実装している限定的なCOMの環境と、Excel VBAが背負っているWindowsの巨大なシステム群とでは、使える機能に圧倒的に違いがあります。すべてのCOMを無条件でウェルカムできるほど、世界は優しくはありません。

    GridLogicSheet に、COMに繋げるための2つの入り口を作って、そこが開通して使えるようになっただけです。

    だからこそ、今回私たちが確認し、堂々とクオリティを担保できるのは、先ほどの監査マクロ 30(Dictionaryの検証) や 31(FSOファイル操作とDictionaryの統合) といった、限られた見通しの良い範囲の足場だけだ。

    画像

    「全部できないなら意味がない」のではない。
    「敷居が高いと敬遠されていたCOMの世界へ、VBAをちょっと触ったことがある人でも、限定的とはいえ確実な『第一歩の入口』が繋がった」――これが今回の実装の正体だ。


    窓の向こうに見えた景色

    知らずに使っていた「おまじない」の正体を少しずつ紐解き、泥臭いマラソンのようにコードと向き合った結果、VBAの裏側で外部と手をつなぐ感覚が、少しだけ手元に引き寄せられた。

    もちろん、これは完成形ではない。試験的で、範囲も限定されたものだ。

    だが、この入り口ができたことで、私たちはただシート上でセルの値をいじるだけでなく、外の世界と対話するための確かな足がかりを手に入れた。

    新機能:COM一部対応の説明に関しては、ここまでとなります。
    残りの新機能の説明は、また別の機会とします。今しばらくお待ちください。


    【番外編】監査マクロ30・31の全貌

    「記事を読んで実際にコードを動かしたくなった」「GitHubからダウンロードしたファイルを開いたけど、省略されていない全コードの動きを細かく知りたい!」という方向けに、ここからは今回の検証で使った完全版のコードと、行番号を記した詳細な解説をお届けする。

    コードの左側にある行番号と解説を見比べながら、一つずつ紐解いていこう。

    1. 監査マクロ30:`DictionaryTest` の全コードと解説

    まずは連想配列(Dictionary)の基本動作を検証したマクロの全体像だ。

     1: Attribute VB_Name = "DictionaryTest"
     2: 
     3: Sub DictionaryTest()
     4:     Set dict = CreateObject("Scripting.Dictionary")
     5:     dict.Add "Key1", "Apple"
     6:     dict.Add "Key2", "Banana"
     7:     Range("A1").Value = dict.Item("Key1")
     8:     Range("A2").Value = dict.Item("Key2")
     9:     If dict.Exists("Key1") Then
    10:         Range("B1").Value = "YES"
    11:     End If
    12:     If dict.Exists("Missing") Then
    13:         Range("B2").Value = "BAD"
    14:     Else
    15:         Range("B2").Value = "NO"
    16:     End If
    17:     Range("C1").Value = dict.Count
    18:     dict.Remove "Key2"
    19:     Range("C2").Value = dict.Count
    20:     Range("C3").Value = dict.Item("Key1")
    21:     Dim k
    22:     For Each k In dict.Keys
    23:         Range("D1").Value = "YES"
    24:     Next k
    25: End Sub
    
    • 行ごとのポイント解説:

    • 4行目:`Set dict = CreateObject("Scripting.Dictionary")`

    • 記事の本編でも主役として登場した、連想配列(Dictionary)というCOMオブジェクトを生成して変数にセットしている。

    • 5〜6行目:`dict.Add ...`

    • 辞書に対して「キー(名前)」と「値(中身)」のペアを新しく追加している(Key1にApple、Key2にBanana)。

    • 7〜8行目:`Range(...).Value = dict.Item(...)`

    • 辞書からキーを指定して値を取り出し、シートのセル(A1やA2)に書き出して正しく保持できているか視覚的に確認している。

    • 9〜11行目:`If dict.Exists("Key1") Then ...`

    • 「Key1」というキーが辞書の中にちゃんと存在するかどうかを生存確認し、あればセル(B1)に「YES」と書き込む。

    • 12〜16行目:`If dict.Exists("Missing") Then ... Else ...`

    • 存在しないはずのキーを指定した場合に、意図通り「存在しない(NO)」と判定されてセル(B2)に反映されるかをチェックしている。

    • 17行目:`Range("C1").Value = dict.Count`

    • 現時点で辞書にいくつデータが入っているか(総数)を数えてセル(C1)に書き出す。

    • 18〜20行目:`dict.Remove "Key2"` 等

    • 登録されていたKey2のデータを削除し、その後の総数(C2)や残ったKey1の値(C3)がどう変化するかをテストしている。

    • 21〜24行目:`For Each k In dict.Keys ... Next k`

    • 辞書に登録されているすべてのキーを順番にループで取り出し、最後の確認としてセル(D1)に「YES」と書き込む。

    画像

    2. 監査マクロ31:`ComIntegrationTest` の全コードと解説

    続いて、ファイルシステム(FileSystemObject)とDictionaryを組み合わせた統合テストの全体像だ。

     1: Attribute VB_Name = "ComIntegrationTest"
     2: 
     3: Sub ComIntegrationTest()
     4:     Set dict = CreateObject("Scripting.Dictionary")
     5:     dict.Add "Key", "COM31"
     6:     Range("B1").Value = dict.Item("Key")
     7:     Set fso = CreateObject("Scripting.FileSystemObject")
     8:     Set ts = fso.CreateTextFile("gridlogic_com_audit31.txt", True)
     9:     ts.WriteLine "GL31"
    10:     ts.Close
    11:     If fso.FileExists("gridlogic_com_audit31.txt") Then
    12:         Range("A1").Value = "YES"
    13:     End If
    14:     If fso.FileExists("gridlogic_com_missing.xyz") Then
    15:         Range("A2").Value = "BAD"
    16:     Else
    17:         Range("A2").Value = "NO"
    18:     End If
    19:     Set ts2 = fso.OpenTextFile("gridlogic_com_audit31.txt", 1)
    20:     Range("B2").Value = ts2.ReadLine
    21:     ts2.Close
    22: End Sub
    
    • 行ごとのポイント解説:

    • 4〜6行目:`Set dict = ...` / `dict.Add` / `Range("B1").Value = ...`

    • 30番と同様に、まずは連想配列(Dictionary)の基本機能がここでも問題なく動くかを軽く予習として確かめている。

    • 7行目:`Set fso = CreateObject("Scripting.FileSystemObject")`

    • ここからが31番のメイン。Windowsのファイルやフォルダを操作するための新たなCOMオブジェクト(FSO)を呼び出している。

    • 8行目:`Set ts = fso.CreateTextFile("gridlogic_com_audit31.txt", True)`

    • 指定した名前のテキストファイルを新しく作成し、文字を書き込むための準備(オブジェクトの取得)を行っている。

    • 9〜10行目:`ts.WriteLine "GL31"` / `ts.Close`

    • 作成したファイルの中に「GL31」という文字列を書き込んだあと、ファイルを安全に閉じている。

    • 11〜13行目:`If fso.FileExists("gridlogic_com_audit31.txt") Then ...`

    • 先ほど作ったファイルがパソコン上にちゃんと存在しているかをチェックし、見つかればセル(A1)に「YES」と書き込む。

    • 14〜18行目:`If fso.FileExists("gridlogic_com_missing.xyz") Then ... Else ...`

    • 存在しないファイルをあえて指定したときに、意図通り「存在しない(NO)」と判定されてセル(A2)に書き出されるかをテストしている。

    • 19〜21行目:`Set ts2 = fso.OpenTextFile(...)` / `ts2.ReadLine` / `ts2.Close`

    • 今度は先ほど作ったファイルを「読み込みモード(数字の1)」で改めて開き、中身の文字列(GL31)を1行読み取ってセル(B2)に回収したあと、ファイルを閉じる。

    画像

    #GridLogicSheet #個人開発 #バイブコーディング #開発記 #VBA

     
     
    AIファースト開発やGridLogicSheetの技術検証を発信しています。 「面倒なことはAIに任せて人間は自由に」をテーマに、 日々の作業をAIへ置き換える個人プロジェクトの実績を重ねています。 アイデア共有や検証リクエストなど、意見交換は大歓迎です! お気軽にどうぞ。

    あなたへのおすすめ