データを追加
ページプロパティ
多数の Confluence ページにある構造化データを、1 つのライブテーブルへまとめます。各ページに同じ重要フィールドがあるプロジェクトポートフォリオ、意思決定ログ、依頼一覧に適しています。
ページを読み取る仕組み
このソースは、選択した 1 つのスペースの公開済みページにあるネイティブの Page Properties マクロを読み取ります。ラベルは 1 つ以上選択でき、いずれかのラベルに一致するページが対象になります。複数のラベルに一致しても同じページは 1 行だけ表示されます。既存の Page Properties Report を変換すると、レポートはライブの Simple Table マクロに置き換わり、元ページのプロパティが引き続きデータソースになります。
ライブの一覧を作成する
エディターでは検索、列、プレビューを同時に確認できます。以下の手順で一致するページをテーブルにします。
- 1
Page Properties を選ぶ
Simple Table マクロを追加し、Integrations を開いて Page Properties を選択します。
- 2
ページを探す
スペースを 1 つ、ラベルを 1 つ以上選び、「ページを検索」を押します。選択したラベルのいずれかと Page Properties マクロを持つページが対象です。複数のラベルに一致しても行は重複しません。スキャンは進行状況を示し、最大 5,000 ページを処理します。
- 3
フィールドを選ぶ
列でプロパティキーを選び、必要なら型を調整します。選択したフィールドは上部に移り、プレビューには最大 10 行が表示されます。
- 4
設定して公開する
「テーブルを設定」を選び、結果全体を確認します。Settings のプレビュー下部に保存済みのスペースと選択したすべてのラベルが表示されるので、対象範囲を確認してからページを保存または公開します。変更をすぐに取得するには更新を使用します。
ヒント
同じ一覧に含めるすべてのページで、同じプロパティ名を使ってください。読み手にとって理解しやすくなり、ページ間で列も安定します。
既存の Page Properties Report を変換する
公開済みページでは、フィルターと設定を Simple Tables に引き継げるネイティブの Page Properties Report が変換の提案に表示されます。置き換えを確定する前にレポートを確認してください。
- 1
移行画面を開く
「移行を開始」を選びます。テーブルとレポートは同じ一覧に表示され、各レポートのスペースとラベルは保持されます。確認するレポートを選びます。最初のレポートプレビューは、中央の案内にある「レポートをプレビュー」から読み込めます。未公開のページ変更がある場合は、以下の手順で先に公開してください。
- 2
レポートを読み込んで比較
対象のページを読み込んでいる間は、アニメーション付きの画面で進行状況を確認できます。検証後、「現在のデータ」とインタラクティブな「プレビュー」を比較できます。ページタイトルのリンクと検出した列書式も確認できます。検索、並べ替え、フィルター、ページ切り替えでソースが変更されることはありません。検証できない場合は変換前に再試行してください。
- 3
1つのレポートまたは対象の全項目を変換
選択中のレポート名が表示された変換ボタンを使います。対象の全テーブルとレポートを含める場合は、その横の「全件を変換する」チェックボックスを選択します。各レポートのソーススペース、ラベル、対応するプロパティ列を保持し、選択した置き換えを1つの新しいページ版としてまとめて公開します。
- 4
ライブの結果を確認
完了画面には検証済みの変換後レポートが表示され、複数の項目を変換した場合はタブで切り替えられます。サイドバーのガイドと Confluence のライブデモは新しいタブで開きます。「更新したページを表示」で公開結果を開けます。Simple Table マクロは引き続き元のソースページを読み取ります。マクロ設定から書式の調整、プロパティ列の追加、ラベルの変更ができます。
補足
公開済みページと内容が同じ下書きは、変換を妨げません。確認後にページや保存済みの下書きが変わった場合は、プレビューを作り直すため、再確認と再確定が必要です。確認をキャンセルしても何も公開されません。 選択したレポートを安全に読み取れない場合は、ネイティブのまま保持されます。
移行プレビューの見方
ネイティブテーブルと Page Properties Report の両方で同じ比較ができます。プレビューを開いても変更は公開されません。
現在のデータ
元の値を読み取り専用の Confluence 風テーブルで確認できます。リンクと対応するネイティブ書式が表示されます。Simple Tables の検索、並べ替え、検出した表示書式は適用されません。
プレビュー
検索、フィルター、並べ替え、ページ切り替えを使って Simple Tables の結果を試せます。これらの操作はローカルの表示にのみ適用されます。変換を確定すると、検出した列設定がマクロに保存されます。
データから検出する列書式
カテゴリ
繰り返し出現するテキスト値は、色付きの Enum カテゴリとして表示できます。既存のネイティブステータスの色やリッチコンテンツは保持されます。
数値、通貨、パーセント値
数値列には適切な数値や通貨の書式と右揃えが適用されます。0〜100 の明示的なパーセント値は進捗バーとして表示できます。
日付と真偽値
曖昧さのない YYYY-MM-DD 形式の日付は、Confluence 風の日付表示にできます。全行に true/false または yes/no が入った列は、真偽値の表示にできます。
検出は慎重に行われます。曖昧な日付や先頭にゼロがあるコードはテキストのまま保持し、リンクとネイティブのリッチコンテンツも維持します。結果を確認し、必要に応じてマクロ設定で列の種類や書式を調整してください。計算とグループ化は、自分で設定する機能です。
ページに未公開の変更がある場合の手順
タイトルや本文に未公開の変更がある場合、変更が1項目だけでもページ上の全テーブルとレポートのプレビューと変換を一時停止します。開いているエディターの内容が Confluence に保存されるまで待ち、公開してから再確認してください。
- 1
Confluence エディターで公開する
「エディターを開いて公開」を選びます。同じタブでエディターが開きます。他の共同編集者が保存した変更も含め、未公開の変更をすべて確認してから、Confluence の「公開」または「更新」を押してください。
- 2
最新の内容を確認して変換する
公開後、エディターを閉じた状態のページを確認します。バナーが最初の提案を表示している場合は、もう一度「移行を開始」を選びます。確認画面は最新の内容を読み込み、以前の選択をリセットします。テーブルやレポートを選び直し、更新されたプレビューを確認してから確定してください。未公開の変更がまだ表示される場合は、「公開しました — 再確認」を選びます。
ページ版はそれぞれ別に作成されます
未公開の変更の公開でページ版が1つ作成され、変換でさらに1つ作成されます。内容が異なる下書きがなければ、変換で作成される新しいページ版は1つだけです。
結果を確認できない場合
保存への応答が届かない場合や保存された結果を確認できない場合は、専用の確認画面で状況を説明し、「ページを再読み込み」を表示します。再読み込みしてページの変換後の内容を確認し、次に「編集」を選んで同じ内容があることを確認してください。Simple Tables が自動で公開を繰り返すことはありません。
公開済みページが対象です。 このバナーのフローは公開済みの Confluence ページが対象です。Live Docs は変換の提案から除外されます。
提案の表示頻度は徐々に少なくなります
変換のプレビューを開かずに提案を見送ると、提案の表示頻度は徐々に少なくなります。この間隔は、このサイトの全ページでアカウントごとに共有されます。
- 1
表示がある最初の日
最初の提案から24時間以内に最大5回表示されます。
- 2
次に表示がある日
次の表示がある24時間の期間内に最大2回表示されます。
- 3
表示がある3日目
1回表示され、その後7日間は表示されません。
- 4
週1回の提案が2回
7日後に1回、その7日後にもう1回表示されます。
- 5
月1回の提案
2回目の週次の提案から30日間待機します。その後は最大30日に1回表示されます。
表示のタイミングを選べます
利用しない期間に段階が飛ぶことはありません。次の期間は、新たな提案が表示されたときに始まります。プレビューを開くと、表示回数の残りをリセットしたり待機期間を短くしたりせず、現在の段階を1サイクル維持します。「このページでは不要」で、そのページの提案を自分に対して非表示にできます。再表示しても表示間隔はリセットされません。以前保存した一時停止は期限まで有効です。待機期間中はバナーもタブも表示されません。
変換が提案される条件
未変換のコンテンツだけが対象
既存の Simple Table マクロがバナーを表示させることはありません。対象のテーブルとレポートをすべて変換すると、提案は表示されなくなります。新しいネイティブテーブルやレポートを追加すると、再び提案される場合があります。
引き継げるフィルター
レポートの対象は 1 つのスペースと 1 つ以上のラベルである必要があります。すべてのスペースや複数スペースを対象とするレポート、Page Properties ID、独自の並べ替えなど、引き継げない設定を持つレポートはネイティブのまま残ります。対応する表示プロパティ列の順序は維持されます。
読み取れるソースプロパティ
縦方向の項目と値のテーブル、または見出し行と値の行を 1 行ずつ持つ横方向のテーブルを使用してください。プロパティ名は大文字と小文字を区別しない場合も一意である必要があります。結合セル、読み取れないソースページ、解釈が曖昧なプロパティテーブルがあると変換できない場合があります。
例: 別の一覧なしでプロジェクトポートフォリオを作る
各プロジェクトページに「project」ラベルを付け、同じ Page Properties フィールドを記録します。
- Atlas のプロジェクトページ
- ステータス: 順調 · 担当者: Maya · 予算: 80,000 ドル
- Beacon のプロジェクトページ
- ステータス: 要注意 · 担当者: Sam · 予算: 45,000 ドル
- ポートフォリオのテーブル
- 各プロジェクトページが 1 行になります。予算で並べ替えたり、要注意のプロジェクトだけを絞り込んだりできます。
更新と制限
テーブルは一致するページの公開済み Page Properties を読み取ります。元ページを変更したら更新し、新しいフィールドを追加したら選択済みの列を確認してください。
スキャン
選択したスペースで、いずれかの選択ラベルに一致する検索結果を最大 5,000 件確認します。進行状況とスキップされたページ数を表示し、そのうち最大 25 件の詳細を示します。ラベルを 1 つだけ保存している既存のテーブルも引き続き使用できます。
列の種類
値が一貫して該当する場合は日付や数値として認識されます。Confluence のネイティブステータスは色付きの Enum 列になる場合があり、その他の型が混在する値はテキストとして表示されます。
更新
ブラウザー内の直近の結果は最大 5 分間再利用される場合があります。変更をすぐに取得するには更新を使います。
新しいフィールド
新しいプロパティキーは列として自動追加されません。マクロ設定の Columns から新しいフィールドを追加してください。