問題

ページに画像を挿入したときに、ページにファイルが添付されているにもかかわらず Confluence が画像を不明な添付ファイルとして誤ってレンダリングする場合があります。  

不明な添付ファイルのプレースホルダーのスクリーンショット

原因

この問題は Confluence Server および Data Center のバグによって発生しています。

See CONFSERVER-55928 - Getting issue details... STATUS for more details of the issue. 

ソリューション

この挙動を発生される問題は Confluence 7.12.1 で修正され、7.4.9 にバックポートされています。ただし、この修正は問題の将来的な再発を防ぐもので、既存の破損した添付ファイルを修復するわけではありません。  

このため、誰かがページを表示または編集したときに不明な添付ファイルの調整を試みる、小規模なアプリを作りました。Confluence Unknown Attachment Reconciliation Plugin は、Confluence Server および Data Center 7.4.8 以降にインストールできます。  

アプリを入手するには次の手順を実行します。

1. https://marketplace.atlassian.com/apps/1225406/reconcile-unknown-attachments に移動します。
2. [Get it now] を選択してアプリ ファイルをダウンロードします。 
3. [管理] メニュー から [アプリの管理] に移動します。
4. [Upload] を選択し、Marketplace からダウンロードした reconcile-unknown-attachments-1.x.x.jar ファイルを選択します。 

機能の仕組み 

誰かがページを表示したときに、アプリによって不明な添付ファイルの表示が試行されますが、修復されたコンテンツが保存されるわけではありません。修復されたコンテンツは、誰かがページを編集して変更を公開すると保存されます。次のような制約があります。 

このアプリは次のことを行います。

• ページのメタデータを使い、不明な添付ファイルのプレースホルダーをいずれかの添付ファイルで修復しようとする
• ページに添付されているファイルが 1 つのみの場合、不明な添付ファイルのプレースホルダーを 1 つの添付ファイルで修復しようとする 
• ユーザーがページを編集して不明な添付ファイルを主導で修復できるようにする。編集者は不明な添付ファイルのプレースホルダーをクリックし、ファイルの挿入ダイアログから適切な添付ファイルを 1 クリックで選択できます。 
• 不明な添付ファイルを修復できた、あるいはできなかった理由の理解に役立つ複数のアナリティクス情報を記録する。これらは、お客様が Atlassian Analytics にオプトイン済みである場合にのみアトラシアンに送信されます。 
• 影響を受けていて修復できないページに追加のメタデータを追加する。これは、私たちがこのアプリを改善するにあたって対象のページをターゲットにできるようにするためです。  

次の条件を満たす場合、このアプリで不明な添付ファイルを修復することはできません。

• ファイルがファイル システムに存在しない (これはこのバグの症状とは一致しません)
• 不明な添付ファイルを添付ファイルに一致するために十分なメタデータがストレージ フォーマットに存在せず、ページに複数のファイルが添付されている
• 既存の共有下書きが公開されたときに一部のページ メタデータがストレージ フォーマットから失われたため、ページに未公開の変更がある。これが発生すると、ページの表示は適切に行えるが、未公開の変更を公開したあとは添付ファイルが不明な添付ファイルに戻ってしまう場合があります。これに該当する場合は、ページを編集し、不明な添付ファイルのプレースホルダーをクリックして、表示する適切なファイルを選択します。