添付ファイル マクロ
添付ファイル マクロは、ページに添付されたファイルの一覧を表示します。
また、(適切な権限を持つ) ユーザーは、次のようなことが可能です。
- ファイル一覧からファイルを直接ページにアップロードする
- 添付ファイルのプロパティとラベルを編集する
- 添付ファイルを削除する(これによってファイルのすべてのバージョンが削除されます)
- 画像添付ファイルをプレビュー表示する
- Officeコネクターを使用して、添付された Office や PDF の文書を編集する。
- ページに添付されたすべてのファイルをダウンロードする。
注意: 非常に大きな添付ファイルの場合は、マクロ パラメーターを使用してプレビューをオフにできます。
スクリーンショット:添付ファイルの詳細を示す、添付ファイルマクロ
添付ファイル マクロを使用する
ページに添付ファイル マクロを追加するには、次の手順を実行します。
- Confluence のエディタで、[挿入] > [その他のマクロ] を選択します。
- 対象のマクロを見つけて、選択します。
オートコンプリートでマクロエントリを高速化: タイプ{とマクロ名の先頭には、提案したマクロの一覧を表示します。詳細は、こちらを参照ください。リンク、ファイル、マクロ、メンションのオートコンプリート
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。
パラメーター
パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example
)。
パラメーター | 既定 | 説明 |
---|---|---|
ファイル名のパターン | すべて | 正規表現をコンマ区切りで表示した一覧。ファイル名を条件として添付ファイルをフィルターにかけるために使用します。パラメーターの値は正規表現でなければならないことに注意してください。例:
|
添付ファイルのラベル(labels ) | (なし) | ラベルの一覧。添付ファイルにフィルターをかけて表示するために使用します。複数のラベルを入力する場合は、ラベルをカンマで区切ります。Confluence が表示するのは、指定したラベルをすべて持つ添付ファイルだけです。(ANDによる一致で、ORは使えません。)添付ファイルにラベルを付ける方法については、ラベルの追加、削除、検索を参照してください。 |
古い添付ファイル バージョンを含む | false | 値が |
並び替え順序 | 日付 | 添付ファイルの並び替え順。注意:ページを表示している時に、列見出しをクリックすれば、ソート順序を変更できます。有効な値は以下のとおりです。:
|
順序の並び替え ( (sortOrder ) | 昇順 | Sort By パラメーターと組み合わせて使用します。添付ファイルを昇順または降順で並べ替えます。 |
アップロード許可 | 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=My page about chocolate|sortorder=descending|labels=chocolate,cookies|upload=false|preview=false}