【入門編】【中級】ネットワーク共有上のステンシルをローカルに一時キャッシュして読み込み速度を改善する – Visio VBA解析バイブル

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

【Visio VBA極意】ネットワーク遅延にサヨナラ。ステンシルをローカルキャッシュして爆速化する設計術

こんにちは。現場の設計と自動化を統括しているアーキテクトです。

Visioを使って大規模なネットワーク図やシステム構成図を描いていると、ある「絶望的な瞬間」に出会うことがあります。それは、「共有サーバー上のステンシルを開こうとした瞬間、Visioが数分間フリーズし、砂時計が回り続ける時」です。

「マクロの記録」で学んだコードをそのまま使っているうちは、この問題に気づきません。しかし、一歩進んで「業務プロセス全体の最適化」を考え始めたあなたなら、この待ち時間がユーザーの生産性をどれほど削っているか、痛いほどわかるはずです。

今日は、単なるコードの書き方ではなく、「ネットワーク遅延という物理的な制約を、ソフトウェアの設計(キャッシュ戦略)でどう克服するか」という、中級者への登竜門となる技術を伝授します。

ここをクリアすれば、あなたの作るツールは「動くマクロ」から「プロ仕様のシステム」へと進化しますよ。

1. なぜ「ネットワーク上のステンシル」は遅いのか?

まず、敵(原因)を知ることから始めましょう。

通常、`Application.Documents.Open` でネットワークパス(`\\Server\Share\…`)を指定すると、Visioは以下の挙動をします。

1. ネットワーク経由でファイルへアクセスを試みる。
2. ファイルの内容(マスターシェイプの定義など)を、ネットワーク越しに少しずつ読み込む。
3. 読み込みが完了するまで、Visioのメインスレッド(操作を受け付ける窓口)を占有し続ける。

この「3」が問題です。ネットワークが少しでも不安定だったり、ステンシルのファイルサイズが大きかったりすると、Visioは応答なしの状態に陥ります。

解決策:ローカルキャッシュ戦略

プロのエンジニアは、直接遠くのファイルを見に行きません。「手元にコピー(キャッシュ)を置いて、それを読み込む」という設計をとります。

1. チェック: ネットワーク上のファイルが更新されているか?
2. 同期: 更新されていたら、ローカルの作業用フォルダにコピーする。
3. ロード: ローカルにあるファイルをVisioに読み込ませる。

このフローを実装することで、Visioのフリーズを回避し、爆速のレスポンスを実現できます。

2. 実装の核心:FileSystemObject (FSO) を使いこなす

この設計を実現するために不可欠なのが、`FileSystemObject` です。これはWindowsのファイルシステムを自在に操るための強力な武器です。

それでは、実際のコードを見ていきましょう。

' ==============================================================================
' モジュール名: modStencilManager
' 概要: ネットワーク上のステンシルをローカルにキャッシュしてロードする
' ==============================================================================

Option Explicit

