添付ファイル マクロは、ページに添付されたファイルの一覧を表示します。  

 また、(適切な権限を持つ) ユーザーは、次のようなことが可能です。

注意: 非常に大きな添付ファイルの場合は、マクロ パラメーターを使用してプレビューをオフにできます。 

スクリーンショット：添付ファイルの詳細を示す、添付ファイルマクロ

添付ファイル マクロを使用する

ページに添付ファイル マクロを追加するには、次の手順を実行します。

パラメーター

パラメーター

既定

説明

ファイル名のパターン
(patterns)

すべて

添付ファイルのラベル
(labels)		(なし)A list of labels, used to filter the attachments to display. If you wish to enter more than one label, separate the labels with commas. Confluence will show only attachments that have all the labels specified. (The match is an AND, not an OR.) For information on labelling the attachments, see Add, Remove and Search for Labels.

古い添付ファイル バージョンを含む
(old)

false

値が true である場合、以前のバージョンの添付ファイルが一覧に含まれます。

並び替え順序
(sortBy)

日付

添付ファイルの並び替え順。注意：ページを表示している時に、列見出しをクリックすれば、ソート順序を変更できます。有効な値は以下のとおりです。:

  • 日付 - 更新日付の新しい順に並び替え（新しい順）
  • サイズ - 大きい値から小さい値の順に並べ替え
  • 名前 - アルファベット順に並べ替え
  • 作成日付 - 作成日付の新しい順に並び替え（新しい順）
順序の並び替え
((sortOrder) 		昇順Sort By パラメーターと組み合わせて使用します。添付ファイルを昇順または降順で並べ替えます。

アップロード許可
((upload) 

true

これを選択した場合、添付ファイル一覧でユーザーが新しいファイルを参照、添付できるかどうか選択できます。

ページ タイトル
((page) 		(なし)別のページの添付ファイルを表示するために使用します。ページのタイトルを入力しない場合、マクロは現在のページに添付されたファイルを表示します。
プレビュー表示
(preview) 		true添付ファイルのプレビューを表示するために使用します。true の場合、一覧の項目が展開している時には、プレビューが表示されます。

コー​​ドの例

次の例は、Confluence ページの基礎となるマークアップを編集したい上級ユーザーのために提供します。

マクロ名: attachments

マクロ本文: なし。

保存形式の例

<ac:structured-macro ac:name="attachments">
  <ac:parameter ac:name="old">false</ac:parameter>
  <ac:parameter ac:name="patterns">.*png,.*jpg</ac:parameter>
  <ac:parameter ac:name="sortBy">name</ac:parameter>
  <ac:parameter ac:name="page">
    <ac:link>
      <ri:page ri:content-title="My page about chocolate"/>
    </ac:link>
  </ac:parameter>
  <ac:parameter ac:name="sortOrder">descending</ac:parameter>
  <ac:parameter ac:name="labels">chocolate,cookies</ac:parameter>
  <ac:parameter ac:name="upload">false</ac:parameter>
</ac:structured-macro>

Wiki マークアップの例

{attachments:old=false|patterns=.*png,.*jpg|sortby=name|page=Mypage about chocolate|sortorder=descending|labels=chocolate,cookies|upload=false|preview=false}