'Unable to Find Resource navmap-mytheme.vm' Error Due to Navmap Custom Setting

プラットフォームについて: Data Center のみ。 - This article only applies to Atlassian apps on the Data Center プラットフォーム

この KB は Data Center バージョンの製品用に作成されています。Data Center 固有ではない機能の Data Center KB は、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。 Server* 製品のサポートは 2024 年 2 月 15 日に終了しました。Server 製品を実行している場合は、 アトラシアン Server サポート終了 のお知らせにアクセスして、移行オプションを確認してください。

*Fisheye および Crucible は除く

症状

atlassian-confluence.log に次のエラーが返される。

org.apache.velocity.exception.ResourceNotFoundException: Unable to find resource '/templates/macros/navmap-mytheme.vm' at org.apache.velocity.runtime.resource.ResourceManagerImpl.loadResource(ResourceManagerImpl.java:501) at org.apache.velocity.runtime.resource.ResourceManagerImpl.getResource(ResourceManagerImpl.java:384)

原因

If you are using a Navigation Map Macro with a theme, like:

{navmap:mylabel|theme=mytheme}

Confluence looks for pages with the label set to "mylabel" and locate the navmap-mytheme.vm file in WEB-INF/classes/templates/macros directory. If the vm file does not exist, Confluence will throw the above error saying that it is unable to find the file.

Such error usually happens due to a copy and paste of the macro from the documentation page when testing for the macro functionality. A user might be using the macro without knowing that it refers to a custom setting for navmap macro, which is defined in the vm file.

ソリューション

Remove the reference to the file if you are not using a customised navmap macro.

更新日時: September 25, 2025

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。