-asyncオプションを指定すると非同期で処理が実行されます。

非同期実行の場合、ワーカープロセスにジョブを登録して、自プロセスはすぐに終了します。ワーカープロセスが起動していない場合はワーカープロセスを起動します。

eDocArrangementから呼び出す場合で、非同期実行を使用する場合、以下のような呼び出し方法を行うことを想定しています。

printToPdfFromDocuWorksFileの-sdf, -fdfオプションを使って、変換処理後に入力ファイルを指定フォルダに移動します。

変換に失敗した場合は、エラーフォルダに移動されます。

同時実行プロセスの上限に達した場合は、処理を行わず、入力ファイルの移動も行いませんので、次回のフォルダ監視で再処理されます。

また、非同期実行の場合は、-slf, -flf オプションを指定してprintToPdfFromDocuWorksFileでログの出力を行うことを推奨します。

文書変換処理を円滑に行う為に文書変換処理のキュー管理を行っています。

printToPdfFromDocuWorksFileコマンド実行すると、呼び出し元(同期 or 非同期)、ワーカー、ランナーの3つのプロセスが起動します。複数のプロセスが連携して文書変換を行います。

-asyncオプションを指定しなかった時は同期的に処理が実行されますが、同期実行の場合でもワーカーとランナーのプロセスが起動して文書変換処理を行います。同期プロセスは対象の文書変換処理を実行するランナープロセスが終了するまで待機します。

printToPdfFromDocuWorksFile実行中にタスクマネージャーで確認すると、コマンド起動の数よりも多い数のプロセスが存在しますが正常な状態です。

printToPdfFromDocuWorksFileのプロセス名は、呼び出し元(同期 or 非同期)、ワーカー、ランナー、全て printToPdfFromDocuWorksFile となります。

全ての文書変換処理が終わった後も暫くの間、ワーカーのプロセスが常駐していますが、時間経過で自動的に終了します。

変換後のPDFファイルの画質等については、PDFファイルを出力するプリンターの印刷設定画面の内容が反映されます。余白などの設定も対象となるようです。

-mdtwオプションを指定した場合、以下のエラー処理を行います。

1. -sdf, -fdfのフォルダが指定されていること。また、指定されたフォルダが有効なパスであること。

   条件を満たしていない場合は、処理を終了します。

2. 入力ファイルを-wf で指定されたフォルダ(作業フォルダ)に移動する。

3. DocuWorks Viewer を起動して、指定のPDFファイルを出力するプリンターへの印刷を行う。

   DocuWorks Viewer が終了せず戻ってこない場合(-ptoオプションを指定してタイムアウトになった場合)は、以下の処理を試行します。

   • 作業フォルダに移動された入力ファイルを-fdfで指定されたフォルダ (文書変換失敗時移動先)に移動する。

   • 文書変換失敗時移動先のフォルダに移動が失敗した場合は、printToPdfFromDocuWorksFile.exeのフォルダに移動する。

   • 出力されたPDFが存在する場合は削除する。

4. 指定のPDFファイルの出力が完了するまで待機する。

   PDFファイルの出力が完了しない場合(-ptoオプションを指定してタイムアウトになった場合)は、以下の処理を試行します。

   • 作業フォルダに移動された入力ファイルを-fdfで指定されたフォルダ (文書変換失敗時移動先)に移動する。

   • 文書変換失敗時移動先のフォルダに移動が失敗した場合は、printToPdfFromDocuWorksFile.exeのフォルダに移動する。

   • 出力されたPDFが存在する場合は削除する。

5. 文書変換を行うプロセスが、入力ファイルを移動しないまま終了した場合※は、以下の処理を試行します。

   ※ 文書変換を行うプロセスで例外が発生した、強制終了された、などのケースです。

   • 作業フォルダに移動された入力ファイルを-fdfで指定されたフォルダ (文書変換失敗時移動先)に移動する。

   • 文書変換失敗時移動先のフォルダに移動が失敗した場合は、printToPdfFromDocuWorksFile.exeのフォルダに移動する。

   • どちらにも移動できなかった場合は、作業フォルダの job~コンピューター名\failed フォルダに残す。

