質問
⚠️ この事例は公開されてから1年以上経過しています。 情報が古い可能性がありますので、ご注意ください。
🕓 事例公開日 : 2025-05-27
【背景】
FormaDesignerでPDF印刷機能を使用していたが、システムメンテナンス後に機能が停止した。1. 事象
エラーメッセージ・スタックトレース：
開発者ツールでprintPage();を実行すると「undefined」が表示される
症状の説明：
FormaDesignerのボタンイベントに設定したprintPage();関数でPDF印刷を実行すると、エラーが発生してPDFが出力されない状態になっている。
2. 発生条件
・FormaDesignerでボタンイベントにprintPage();を登録している画面
・PDF印刷機能を使用する全ての処理
・Amazon Linux 2023移行メンテナンス実施後の環境
回答
1. 原因
技術的な原因：
Amazon Linux 2023への移行に伴い、wkhtmltopdfがインストールされていない環境となったため、PDF出力処理が実行できない状態になりました。技術的要因の分析：
・Amazon Linux 2023移行：新しいOSバージョンではwkhtmltopdfが標準で提供されない → PDF生成ライブラリが利用不可・
printPage()関数の依存関係：wkhtmltopdfに依存したPDF生成処理 → 関数が未定義状態となりエラー発生
・システムアーキテクチャの変更：従来のサーバーサイドPDF生成方式 → 新環境では対応不可
根本的な要因：
OS移行によるPDF生成ライブラリの廃止により、既存のPDF出力アーキテクチャが利用できなくなったことが根本原因です。2. 対応方法
根本解決方法：
以下のいずれかの方法でwkhtmltopdfを使わないアーキテクチャに変更してください： 1.クライアントサイドPDF出力：ブラウザ印刷機能を利用した実装に変更
2.
サーバーサイドPDF出力：IM-PDFDesignerを利用した実装に変更
暫定対処方法：
1. 有償個別対応のマネージドサービス「wkhtmltopdfの継続利用支援」の検討 詳細は以下のドキュメントをご確認ください：Amazon Linux 2のサポート終了に伴う対応について
3. 原因究明に至るまでの調査方法
1. PDF印刷機能の動作確認とエラー事象の特定2. 開発者ツールでの
printPage()関数実行テスト
3. Amazon Linux 2023移行メンテナンス履歴の確認
4. wkhtmltopdfインストール状況の調査
5. OS移行に伴うライブラリ変更の影響範囲確認