マクロとは
Using macros helps you to extend the capabilities of your Confluence pages and live docs, allowing you to add extra functionality or include dynamic content. For example, use the Attachments macro to list files attached to content, or use the Widget Connector macro to include things like a YouTube video or Twitter feed.
Add a macro to your page or live doc
マクロを追加するには、次の手順に従います。
When editing, select from the toolbar
マクロを名前で検索して選択します。
必要に応じて設定します。
このページに「/」と入力して、ツールバーから を選択することで、同じリストを表示することもできます。続けてマクロの名前を入力して、リストをフィルタリングします。
マクロを編集するには、次の手順に従います。
マクロのプレースホルダーを選択します。
[編集] アイコン を選択して、設定パネルを開きます。
パラメーターを設定します。変更内容は、移動するごとに保存されます。
ページの編集を再開すると、パネルが閉じます。
中央揃え 、幅 、全幅 の各アイコンを使用して、一部のマクロの幅を調整することもできます。マクロを削除するには、ゴミ箱アイコン を選択します。
マクロ パラメーター
多くのマクロには、マクロの出力の制御に使用できるオプションのパラメーターがあります。
例えば、添付ファイル マクロにはオプションのパラメーターが 2 つあり、これによって次のことが可能です。
表示される添付ファイルのファイル形式の指定
表示される添付ファイルの旧バージョンが必要かどうかの選択
マクロ プレースホルダー
Macro placeholders are displayed in the editor where you have added a macro to a page or doc.
When editing, you can:
マクロ プレースホルダーをダブルクリックして (またはプレースホルダーをクリックして [編集] を選択) マクロ ダイアログ ウィンドウを開き、マクロのパラメーターを編集する
マクロ プレースホルダーを選択して、マクロの切り取り、コピー、および貼り付けを実行する
2 つのマクロ間の競合
Marketplace マクロ、またはアプリの中には、同じ内部 ID が割り当てられているため、一緒にインストールできないものがあります。以前にインストールしたマクロと重複する名前のアプリをインストールしようとすると、次のエラー メッセージが表示されます。
<アプリ B> をインストールできません
インスタンスに、同じパートナーにより作成され、技術的な制約のために「アプリ B」のインストールを許可していない <アプリ A> が含まれています。
最も手間のかからない解決策は、片方のアプリをアンインストールして、もう片方のアプリをインストールできるようにすることです。
また、Atlassian Marketplace から開発者に連絡して、エラーの対応を依頼することもできます。
エディタで利用可能なマクロ
以下は、エディタで使用できるマクロの一覧です。
マクロ名を選択して、オプションのパラメーターや例など、使用方法の詳細を表示します。
Marketplace のマクロ
Atlassian Marketplace では、さらに多くのマクロを利用できます。
ブロックされたマクロ
When you navigate to a page or live doc in Confluence, some macros may appear with a message informing you that an administrator has blocked this app:
Atlassian Marketplace のアプリを活用しているマクロを使用する場合、アプリ アクセス ルールが設定されているデータ セキュリティ ポリシーを通じて、組織管理者はアプリによるデータへのアクセスをブロックできます。このルールが適用されると、組織が選択した範囲でブロックされたアプリから提供されたマクロは使用できなくなります。
利用可能なオプションについては、Confluence 管理者にお問い合わせください。
ブロックされたマクロに関連付けられているアプリ データはどうなりますか?
ブロックされたマクロによって保存されるデータは、マクロを開発したパートナーの保存ポリシーの対象となります。 保存期間が過ぎるとこのデータは削除される場合があり、復元できなくなる可能性があります。 そのため、データが不足していることに気付いた場合は、データを保存するために必要な措置を講じることができるように Confluence 管理者に相談してください。
ページに「ブロックされたアプリ」エラーをユーザーに表示させたくない場合はどうすればよいですか?
As a workaround, you can remove the app blocked message from the content by removing the macro from the page or live doc. This will also delete any data on it that the app has stored within the macro, but will not remove data the macro may have stored in app storage that is subject to the partner’s retention policy, as above.
この内容はお役に立ちましたか?