添付ファイル マクロ

マクロ

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

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

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

  • ファイル一覧からファイルを直接ページにアップロードする 
  • 添付ファイルのプロパティとラベルを編集する
  • 添付ファイルを削除する(これによってファイルのすべてのバージョンが削除されます)
  • 画像添付ファイルをプレビュー表示する
  • Officeコネクターを使用して、添付された Office や PDF の文書を編集する。
  • ページに添付されたすべてのファイルをダウンロードする。 

注意:非常に大きな添付ファイルの場合は、マクロパラメーターを使用して、プレビューをオフにできます。 

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

添付ファイル マクロを使用する

ページに添付ファイル マクロを追加するには:

  1. エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
  2. 対象のマクロを見つけて、選択します。

オートコンプリートを活用して素早く入力: {」とマクロ名の先頭を入力すると、マクロ候補の一覧が表示されます。この例では、cheese マクロを挿入します。

既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。

パラメータ

パラメータは、マクロ出力の内容や形式を制御するために設定するオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example)。

パラメータ

既定

説明

ファイル名のパターン
(patterns)

すべて

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

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

添付ファイルのラベル
(labels)
(none) ラベルの一覧。添付ファイルにフィルターをかけて表示するために使用します。複数のラベルを入力する場合は、ラベルをカンマで区切ります。Confluence が表示するのは、指定したラベルをすべて持つ添付ファイルだけです。(ANDによる一致で、ORは使えません。) 添付ファイルにラベルを付ける方法については、ラベルの追加、削除、検索を参照してください。

古い添付ファイル バージョンを含む
(old)

false

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

並び替え順序
(sortBy)

日付

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

  • 日付 - 更新日付の新しい順に並び替え(新しい順)
  • サイズ - 大きい値から小さい値の順に並べ替え
  • 名前 - アルファベット順に並べ替え
  • 作成日付 - 作成日付の新しい順に並び替え(新しい順)
順序の並び替え
((sortOrder) 
昇順 Sort By パラメーターと組み合わせて使用します。添付ファイルを昇順または降順で並べ替えます。

アップロード許可
((upload) 

true

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

ページ タイトル
((page) 
(none) 別のページの添付ファイルを表示するために使用します。ページのタイトルを入力しない場合、マクロは現在のページに添付されたファイルを表示します。
プレビュー表示
(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}

最終更新日 2018 年 3 月 20 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.