添付ファイル マクロ
添付ファイル マクロは、ページに添付されたファイルの一覧を表示します。
また、(適切な権限を持つ) ユーザーは、次のようなことが可能です。
- ファイル一覧からファイルを直接ページにアップロードする
- 添付ファイルのプロパティとラベルを編集する
- 添付ファイルを削除する（これによってファイルのすべてのバージョンが削除されます）
- 画像添付ファイルをプレビュー表示する
- ページに添付されたすべてのファイルをダウンロードする。
注意: 非常に大きな添付ファイルの場合は、マクロ パラメーターを使用してプレビューをオフにできます。
スクリーンショット: 添付ファイルの詳細を示す添付ファイル マクロ
添付ファイル マクロを使用する
ページに添付ファイル マクロを追加するには、次の手順を実行します。
- エディタのツールバーで、[挿入]
> [その他のマクロ] を選択します。 - 対象のマクロを見つけて、選択します。
オートコンプリートを活用して素早く入力: 「{」とマクロ名の先頭を入力すると、マクロ候補の一覧が表示されます。この例では、cheese マクロを挿入します。
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。
パラメーター
Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).
パラメーター | 既定 | 説明 |
|---|---|---|
ファイル名のパターン | すべて | 正規表現をコンマ区切りで表示した一覧。ファイル名を条件として添付ファイルをフィルターにかけるために使用します。パラメーターの値は正規表現でなければならないことに注意してください。例:
|
添付ファイルのラベル(labels) | (なし) | ラベルの一覧。添付ファイルにフィルターをかけて表示するために使用します。複数のラベルを入力する場合は、ラベルをカンマで区切ります。Confluence が表示するのは、指定したラベルをすべて持つ添付ファイルだけです。(ANDによる一致で、ORは使えません。) 添付ファイルにラベルを付ける方法については、ラベルの追加、削除、検索を参照してください。 |
古い添付ファイル バージョンを含む | false | 値が |
並び替え順序 | 日付 | 添付ファイルの並び替え順。注意：ページを表示している時に、列見出しをクリックすれば、ソート順序を変更できます。有効な値は以下のとおりです。:
|
| 順序の並び替え ( (sortOrder) | 昇順 | Sort By パラメーターと組み合わせて使用します。添付ファイルを昇順または降順で並べ替えます。 |
アップロード許可 | true | これを選択した場合、添付ファイル一覧でユーザーが新しいファイルを参照、添付できるかどうか選択できます。 |
| ページ タイトル ( (page) | (なし) | 別のページの添付ファイルを表示するために使用します。ページのタイトルを入力しない場合、マクロは現在のページに添付されたファイルを表示します。 |
| プレビュー表示 ( preview) | true | 添付ファイルのプレビューを表示するために使用します。true の場合、一覧の項目が展開している時には、プレビューが表示されます。 |
Wiki マークアップの例
以下の例は、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタム コンテンツなど) でマクロを追加する場合に便利です。
マクロ名: attachments
マクロ本文: なし。
{attachments:old=false|patterns=.*png,.*jpg|sortby=name|page=My page about chocolate|sortorder=descending|labels=chocolate,cookies|upload=false|preview=false}添付ファイルの編集
Confluence では複数の方法で添付ファイルを編集できます。
添付ファイル マクロの一覧からファイルを編集するには、次の手順を実行します。
- ファイル名の横にある矢印をクリックして、そのファイルのバージョン履歴を表示します。
- 編集をクリックします。
- ファイルの編集に使用するアプリケーションを選択します。
- 変更を行い、デスクトップ アプリケーションでファイルを保存します。
- Confluence で [アップロード] をクリックし、編集済みのファイルを新しいバージョンとして保存することを確認します。
「Confluence でのファイルの編集」を参照してください。