• メイン処理
  
  • 起動と初期化
    
    • 同期プロセスとして起動（-async なし）
      同期プロセスとして起動されジョブ完了まで待機する。
    • 非同期プロセスとして起動（-async あり）
      非同期プロセスとして起動されジョブ登録後すぐに終了する。
  • 引数解析
    引数のエラーチェック。
  • 入力検証
    入力ファイルの存在チェックや検査。
  • ワーカープロセス管理
    
    • ワーカープロセスが起動していない場合
      Mutexを使用してワーカープロセスの起動状態を確認する。ワーカープロセスが起動していない場合は、自プロセスからワーカープロセスを起動する。
    • ワーカープロセスの起動確認
      ワーカープロセスとの IPC（メモリマップドファイル）が確立されるまで待機する。一定時間接続できない場合はタイムアウトエラー（終了コード37）となる。
  • ジョブ登録
    
    • ジョブフォルダーの作成
      作業フォルダー内にタイムスタンプベースのジョブフォルダーを排他的に作成する。衝突時は連番を付与する。
    • コマンド引数の書き込み
      コマンド引数をジョブフォルダー内の arguments.txt に書き込む。
    • 入力DocuWorks文書ファイルの移動（-mdtw 指定時）
      入力DocuWorks文書ファイルをジョブフォルダー内の in フォルダーに移動する。
    • ジョブ登録通知
      IPC（メモリマップドファイル）を介してワーカープロセスにジョブ登録を通知する。
  • 同期/非同期分岐
    
    • -async スイッチが指定されていない場合（同期）
      IPC（メモリマップドファイル）を介してワーカープロセスからのメッセージを待機する。

      受信するメッセージ:

      • alive : ワーカープロセスの生存通知。受信するとタイムアウトカウンターをリセットする。

      • runnerFinished : ランナープロセスの処理完了と終了コードの通知。受信すると自プロセスの終了コードを設定して待機を終了する。

      一定時間（10秒）生存通知を受信しない場合はタイムアウトエラー（終了コード37）となる。

    • -async スイッチが指定された場合（非同期）
      入力DocuWorks文書ファイルを作業フォルダーに移動する設定（-mdtw）の場合、入力ファイルが移動された（元の場所から消えた）ことを検知するまで一定時間待機する。その後、自プロセスを終了する。
• ワーカー処理
  ワーカープロセスは同期/非同期プロセスから起動され、ジョブキューの管理とランナープロセスの起動を担当する。
  • ワーカー初期化
    
    • ジョブフォルダーの準備
      ジョブキューフォルダー（job~COMPUTERNAME/queue）とジョブ作業フォルダー（job~COMPUTERNAME/work）を作成する。
    • ジョブ作業フォルダーのクリーンアップ
      前回のワーカーが異常終了した場合に残った作業フォルダー内のファイルを削除する。
  • ジョブキュー監視ループ
    
    • 新しいジョブの受信
      IPC（メモリマップドファイル）からコマンド引数を受信したらパースしてジョブフォルダーを作成し、キューに登録する。
    • 同期プロセスに対しての生存通知
      以下のメッセージを IPC 経由で待機中の全ての同期プロセスに送信する。

      • alive: ワーカープロセスの生存通知（定期的に送信）

    • ジョブの実行
      キューに未処理のジョブが存在する場合、ランナープロセスを起動してジョブを実行する。ランナープロセスの終了を待ってから次のジョブを処理する。

      同期プロセスからのジョブの場合は、ランナープロセスの処理中に以下のメッセージを IPC 経由で同期プロセスに送信する。

      • runnerFinished : ランナープロセスの処理完了と終了コードの通知

    • ワーカー終了判定
      一定時間（15秒）、新しいジョブが登録されない、処理中のジョブが無い、待機中の同期プロセスが存在しない、の全てを満たす場合に、ワーカープロセスを終了する。終了時に空のジョブキューフォルダー、ジョブ作業フォルダー、ジョブベースフォルダーを削除する。
