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

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

  • ファイル一覧からファイルを直接ページにアップロードする 
  • 添付ファイルのプロパティとラベルを編集する
  • 添付ファイルを削除する（これによってファイルのすべてのバージョンが削除されます）
  • 画像添付ファイルをプレビュー表示する
  • Officeコネクター を使用して、添付された Office や PDF の文書を編集する。
  • ページに添付されたすべてのファイルをダウンロードする。 

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

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

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

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

  1. Confluence のエディタで、[挿入] > [その他のマクロ] を選択します。
  2. 対象のマクロを見つけて、選択します。

Speeding up macro entry with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete.

既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。

パラメーター

Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).

パラメーター

既定

説明

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

すべて

正規表現をコンマ区切りで表示した一覧。ファイル名を条件として添付ファイルをフィルターにかけるために使用します。パラメーターの値は正規表現でなければならないことに注意してください。例:

  • "jpg" のファイル拡張子を検索するには「.*jpg」を使用します (「*.jpg」ではありません )。
  • 「jpg」または「png」で終わるファイル名を検索するには、「.*jpg」、「.*png」を使用します。

添付ファイルのラベル
(labels)		(なし)ラベルの一覧。添付ファイルにフィルターをかけて表示するために使用します。複数のラベルを入力する場合は、ラベルをカンマで区切ります。Confluence が表示するのは、指定したラベルをすべて持つ添付ファイルだけです。（ANDによる一致で、ORは使えません。）添付ファイルにラベルを付ける方法については、ラベルの追加、削除、検索を参照してください。

古い添付ファイル バージョンを含む
(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}
  • ラベルなし