「マクロが止まる」を過去にする。CorelDRAW VBAで極限の堅牢性を実現するエラーハンドリング術
こんにちは。現場の自動化を支えるエンジニアの皆さん。
CorelDRAWのマクロ記録機能を使って、「お、動いた!」と喜んだ経験は誰にでもあるはずです。でも、そのマクロを実務のルーチンワークとして、あるいはお客様に渡すツールとして運用し始めたとき、こんな恐怖に襲われませんでしたか?
「昨日まで動いていたのに、レイヤー構成が少し変わっただけで、突然エラーで止まってしまった……」
これは、あなたが「マクロ(記録)」から「プログラム(設計)」へとステップアップするための、非常に重要な境界線です。
今日は、プロの現場で求められる「例外を完全にコントロールし、プログラムを死なせない」ための、堅牢なエラーハンドリングとログ出力のメカニズムについて、魂を込めて解説します。
1. なぜ、あなたのマクロは「突然」死ぬのか?
CorelDRAW VBAの世界で、エラーが発生する原因は大きく分けて2つあります。
① オブジェクトのライフサイクル問題(存在しないものへのアクセス)
VBAは非常に素直です。例えば、`ActivePage.Layers(“Layer1”)` と書いたとき、もしユーザーが手動で “Layer1” を削除していたら? VBAは「そんなものはない!」と叫んで、その瞬間に処理を停止します。
マクロ記録は「今そこにあるもの」を前提にコードを書きますが、実務では「あるはずのものが、あるとは限らない」という前提で設計しなければなりません。
② 数値の境界値問題(不正な座標指定)
ガイド線を自動配置する際、計算式を使って座標を算出することがあります。しかし、計算ミスやデータの不備で「数値が無限大(Infinity)」になったり、「極端に大きな値」になったりすると、CorelDRAWのAPIはエラーを返します。
これらを放置すると、マクロは「実行時エラー」を表示して止まり、それまでの作業が中途半端な状態で残ってしまいます。これはプロの仕事としては許されません。
2. プロの設計思想:3つの柱
堅牢なツールを作るために、私たちは以下の3つの設計思想を導入します。
1. 「Try-Catch-Finally」思想の導入: エラーが起きることを前提とし、起きた時に「どこで」「何が」起きたかを捕捉する。
2. ガード節(Guard Clauses): APIを叩く前に、「そのレイヤーはあるか?」「その数値は妥当か?」を事前にチェックする。
3. 中央集権型ログ出力: エラーを画面にポップアップさせるだけでなく、テキストファイルに詳細を書き出し、後から「なぜ失敗したか」を検証可能にする。
3. 実践:堅牢なエラーハンドリング・テンプレート
それでは、実際に現場でそのまま使えるレベルのコードを書いてみましょう。
単なるコードの提示ではなく、「なぜこう書くのか」という意図を読み取ってください。
' ============================================================
' モジュール名: RobustAutomationModule
' 概要: エラーに強く、ログを出力するプロ仕様の自動化テンプレート
' ============================================================
Option Explicit
' ログファイルのパス(実行ファイルと同じフォルダに保存する想定)
Private Const LOG_FILE_PATH As String = "Automation_Log.txt"
''' <summary>
''' メイン処理:レイヤーの追加とガイド線の配置
''' </summary>
Public Sub ExecuteRobustProcess()
Dim targetLayer As Layer
Dim targetLayerName As String
Dim guideX As Double
targetLayerName = "Production_Layer"
' --- [1. エラーハンドリングの開始] ---
On Error GoTo ErrorHandler
' 画面更新を停止してパフォーマンスを向上(プロの定石)
Optimization = True
ActiveDocument.BeginCommandGroup "Robust Process"
' --- [2. ガード節:レイヤーの存在確認と安全な取得] ---
' 直接アクセスせず、関数を介して「安全に」取得する
Set targetLayer = GetLayerSafe(targetLayerName)
If targetLayer Is Nothing Then
' レイヤーがない場合は作成する(エラーにせず、リカバリを行う)
Set targetLayer = ActivePage.CreateLayer(targetLayerName)
WriteLog "INFO: Layer '" & targetLayerName & "' was missing. Created a new one."
End If
' --- [3. ガード節:不正な座標の防止] ---
' 本来は複雑な計算の結果が入る想定
guideX = CalculateSafeCoordinate()
If IsValidCoordinate(guideX) Then
' 安全が確認できてからAPIを呼び出す
ActivePage.Guides.Add cdrGuideHorizontal, guideX
WriteLog "SUCCESS: Guide added at X=" & guideX
Else
' 不正な数値の場合は、エラーとしてログを残し、処理をスキップする
Err.Raise vbObjectError + 513, "CoordinateCheck", "Invalid coordinate calculated: " & guideX
End If
' --- [4. 正常終了処理] ---
ActiveDocument.EndCommandGroup
Optimization = False
MsgBox "処理が正常に完了しました。", vbInformation
Exit Sub
' --- [5. エラーハンドリング・セクション] ---
ErrorHandler:
' 画面更新を必ず元に戻す(これを忘れるとCorelDRAWの挙動がおかしくなる)
Optimization = False
If Not ActiveDocument Is Nothing Then ActiveDocument.EndCommandGroup
' エラー内容を詳細にログ出力
Dim errorMsg As String
errorMsg = "ERROR #" & Err.Number & " [" & Err.Source & "]: " & Err.Description
WriteLog errorMsg
' ユーザーには簡潔なメッセージのみを表示
MsgBox "予期せぬエラーが発生しました。詳細はログを確認してください。" & vbCrLf & _
"Error: " & Err.Description, vbCritical, "Automation Error"
End Sub
' ============================================================
' ヘルパー関数(ここがエンジニアの腕の見せ所)
' ============================================================
''' <summary>
''' レイヤーを安全に取得する関数
''' </summary>
Private Function GetLayerSafe(ByVal layerName As String) As Layer
On Error Resume Next ' エラーを無視して次へ
Set GetLayerSafe = ActivePage.Layers(layerName)
On Error GoTo 0 ' エラーハンドリングを元に戻す
End Function
''' <summary>
''' 座標が妥当(有限かつ範囲内)かチェックする関数
''' </summary>
Private Function IsValidCoordinate(ByVal val As Double) As Boolean
' 数値が極端に大きすぎたり、エラー値(NaNなど)でないかを確認
' ここでは例として、CorelDRAWの作業領域を想定した範囲チェックを行う
If IsEmpty(val) Or IsError(val) Then
IsValidCoordinate = False
ElseIf val > 100000 Or val < -100000 Then ' 範囲は要件に合わせて調整
IsValidCoordinate = False
Else
IsValidCoordinate = True
End If
End Function
''' <summary>
''' 座標計算のシミュレーション(あえてエラーを起こすパターンも想定)
''' </summary>
Private Function CalculateSafeCoordinate() As Double
' ここでは例として固定値を返すが、実務では計算式が入る
CalculateSafeCoordinate = 50.0
End Function
''' <summary>
''' 詳細なログをテキストファイルに書き出す関数
''' </summary>
Private Sub WriteLog(ByVal message As String)
Dim fileNum As Integer
Dim logEntry As String
fileNum = FreeFile
' タイムスタンプを付与
logEntry = Now & " | " & message
' ファイルを追記モードで開く
Open LOG_FILE_PATH For Append As #fileNum
Print #fileNum, logEntry
Close #fileNum
End Sub
4. コードの深層解説:なぜこれで「最強」なのか
🛡️ `On Error Resume Next` の「正しい」使い方
初心者は、エラーが出ると怖くなって、コードの冒頭に `On Error Resume Next` を書いてしまいがちです。これは「エラーを無視して突き進む」という自殺行為です。
私のコードを見てください。`GetLayerSafe` 関数の中だけで、限定的に使用しています。
「レイヤーを探して、なければ `Nothing` を返す」という目的のためだけに、一時的にエラーを黙らせているのです。これこそが、制御されたエラーハンドリングです。
🛡️ `Optimization` と `CommandGroup` の重要性
`Optimization = True` は、描画処理を止めてスピードを爆速にします。しかし、途中でエラーが起きて止まると、CorelDRAWの画面が更新されず、操作不能に見えることがあります。
`ErrorHandler` 内で必ず `Optimization = False` に戻す。これは、ユーザーの作業環境を守るためのエンジニアの義務です。
🛡️ ログ出力による「事後検証」の実現
プログラムが止まったとき、ユーザーは「何が起きたか」を知りたがります。
`WriteLog` 関数によって、`2023/10/27 10:00:00 | ERROR #513: Invalid coordinate…` といった記録が残れば、あなたは開発環境に戻って、その数値がなぜ発生したのかを正確にデバッグできます。
5. まとめ:ここをクリアすれば、あなたはもう「プロ」です
マクロを記録する段階から、「もし、ここでエラーが起きたらどうするか?」を考え、コードを組む段階へ。
この思考の転換こそが、単なる「マクロ使い」と「自動化エンジニア」を分ける決定的な違いです。
1. オブジェクトの存在を疑え。
2. 計算結果の妥当性を疑え。
3. エラーは「隠す」のではなく「記録」せよ。
この3点を守るだけで、あなたの作るツールは劇的に信頼性を増します。
さあ、このテンプレートを自分のプロジェクトに取り入れて、世界に一つだけの、絶対に止まらない堅牢な自動化システムを構築していきましょう!
応援していますよ。