• ランナー処理
  ランナープロセスはワーカープロセスから起動され、実際の印刷処理（DocuWorks Viewer の起動と監視）を担当する。
  • プリンター準備
    
    • プリンターサーバー接続成功
      プリントキューの取得。
    • プリンターサーバー接続失敗
      エラー終了。
  • 作業フォルダー管理
    作業フォルダーの作成とファイル移動。
  • 印刷キュー管理
    
    • ループ処理(印刷ジョブ数監視)
      プリンターキューの印刷ジョブ数が指定数未満になったらループ終了。

      印刷ジョブ情報リスト取得のメソッドで例外が発生した際にリトライする。失敗した場合は「印刷ジョブ情報取得失敗フラグ」を立てる。

    • DocuWorks Viewer起動
      
    • ループ処理(DocuWorks Viewerを監視)
      DocuWorks Viewerが存在している間ループを続ける。
      • Viewerのプロセス確認
        Viewerのプロセスが存在しない時はループ終了。
      • 対象ファイルの印刷ジョブ情報リスト取得
        印刷ジョブ情報の「ジョブ名」の文字列に対象ファイル名が含まれているかを判定。

        印刷ジョブ情報リスト取得のメソッドで例外が発生した際にリトライする。失敗した場合は「印刷ジョブ情報取得失敗フラグ」を立てる。

      • 印刷中ページチェック
        印刷ジョブ情報からスプール中のページ数を取得して一定時間ページ数に変化がない場合は「ページ出力タイムアウトフラグ」を立てる。

        印刷ジョブ情報の取得に失敗した場合はページチェックを終了する。

      • DocuWorks Viewerのダイアログの対応
        
        • ウィンドウを検出した場合
          
          • 1秒後に対象ウィンドウが存在している
            対象ウィンドウにクローズメッセージを送信。
          • 10秒後に対象ウィンドウが存在している
            
            • ♻️タイムアウト処理
              
      • 印刷キューアプリケーションのチェック
        印刷キューアプリケーションを検出したら「印刷キューアプリケーションフラグ」を立てる。

        印刷キューアプリケーションが起動していると、DocuWorks PDFが不完全なPDFファイルを出力してしまう現象が発生する為、印刷キューアプリケーションを検出したらエラー扱いとしている。(Windows 11 24H2 不具合対応。)

      • 文書変換タイムアウト
        文書変換タイムアウト値を超えたら「文書変換タイムアウトフラグ」を立てる。
      • エラー処理
        以下の何れかのフラグが立っていたらタイムアウト処理を実行する。

        • 文書変換タイムアウトフラグ

        • ページ出力タイムアウトフラグ

        • 印刷キューアプリケーションフラグ

        • 印刷ジョブ情報取得失敗フラグ

        • ♻️タイムアウト処理
          
  • 印刷監視
    
    • ループ処理(印刷中)
      印刷中の間ループを続ける。
      • 印刷ジョブ情報のステータスが終了
        ループ終了。

        印刷ジョブ情報のメソッドやプロパティを使用中に例外が発生しても無視する。

        例外を無視した時は印刷ジョブが終了したとみなして印刷終了待ちのループを抜ける。

        無視するだけなのでエラー処理は無し。

    • エラーが発生しなかった場合
      スイッチで指定された内容に応じてファイルをコピーしたり移動したりする。
      • ファイルのコピーや移動でエラー発生
        「印刷後処理エラーフラグ」を立てる。
  • 後処理
    
    • エラーが発生した場合
      以下のフラグに対応したエラーメッセージを出力する。

      • 文書変換タイムアウトフラグ

      • ページ出力タイムアウトフラグ

      • 印刷後処理エラーフラグ

      • 印刷キューアプリケーションフラグ

      • 印刷ジョブ情報取得失敗フラグ

    • クリーンアップ
      作業フォルダーの削除などの後処理を行う。
• ♻️共通処理
  
  • ♻️タイムアウト処理
    
    • 印刷ジョブ情報が存在する
      対象印刷ジョブのキャンセル
      対象印刷ジョブが終了するまで待つ

      上記2つの処理で例外が発生しても無視する。

    • 「DocuWorks Viewerを強制終了する」スイッチが指定されている
      DocuWorks Viewerを強制終了する。
    • ループ終了
      「DocuWorks Viewerを強制終了する」スイッチが指定されていない時は、DocuWorks Viewerのプロセスが残る事になる。

例1

以下の内容でXDW文書をPDF文書に変換する。

• PDFファイルを出力するプリンターは "DocuWorks PDF" を使用する。(-p)

• 非同期で実行する。(-async)

• 作業フォルダを使用した変換を行う。(文書変換成功時、失敗時のファイル移動を行う) (-mdtw)

• 60秒間プリントジョブのページが変化しない場合はページ出力タイムアウトとする。(-ppto 60)

• タイムアウトが発生した場合はDocuWorks Viewerを強制終了する。(-ftwto)

例2

以下の内容でXDW文書をプリンターに印刷する。

• 印刷するプリンターは "LBP622C" を使用する。(-p)

• 60秒間プリントジョブのページが変化しない場合はページ出力タイムアウトとする。(-ppto 60)

• タイムアウトが発生した場合はDocuWorks Viewerを強制終了する。(-ftwto)

2026/10/31 Version 1.1.2

• -wfを省いた時に、printToPdfFromDocuWorksFile.exeのフォルダに書き込めない場合は %LOCALAPPDATA%\TechnoStyle\printToPdfFromDocuWorksFile を使用するように修正。Program Filesの下に入れたprintToPdfFromDocuWorksFile.exeを管理者として実行しない時に、ジョブキューフォルダを作れずに終了コード 37（ワーカープロセスとの通信でタイムアウトが発生しました。）で終了する不具合を修正。（書き込める時は今までどおりprintToPdfFromDocuWorksFile.exeのフォルダを使用します）

• ジョブキューフォルダを作れない時は、呼び出したプロセスが終了コード 36（ジョブフォルダーの作成に失敗しました。）で終了するように修正。

