ページ プロパティ マクロ

マクロ

このページの内容

お困りですか?

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

コミュニティに質問

ページ プロパティ マクロとページ プロパティ レポート マクロを併用すると、複数のページから得た情報で表を作成できます。 

これらのマクロは以下の場合に適しています。

  • 稟議書の登録
  • ステータス レポート
  • ポリシーや手順に関するドキュメント

つまり、いくつかのばらばらな情報を、別のページで 1 つの相互参照表にまとめる場合です。 

このマクロを使用するには、以下に示すように、ページ プロパティ マクロを 1 つ以上のページに追加した上で、ページ プロパティ レポート マクロを別のページに追加する必要があります。

スクリーンショット: ページ プロパティ マクロが表示するステータス情報が含まれるプロジェクト ページ。 

スクリーンショット: 複数の異なるプロジェクト ページのページ プロパティ マクロのステータス情報を表示するページ プロパティ レポート マクロを含むページ。

 

tip/resting Created with Sketch.

これらの 2 つのマクロの例を、意思決定および 製品要件ブループリントで確認できます。

このマクロをページに追加する

このマクロを正しくセットアップするには多数の手順が必要になりますが、一度セットアップすればとても簡単に、マクロをほかのページにコピーしたり、テンプレートに追加したりすることができます。 

ページ プロパティ マクロをページに追加するには、次の手順を実行します。

  1. エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
  2. [Confluence コンテンツ] カテゴリから [ページ プロパティ] を選択します。
  3. [挿入] を選択します。
  4. マクロ本文に 2 列の表を作成します。
  5. 左の列には "プロパティ" を入力します。これらはレポート テーブルの列見出しになります。
  6. 見出し列のスタイルを左の列に適用します。これにより、ページ プロパティ レポート マクロに対してこれらがプロパティであることを示します。 
  7. 右の列には、各プロパティの値を入力します。これらがレポート テーブルの行を生成します。
  8. ページを保存します。
  9. ページにラベルを追加します (このラベルをページ プロパティ レポート マクロで指定する必要があります)。

次に、ページ プロパティ レポート マクロを別のページに追加する必要があります。

スクリーンショット: 縦型レイアウトを使用した、エディタのページのページ プロパティ マクロ。 

ページ プロパティのレイアウト オプション

水平または縦型レイアウト

表のプロパティを縦または水平方向に調整することを選択できます。必ず、見出し行または見出し列のスタイルをプロパティに適用して、ページ プロパティ レポート マクロに対してスタイルの保存場所を指定します。 

こちらは、水平レイアウトの例です。

スクリーンショット: 水平レイアウトを使用した、エディタのページのページ プロパティ マクロ。 

非表示または表示

ページ プロパティ マクロのコンテンツを、ページを表示しているユーザーに表示するかどうかを選択できます。 

これは、情報がすべてのユーザーに関連するものではない場合に役立ちます。たとえば、このマクロを使用してポリシーが最後にレビューや承認を受けた時点を追跡する場合、その情報をページそのものではなく、ページ プロパティ レポート マクロを含むページにのみ表示したいような場合があります。 

スクリーンショット: 非表示にするページ プロパティ マクロの設定。

1 ページに複数のページ プロパティ マクロを使用する

1 つのページに複数のページ プロパティ マクロを追加して、レポートにすべてのマクロを含めるか、特定のマクロのみを含めるかを選択できます。複数のマクロを使用することで、マクロの情報をページの他の情報のコンテキストで表示したり、個々のページ プロパティ マクロのレポートを作成したりすることができます。 

ページ プロパティ マクロには、個々のページ プロパティ マクロの識別に使用できるオプションの ID パラメーターが含まれます。 

レポートにすべてのページ プロパティ マクロのコンテンツを表示するには、次の手順を実行します。

  1. ページ プロパティ マクロを含むページにラベルを追加します
  2. ページ プロパティ レポート マクロでこのラベルを指定します

レポートに選択したページ プロパティ マクロのコンテンツを表示するには、次の手順を実行します。

  1. ページ プロパティ マクロを含むページにラベルを追加します
  2. 報告したいページ プロパティ マクロの ID を指定します
  3. ページ プロパティ レポート マクロでラベルと ID の両方を指定します

: ページ プロパティ レポート マクロでは、ページ ラベルと ID はそれぞれ 1 つのみ許可されます。

tip/resting Created with Sketch.

Confluence で製品要件を文書化する方法」で、ページ プロパティ マクロの使用例をご確認ください。この強力なマクロを使用することで、複数のページから情報を取得する概要ページを作成できます。

マクロ パラメーターを変更する

マクロ パラメーターは、マクロの動作を変えるために使用します。

マクロ パラメーターを変更するには、次の手順を実行します。

  1. エディタでマクロのプレースホルダーをクリックし、[編集] を選択します。
  2. 必要に応じてパラメーターを更新し、[挿入] を選択します。

このマクロで使用できるパラメーターの一覧は、次のとおりです。 

パラメーター

既定

説明

ページ プロパティ ID

(なし)

オプションの ID はページの特定のページ プロパティ マクロを識別するために使用されます。ページ プロパティ レポートでこの ID を指定し、この ID を使用したマクロのみの概要情報を含めることができます。

非表示Falseページ プロパティ マクロのデータを現在のページに表示するかどうかを決定します。この設定は、ページ プロパティ レポート マクロの詳細表示に影響しません。

制限事項

  • 左側の列のデータは、ページ プロパティ レポート マクロの列見出しを生成するために使用されるため、左側の列でマクロを使用することはできません。 
  • ページ内や Confluence ページの他の場所からメタデータを使用してメタデータを参照することはできません。
  • このマクロには、パネル マクロ内にある展開マクロ内に配置された際に正常に動作しないという既知の問題があります。CONFSERVER-59594 - Getting issue details... (課題情報を取得中...) STATUS をご参照ください。

このマクロを追加するその他の方法

手入力でこのマクロを追加する

{」と入力してからマクロ名の入力を開始すると、マクロの一覧が表示されます。

Wiki マークアップを使用してこのマクロを追加する

Wiki マークアップを使用してこのマクロを追加することはできません。


最終更新日 2024 年 4 月 2 日

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

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