Confluence(コンフルエンス)の小技紹介：「ページプロパティマクロを使ったコンテンツの整理術」

2023年03月27日（2025年07月30日更新）

りっくま Rickma

記事一覧へ

今回はリックソフトブログでConfluenceの便利マクロ機能「ページプロパティマクロ」を紹介します。

Confluenceのページプロパティってなあに？

「ページプロパティマクロ」は「ページプロパティレポートマクロ」とセット利用で効果を発揮するConfluenceマクロです。

「まだ使ったことが無いよ」「初めて聞いた」という方は、ぜひこの記事を最後までご覧いただき、便利ぃぃeeeee！な機能をご活用いただけると嬉しいです！

結論、「ページプロパティマクロ」で指定した属性（ラベルや「いいね！」/リアクション件数、作成者、最終変更時刻を表示）を「ページプロパティレポートマクロ」で一覧表示させるというものです。

まず活用例をご紹介し、その後使用方法を記載していきます。

【Confluenceページプロパティマクロの活用例１：社員紹介ページの作成】

ページプロパティマクロの活用例1件目は社員紹介、いわゆるプロフィール活用事例です。

まずは、ページプロパティマクロ単体で使ってみます。

（「プロフィール・・・」といえば平成の遺産に「プロフィール帳」なるものがありましたね。平成女児世代はドはまりしたのではないでしょうか・・？

キラキラのカラーペンで書いて沢山のシールを貼ったりしてね。。懐かしい良い思い出です。）

今回はせっかくですので、我々カスタマーサクセス課メンバーのプロフィールを作成してみます。

ページプロパティマクロは情報単体を作成するイメージです。

文字列のみではなく、画像ファイルやConfluenceの各種マクロを挿入することができます。ここでは画像ファイルを挿入します。

次に、ページプロパティレポートマクロで先に作成したページプロパティマクロの情報を一覧化してみます。

続いて社内開発プロジェクトの進捗管理の事例です。

ページプロパティマクロでプロジェクト情報をまとめ、ページプロパティレポートマクロで一覧表示させます。

ここから、マクロの使用方法についてです。

先ほどご紹介した「活用例２：開発進捗管理」の作成工程を記載します。

やや難易度が高いように思われがちですが、順を追って落とし込むことで問題なくご使用いただけるかと思います。

ますは素材を作成します。

次にラベルを指定します。

最終的に「ページプロパティレポートマクロ」でデータを一覧表示する際は、ラベルでピックアップします。

その為、使用するラベルを「手順１」で作成した各ページに付与します。

ここでは「タスク整理」というラベルを指定します。

設定済みのラベルを指定、もしくは新規ラベルを画面下部から設定します。

いよいよ、先に作成したデータを「ページプロパティレポートマクロ」で一覧表示します。

ページプロパティマクロで作成した各データをページプロパティレポートマクロで一覧表示するページを作成します。
編集メニューバーの「＋」を押下し、検索ボックスに「ページプロパティレポート」と入力、ページプロパティレポートマクロを選択挿入します。
表下部の編集アイコンを押下し、マクロ編集画面に遷移します。
ラベル指定ボックスに「手順２」で指定したラベル名を入力します。
その他、ラベルを参照するスペースの指定および各種オプションでデータ表示形式を任意で可変できます。
例：データの表示数/データに付与されている"いいね！数"を表示　など。
デフォルト表示の場合は最終更新順に上からデータが並びます。ここではスペース指定およびデータ縦列とタスク情報の横列を調整します。
任意条件を指定し、プレビューアイコンを押下すると、表示される内容が確認できます。
指定が完了したら「保存」を押下します。
ページ編集画面に、指定したマクロが挿入されます。
表下部のアイコンメニューから表の幅を可変することができます。
ここでは「標準の幅に戻す」を指定します。
完了です。

その他事項

ページプロパティマクロでは、ステータスマクロ、プロファイル画像マクロなどのマクロや画像データをプロパティ値として挿入できます。
ページプロパティレポートマクロで表示する一覧に、コメントやマクロから取得した情報などを表示する場合、
一覧上に大量の情報を付加するとマクロの読み込みでエラーになることがあります。その場合は、一覧の表示件数を減らすなどの対処が必要です。
ページプロパティマクロ同様、ラベルでコンテンツ情報を取得するマクロとして「コンテンツレポート表マクロ」が存在します。
こちらは、指定したラベルが付与されているページ一覧を表示するものです。
用途に合わせてご活用ください。

ページプロパティマクロに関して、簡単ではありますがご紹介させていただきました。ページに付与したラベルを活用することで、ドキュメント整理が円滑化されるかと思います。

ドキュメント整理にお困りの方は、ぜひラベルや各種マクロを試してみてください。

本ブログのカテゴリ： Confluence

りっくま Rickma