• ワーカープロセスが動いている間に、別の-wfを指定して実行すると、文書変換されず（同期実行の時は終了コード 99）、-mdtwを指定した入力ファイルが失われる不具合を修正。文書変換はワーカープロセスの作業フォルダで行う。

• 文書変換を行うプロセスが、入力ファイルを移動しないまま終了した場合（例外・強制終了など）、入力ファイルを-fdfで指定されたフォルダに移動するように修正。（今までは入力ファイルが失われていた）

• 標準出力・標準エラー出力を受け取る形で呼び出すと、文書変換が終わってもワーカープロセスが終了するまで（約15秒）戻らない不具合を修正。ワーカープロセス・文書変換を行うプロセスは、呼び出したプロセスの標準入力・標準出力・標準エラー出力を引き継がない。（標準出力には、呼び出したプロセスのメッセージだけが出力されます。文書変換の結果は終了コード・結果ファイル・ログファイルで確認してください）

2026/04/01 Version 1.1.1

• ジョブキュー管理プロセスの存在確認の信頼性を向上。

2026/03/05 Version 1.1.0

• 印刷ジョブの管理方式を、従来のプロセス常駐方式からジョブキュー管理プロセス方式に変更。

• 文書変換非同期プロセス最大数を指定する -apmc を廃止。

• 文書変換非同期印刷開始最大数を指定する -asp を廃止。

• -o で出力ファイルを指定しなかった時に、-sdf や -fdf で指定したフォルダーに入力DocuWorks文書ファイルが移動されない問題を修正。

• -ssjbcd を指定した状態で DocuWorks Viewer がダイアログを表示した際にスクリーンショットの取得に失敗すると、ファイル移動などのエラー処理が行われない問題を修正。

• -ppto の判定開始タイミングを DocuWorks Viewer 起動直後に変更。
  過去バージョンでは、-ppto の判定開始が印刷ジョブ取得後だった為、印刷ジョブ取得前に DocuWorks Viewer が応答しない状態になった時は -ppto は適用されない。
  今回の変更では、DocuWorks Viewer 起動直後から1ページ目の出力ページの変化に対しても -ppto が適用されるので、印刷ジョブ取得前に DocuWorks Viewer が応答しない状態になってもページ出力タイムアウトが発生する事になる。

2026/02/26 Version 1.0.3

• スクリーンショットを保存するスイッチ -ssjbcd に指定するスクリーンショットファイル名に拡張子 .jpg を使用するとエラーとなってしまう問題を修正。

2025/11/17 Version 1.0.2

• DocuWorks 10のDocuWorks Viewerが表示するダイアログに対応。

• DocuWorks ViewerやDocuWorks PDFがダイアログを表示した際にスクリーンショットを保存するスイッチ -ssjbcd を追加。

• 対象プリンターの印刷キューから印刷ジョブ情報リストを取得する際に、印刷ジョブ情報リストの取得に失敗しても一定時間リトライするように変更。

• 取得した対象印刷ジョブ情報の状態取得に失敗した際に、「OSが対象印刷ジョブ情報を印刷キューから削除した」とみなして正常処理とするように変更。その際、終了コードは -2 となり、出力されるメッセージは「印刷終了は確認できませんでした」のような警告メッセージとなります。

• ログに記録する情報を調整。プロセス起動日時を追加。メッセージステータス(正常、警告、エラーの3種類)を追加。

• プリンター関連のエラーが発生した際に、詳細なエラーメッセージや状況メッセージを出力するように調整。

• 一部のプリンターが生成する印刷ジョブ情報の判定が想定通り行われない事がある問題を修正。

2025/03/05 Version 1.0.1

• タイムアウト発生時にDocuWorks Viewerを強制終了するスイッチ -ftwto を追加。

• 指定した時間が経過しても印刷ジョブのページ数が変化しなかった時にタイムアウトとするスイッチ -ppto を追加。

• 文書変換失敗時に入力DocuWorks文書ファイルをエラーフォルダーへ移動した際のログに、入力DocuWorks文書ファイルのフルパスを記録するように変更。

• ログ出力の際に、自身のプロセスのプロセスIDを記録するように変更。 (printToPdfFromDocuWorksFileのプロセスID)

• 起動したDocuWorks ViewerのプロセスIDをログに記録するように変更。

• 印刷ジョブを制御して、タイムアウト発生時の印刷ジョブのキャンセルや、印刷終了の判定などを行うように変更。(出力PDFファイルをqpdfでチェックしないように変更。)

• DocuWorks PDFが表示するエラーダイアログを検出した時に閉じるように変更。

• 印刷キューアプリケーションを検出した時に印刷処理を中断してエラー処理を行うように変更。

2024/12/22 Version 1.0.0

• 新規リリース。