An attachment is any file that is included with your page. Examples of attachments are screenshots, photographs, other images, Word documents, presentations, PDF documents, videos and sound files. Attachments are useful when you want to share information that exists in another file format.

You can display a list of attachments on your page – these may be the files that are attached to the page or to any page in the space. Use the Attachments macro to show a list of the attachments on the current page. Use the Space Attachments macro to show a list of the attachments in the current space. Both these macros generate a table of attachments which is clickable.

Using the macros

To add the Attachments or Space Attachments macro to a page:

  1. In the Confluence editor, choose Insert > Other Macros.
  2. Find and select the required macro.

オートコンプリートでマクロを素早く入力する方法

Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete.

既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。

On this page:

関連ページ

Parameters of the Attachments macro

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

パラメーター

既定

説明

Filename Patterns

すべて

正規表現をコンマ区切りで表示した一覧。ファイル名を条件として添付ファイルをフィルターにかけるために使用します。パラメーターの値は正規表現でなければならないことに注意してください。例:

  • "jpg" のファイル拡張子を検索するには「.*jpg」を使用します (「*.jpg」ではありません )。
  • 「jpg」または「png」で終わるファイル名を検索するには、「.*jpg」、「.*png」を使用します。

Here is a tutorial on regular expressions.

アタッチメント ラベル(なし)A list of labels, used to filter the attachments to display. If you wish to enter more than one label, separate the labels with commas. Confluence will show only attachments that have all the labels specified. (The match is an AND, not an OR.) For information on labelling the attachments, see Adding Labels.

Include Old Attachment Versions

false

値が true である場合、以前のバージョンの添付ファイルが一覧に含まれます。

Sort By

日付

添付ファイルの並び替え順。注意：ページを表示している時に、列見出しをクリックすれば、ソート順序を変更できます。有効な値は以下のとおりです。:

  • date – sorts by reverse chronological order (newest first)
  • サイズ - 大きい値から小さい値の順に並べ替え
  • 名前 - アルファベット順に並べ替え
Sort Order昇順Sort By パラメーターと組み合わせて使用します。添付ファイルを昇順または降順で並べ替えます。

Allow Upload

true

これを選択した場合、添付ファイル一覧でユーザーが新しいファイルを参照、添付できるかどうか選択できます。

Page Title(なし)別のページの添付ファイルを表示するために使用します。ページのタイトルを入力しない場合、マクロは現在のページに添付されたファイルを表示します。

 

Viewing files and changing file properties from the Attachments macro

The list of files displayed by the Attachments macro can be expanded to show options for viewing the files and other actions, provided the user has the relevant permissions.

  • If you have specified the 'Allow Upload' parameter, users will be able to upload attachments directly from the list.
  • Users can remove attachments. Note that they can only remove the entire attachment, including all versions of the attachment. To remove a specific version of an attachment, they must go to the 'Attachments' view. See Deleting an Attachment.
  • Users can edit attachment properties and labels. If an attachment is an Office or PDF file, they will see the appropriate options for Office Connector files.

スクリーンショット：添付ファイルの詳細を示す、添付ファイルマクロ


Parameters of the Space Attachments macro

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

パラメーター既定説明
スペース(なし)Selects the Confluence space to display all attachments for. If no space is specified, the current space will be used.
Show Filter Controlstrueフィルター パネルを表示するかどうかを決定します。このオプションを選択した場合、ページを閲覧する人物はファイルタイプ別 (拡張子) またはラベル別に添付ファイルのリストにフィルターをかけることができます。

スクリーンショット: スペース添付ファイル マクロ

コー​​ドの例

参照先:

  • ラベルなし

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.