''' <summary>
''' 指定されたネットワークパスのステンシルを、ローカルにキャッシュして開く
''' </summary>
''' <param name="networkPath">ネットワーク上のステンシルフルパス</param>
''' <returns>開いたDocumentオブジェクト。失敗した場合はNothing</returns>
Public Function LoadStencilWithCache(ByVal networkPath As String) As Visio.Document
    On Error GoTo ErrorHandler

    Dim fso As Object
    Set fso = CreateObject("Scripting.FileSystemObject")

    ' 1. パスの検証
    If Not fso.FileExists(networkPath) Then
        MsgBox "ネットワーク上のステンシルが見つかりません:" & vbCrLf & networkPath, vbCritical
        Exit Function
    End If

    ' 2. ローカルキャッシュ先の決定 (ユーザーのTempフォルダを利用)
    ' 毎回同じ名前を使うことで、管理を簡略化します
    Dim fileName As String
    fileName = fso.GetFileName(networkPath)
    
    Dim localCachePath As String
    localCachePath = Environ("TEMP") & "\VisioCache_" & fileName

    ' 3. 同期ロジック (ファイルが存在し、かつネットワーク版が新しい場合のみコピー)
    Dim shouldCopy As Boolean
    shouldCopy = False

    If Not fso.FileExists(localCachePath) Then
        ' ローカルに存在しない場合はコピー対象
        shouldCopy = True
    Else
        ' 既存のローカルファイルとネットワークファイルの更新日時を比較
        ' これにより、サーバー側が更新された時だけ同期が行われる
        If fso.GetFile(networkPath).DateLastModified > fso.GetFile(localCachePath).DateLastModified Then
            shouldCopy = True
        End If
    End If

    If shouldCopy Then
        ' コピー実行 (上書き許可)
        ' ※ 大容量ファイルの場合、ここが唯一の待ち時間になりますが、
        '   一度コピーすれば次からは一瞬です。
        fso.CopyFile networkPath, localCachePath, True
    End If

    ' 4. ローカルファイルをVisioで開く
    ' OpenEx を使うことで、より詳細なオプション指定が可能になります
    Dim doc As Visio.Document
    Set doc = Visio.Documents.OpenEx(localCachePath, visOpenDocked)
    
    Set LoadStencilWithCache = doc
    
    ' 後片付け
    Set fso = Nothing
    Exit Function

ErrorHandler:
    MsgBox "ステンシルの読み込み中にエラーが発生しました。" & vbCrLf & _
           "Error No: " & Err.Number & vbCrLf & _
           "Description: " & Err.Description, vbCritical
    Set fso = Nothing
    Set LoadStencilWithCache = Nothing
End Function

''' <summary>
''' テスト実行用プロシージャ
''' </summary>
Public Sub TestStencilLoad()
    Dim netPath As String
    Dim myDoc As Visio.Document
    
    ' 【重要】ここに実際のネットワークパスを入力してください
    netPath = "\\YourServer\SharedFolder\NetworkShapes.vssx"
    
    Debug.Print "ロード開始..."
    Set myDoc = LoadStencilWithCache(netPath)
    
    If Not myDoc Is Nothing Then
        Debug.Print "ロード成功: " & myDoc.Name
        ' ステンシルをドッキング表示にする(ユーザーの利便性のため)
        myDoc.Application.ActiveWindow.Page = myDoc.Application.ActivePage
    Else
        Debug.Print "ロード失敗。"
    End If
End Sub

3. プロの視点:コードの解説と「ハマりどころ」

このコードには、単に「動く」以上のための工夫がいくつか含まれています。ここが設計の肝です。

① `DateLastModified` によるスマートな同期

もし、毎回ネットワークからコピーしていたら、それこそコピーのために時間がかかって本末転倒です。
`fso.GetFile(networkPath).DateLastModified > fso.GetFile(localCachePath).DateLastModified`
この一行を入れることで、「サーバー側が更新された時だけ、ローカルを書き換える」という、非常に効率的な同期を実現しています。

② `Environ(“TEMP”)` の活用

キャッシュの保存先をどこにするかは重要です。
書き込み権限がないフォルダに保存しようとすると、エラーで止まってしまいます。`Environ(“TEMP”)` を使うことで、実行しているユーザーが確実に書き込み権限を持っている「一時フォルダ」を自動的に指定できます。これは堅牢なツールを作る上での鉄則です。

③ `OpenEx` の選択

通常の `Open` メソッドではなく `OpenEx` を使用しています。
`visOpenDocked` という定数を渡すことで、開いたステンシルを最初から「ステンシルウィンドウ(ドッキングパネル)」に表示させることができます。ユーザーに「ファイルを開いた後に、手動でステンシルパネルからドラッグしてください」なんて言わせない。この「ユーザーの操作ステップを一つ減らす」意識こそが、優れたエンジニアの証です。

⚠️ 陥りやすいエラーと対策

  • ファイルロックエラー:

もし他のユーザーがそのステンシルを編集中の場合、コピーに失敗することがあります。実務では `On Error` で捕捉し、「現在、他のユーザーが使用中のため更新できません」といった親切なメッセージを出すのがベストです。

  • ネットワーク切断:

ネットワーク自体が落ちている場合、`fso.FileExists` で弾かれます。ここを適切に処理しないと、プログラムが予期せぬエラーでクラッシュします。

まとめ:一歩上の自動化へ

「マクロの記録」から脱却するとは、単にコードが書けるようになることではありません。
「ユーザーの環境(ネットワーク、権限、速度)を想像し、それをソフトウェアのロジックでカバーする」こと。これこそが、真の自動化エンジニアへの道です。

今回紹介したキャッシュ戦略は、Visioに限らず、Excelの外部データ連携や、他の業務アプリの設計にもそのまま応用できる普遍的な考え方です。

「なぜこのコードが必要なのか?」
その答えを常に持ちながら、コードを書いていきましょう。応援していますよ!

*この記事が役に立ったと思ったら、ぜひブックマークして、あなたの開発現場の武器にしてくださいね。*

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