添付ファイル マクロ
添付ファイル マクロは、ページに添付されたファイルの一覧を表示します。
また、(適切な権限を持つ) ユーザーは、次のようなことが可能です。
- ファイル一覧からファイルを直接ページにアップロードする
- 添付ファイルのプロパティとラベルを編集する
- 添付ファイルを削除する（これによってファイルのすべてのバージョンが削除されます）
- 画像添付ファイルをプレビュー表示する
- Officeコネクターを使用して、添付された Office や PDF の文書を編集する。
- ページに添付されたすべてのファイルをダウンロードする。
注意: 非常に大きな添付ファイルの場合は、マクロ パラメーターを使用してプレビューをオフにできます。
添付ファイル マクロを使用する
添付ファイル マクロを追加するには、次の手順に従います。
- Confluence エディタで、
> [詳細を表示] の順に選択します - 挿入するアイテムを探して選択します
- [挿入] を選択します。
このページに「/」と入力してツールバーからを選択し、同じリストを表示することも可能です。
添付ファイル マクロを編集するには、次の手順に従います。
- マクロのプレースホルダーを選択します。フローティング ツールバーが表示されます。
- [編集] を選択します。右側のパネルが開きます。
- パラメーターを修正します。変更内容は、移動するごとに保存されます。
- ページの編集を再開すると、パネルが閉じます。
パラメーター
パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメーター名がブラウザで使用されるラベルと異なる場合は、以下に括弧付きで一覧表示されます (example)。
パラメーター | 既定 | 説明 |
|---|---|---|
ファイル名のパターン | すべて | 正規表現をコンマ区切りで表示した一覧。ファイル名を条件として添付ファイルをフィルターにかけるために使用します。パラメーターの値は正規表現でなければならないことに注意してください。例:
|
添付ファイルのラベル(labels) | (なし) | ラベルの一覧。添付ファイルにフィルターをかけて表示するために使用します。複数のラベルを入力する場合は、ラベルをカンマで区切ります。Confluence が表示するのは、指定したラベルをすべて持つ添付ファイルだけです (一致は AND で OR ではありません)。添付ファイルにラベルを付ける方法については、「ラベルを使用してページと添付ファイルを整理する」を参照してください。 |
古い添付ファイル バージョンを含む | false | 値が |
並び替え順序 | 日付 | 添付ファイルの並び替え順。注意：ページを表示している時に、列見出しをクリックすれば、ソート順序を変更できます。有効な値は以下のとおりです。:
|
| 順序の並び替え ( (sortOrder) | 昇順 | Sort By パラメーターと組み合わせて使用します。添付ファイルを昇順または降順で並べ替えます。 |
アップロード許可 | true | これを選択した場合、添付ファイル一覧でユーザーが新しいファイルを参照、添付できるかどうか選択できます。 |
| ページ タイトル ( (page) | (なし) | 別のページの添付ファイルを表示するために使用します。ページのタイトルを入力しない場合、マクロは現在のページに添付されたファイルを表示します。 |
| プレビュー表示 ( preview) | true | 添付ファイルのプレビューを表示するために使用します。true の場合、一覧の項目が展開している時には、プレビューが表示されます。 |
Wiki マークアップの例
Wiki マークアップは従来のエディタでのみサポートされます。
Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。
マクロ名: attachments
マクロ本文: なし。
{attachments:old=false|patterns=.*png,.*jpg|sortby=name|page=My page about chocolate|sortorder=descending|labels=chocolate,cookies|upload=false|preview=false}