バックアップから添付ファイルを取得する
ページの添付ファイルは、Confluence にバックアップを復元する必要なく、バックアップから取得することができます。これは、ユーザーによって削除された添付ファイルを回復する場合に便利です。
「Include attachments」プロパティが設定されていれば、XML バックアップでこれを行うことができます。
以下の添付ファイルを復旧する手順を実施する前に、ストア ファイルとページ情報をバックアップする方法を確認します。
On this page:
関連ページ
ストア ファイルとページ情報のバックアップ方法
バックアップ zip ファイルには、entities.xml、Confluence コンテンツを含む XML ファイル、および添付ファイルを保存しているディレクトリが含まれています。
バックアップ zip ファイルの構造
ページの添付ファイルは、attachments ディレクトリにページと添付ファイル id ごとに保存されています。以下は一覧表示した例です。
Confluence 8.0 以前
Listing for test-2006033012_00_00.zip
\attachments\98\10001
\attachments\98\10002
\attachments\99\10001
entities.xml
Confluence 8.1 以降
Listing for test-2006033012_00_00.zip
\attachments\98\10001\1
\attachments\98\10002\1
\attachments\99\10001\3
entities.xml attachments ディレクトリ内では、内部にある各番号のディレクトリが 1 つのページであり、その内部にある番号のファイルが 1 つの添付ファイルです。ディレクトリの番号はページ ID であり、ファイルの番号は添付ファイル ID です。たとえば、ファイル \attachments\98\10001 は、ページ ID が 98 で添付ファイル ID が 10001 の添付ファイルです。entities.xml を参照して、これらの番号を元のファイル名にリンクさせることができます。entities.xml を使用すると、各ページ ID をページ タイトルにリンクさせることもできます。
entities.xml の Attachment オブジェクト
entities.xml 内では、Attachment オブジェクトが XML で記述されています。この例では、ページ id が98、添付ファイル id が10001で、ファイル名が myimportantfile.doc となっています。XML の他の部分は無視することができます。
<object class="Attachment" package="com.atlassian.confluence.pages">
<id name="id">10001</id>
<property name="title">myimportantfile.doc</property>
<property name="lowerTitle">myimportantfile.doc</property>
<property name="version">1</property>
...
<property name="containerContent" class="Page" package="com.atlassian.confluence.pages"><id name="id">98</id></property>
...
</object> entities.xml の Page オブジェクト
この XML はページを示しています。この例では、ページ id が98で、タイトルが Editing Your Files となっています。XML の他の部分は無視することができます。
<object class="Page" package="com.atlassian.confluence.pages">
<id name="id">98</id>
<property name="title"><![CDATA[Editing Your Files]]></property>
...
</object> 添付ファイルの復旧の手順
以下の手順に従って、各ファイルを個別に名前の変更および Confluence に再アップロードする必要があります。3つの方法のうち1つを選択してください。
各添付ファイルの最新バージョンを復旧するには、以下の手順に従って、各ファイルの名前を個別に変更し、Confluence に再アップロードする必要があります。3 つの方法のうち 1 つを選択してください。
選択肢 A - ファイル名ごとに添付ファイルを復旧
復元する必要がある各ファイルの名前がわかっている場合、特に数ファイルだけを復元する場合は、このオプションが最適です。
バックアップ ディレクトリを解凍し、entities.xml を開きます。
entities.xml でファイル名を検索し、そのファイル名の Attachment オブジェクトを見つけます。そのページ ID と添付ファイル ID を確認します。
entities.xml のページ ID と添付ファイル ID を使用して、attachments ディレクトリに移動し、そのページ ID のディレクトリを開きます。その添付ファイル ID のファイルを見つけます。
添付ファイルのディレクトリ内で、番号が最も大きいファイルの名前を元のファイル名に変更してテストします。
添付ファイルの各ディレクトリに対して同じ手順を繰り返します。
各ファイルを再び Confluence にインポートし、Confluence 内からファイルを添付して、元のページにアップロードします。
選択肢 B - ページごとにファイルを復元
特定のページの添付ファイルだけを復元する場合は、このオプションが最適です。
バックアップ ディレクトリを解凍し、entities.xml を開きます。
entities.xml でページ タイトルを検索し、そのタイトルの Page オブジェクトを見つけます。そのページ ID を確認します。
attachments ディレクトリに移動し、そのページ ID のディレクトリを開きます。このディレクトリの名前をページ タイトルに変更します。
entities.xml の Attachment オブジェクトをそのページ ID で検索します。そのページのすべての Attachment オブジェクトに、添付ファイル ID、バージョン、ファイル名があります。
各 Attachment オブジェクトについて、添付ファイルのディレクトリを見つけ、番号が最も大きいファイル (最新バージョン) の名前を元のファイル名に変更してテストします。
ページごとに同じ手順を繰り返します。
各ファイルを再び Confluence にインポートし、Confluence 内からファイルを添付して、元のページにアップロードします。
選択肢 C - すべてのファイルを復元
バックアップの規模は小さいが、内部の添付ファイルの多くまたはすべてを復元する必要がある場合は、このオプションが最適です。
以下の手順は、スペースのバックアップにのみ適用できます。サイトの XML バックアップでは、ページ ID が永続的であるため、ページ ID を手動で更新する必要はありません。
- バックアップ ディレクトリを解凍し、entities.xml を開きます。
- attachments ディレクトリに移動し、ディレクトリを開きます。そのディレクトリ名はページ ID です。ディレクトリ内の各添付ファイルの名前を変更する必要があります。
- entities.xml の Attachment オブジェクトをそのページ ID で検索します。見つかったら、添付ファイル ID とファイル名を確認します。
- その添付ファイル ID のファイル名を元のファイル名に変更し、テストします。
- 次の添付ファイル ID を見つけて、その名前を変更します。ディレクトリ内の各ファイルに対して同じ手順を繰り返します。
- 現在のディレクトリ内のすべてのファイル名を元のファイル名に変更したら、entities.xml でページ ID (ディレクトリ名) を検索します。そのページ ID の Page オブジェクトを見つけて、ページ タイトルを確認します。
- ディレクトリの名前をページ タイトルに変更し、次のディレクトリに移動します。attachments ディレクトリ内のまだ名前を変更していないディレクトリに対して同じ手順を繰り返します。
- 各ファイルを再び Confluence にインポートし、Confluence 内からファイルを添付して、元のページにアップロードします。