robotsnoindex
robotsnoindex

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

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

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

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


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

添付ファイル マクロを追加するには:

  1. Confluence エディタで、 > [詳細を表示] の順に選択します。
  2. 挿入するアイテムを探して選択します
  3. [挿入] を選択します。

このページに「/」と入力して、ツールバーからを選択し、同じリストを表示することも可能です。

添付ファイル マクロを編集するには:

  1. マクロのプレースホルダーを選択します。フローティング ツールバーが表示されます。
  2. [編集] を選択します。右側のパネルが開きます。
  3. パラメータを修正します。変更内容は、移動するごとに保存されます。
  4. ページの編集を再開すると、パネルが閉じます。

パラメーター

パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (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 の場合、一覧の項目が展開している時には、プレビューが表示されます。


Wiki マークアップの例

Wiki マークアップは 従来のエディタでのみサポートされます。


robotsnoindex
robotsnoindex

Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。

マクロ名:  attachments

マクロ本文: なし。

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