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

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

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

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

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

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

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

  • 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 の場合、一覧の項目が展開している時には、プレビューが表示されます。

表示するアイテム数

(なし)

結果 1 ページ毎に表示する項目の数。

 

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}

 

その他のヘルプ