添付ファイルマクロを挿入する

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

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

  • ファイル一覧からファイルを直接ページにアップロードする 

  • 添付ファイルのプロパティとラベルを編集する

  • 添付ファイルを削除する(これによってファイルのすべてのバージョンが削除されます)

  • 画像添付ファイルをプレビュー表示する

  • Officeコネクターを使用して、添付された Office や PDF の文書を編集する。

  • ページに添付されたすべてのファイルをダウンロードする。 

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

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

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

  1. 編集時には、ツールバーから を選択します。

  2. 挿入するアイテムを探して選択します

  3. [挿入] を選択します。

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

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

  1. マクロのプレースホルダーを選択します。フローティング ツールバーが表示されます。

  2. 編集を選択します。右側のパネルが開きます。

  3. パラメータを修正します。変更内容は、移動するごとに保存されます。

  4. ページの編集を再開すると、パネルが閉じます。

パラメーター

パラメータは、マクロ出力の内容や形式を制御するために設定するオプションです。 

Confluence Cloud ストレージ形式または wikimarkup で使用されるパラメーター名が、ブラウザやスラッシュ コマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載します (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 マークアップは従来のエディタでのみサポートされます。

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

マクロ名: attachments

マクロ本文: なし。

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

 

その他のヘルプ