マクロとは

マクロによって、Confluence ページの機能の拡張できます。これによって、別の機能を追加したり、動的コンテンツを組み込んだりできます。たとえば、添付ファイル マクロによって、ページに添付されたファイルをリストできます。また、ウィジェット コネクター マクロによって、YouTube ビデオや Twitter フィードなどを含められます。

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

マクロを追加するには、次の手順に従います。

  1. 編集時には、ツールバーから を選択します。

  2. マクロを名前で検索して選択します。

  3. 必要に応じて設定します。

このページに「/」と入力して、ツールバーから を選択することで、同じリストを表示することもできます。続けてマクロの名前を入力して、リストをフィルタリングします。

マクロを編集するには、次の手順に従います。

  1. マクロのプレースホルダーを選択します。

  2. [編集] アイコン を選択して、設定パネルを開きます。

  3. パラメーターを設定します。変更内容は、移動するごとに保存されます。

  4. ページの編集を再開すると、パネルが閉じます。

中央揃え アイコン、幅 アイコン、全幅 アイコンを選択して一部のマクロの幅を調整することもできます。マクロを削除するには、ごみ箱 アイコンを選択します。

マクロ パラメーター

多くのマクロには、マクロの出力の制御に使用できるオプションのパラメーターがあります。

例えば、添付ファイル マクロにはオプションのパラメーターが 2 つあり、これによって次のことが可能です。

  • 表示される添付ファイルのファイル形式の指定

  • 表示される添付ファイルの旧バージョンが必要かどうかの選択

マクロ プレースホルダー

マクロ プレースホルダーはエディタ内に表示され、ページにマクロを追加した場所を示します。

ページの編集時に次の操作が可能です。

  • マクロ プレースホルダーをダブルクリックして (またはプレースホルダーをクリックして [編集] を選択) マクロ ダイアログ ウィンドウを開き、マクロのパラメーターを編集する

  • マクロ プレースホルダーを選択して、マクロの切り取り、コピー、および貼り付けを実行する

2 つのマクロ間の競合

Marketplace マクロ、またはアプリの中には、同じ内部 ID が割り当てられているため、一緒にインストールできないものがあります。以前にインストールしたマクロと重複する名前のアプリをインストールしようとすると、次のエラー メッセージが表示されます。

<アプリ B> をインストールできません
インスタンスに、同じパートナーにより作成され、技術的な制約のために「アプリ B」のインストールを許可していない <アプリ A> が含まれています。

最も手間のかからない解決策は、片方のアプリをアンインストールして、もう片方のアプリをインストールできるようにすることです。

また、Atlassian Marketplace から開発者に連絡して、エラーの対応を依頼することもできます。

エディタで利用可能なマクロ

以下は、エディタで使用できるマクロの一覧です。

マクロ名を選択して、オプションのパラメーターや例など、使用方法の詳細を表示します。

Marketplace のマクロ

Atlassian Marketplace では、さらに多くのマクロを利用できます。

ブロックされたマクロ

Confluence 内のページに移動すると、管理者がこのアプリをブロックしたことを知らせるメッセージが一部のマクロで表示されることがあります。

管理者がこのアプリをブロックしました

Atlassian Marketplace のアプリを活用しているマクロを使用する場合、アプリ アクセス ルールが設定されているデータ セキュリティ ポリシーを通じて、組織管理者はアプリによるデータへのアクセスをブロックできます。このルールが適用されると、組織が選択した範囲でブロックされたアプリから提供されたマクロは使用できなくなります。

利用可能なオプションについては、Confluence 管理者にお問い合わせください。

ブロックされたマクロに関連付けられているアプリ データはどうなりますか?

ブロックされたマクロによって保存されるデータは、マクロを開発したパートナーの保存ポリシーの対象となります。 保存期間が過ぎるとこのデータは削除される場合があり、復元できなくなる可能性があります。 そのため、データが不足していることに気付いた場合は、データを保存するために必要な措置を講じることができるように Confluence 管理者に相談してください。

ページに「ブロックされたアプリ」エラーをユーザーに表示させたくない場合はどうすればよいですか?

回避策として、ページからマクロを削除することで、アプリがブロックされたというメッセージをページから削除できます。 これにより、アプリがマクロ内に保存したページ上のデータもすべて削除されますが、さきほどのパートナーの保存ポリシーの対象となるアプリ ストレージにマクロが保存したデータは削除されません。

 

さらにヘルプが必要ですか?

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