You can register gadgets from external web sites (such as JIRA, iGoogle or Gmail) with your Confluence installation, so that the gadgets appear in the macro browser and people can add them to Confluence pages via a gadget macro.

Choose one of the following ways to register the external gadgets on Confluence:

  • Subscribe to all of the external application's gadgets: You can add all the gadgets from your JIRA, Bamboo, FishEye or Crucible site – or from another Confluence site – to your Confluence gadget directory. People can then pick and choose the gadgets to add to their Confluence pages. 
  • 外部ガジェットを １ つずつ登録する場合：アプリケーションのガジェットを購読できない場合は、ガジェットを １ つずつ登録する必要があります。アプリケーションやウェブサイトがガジェットの購読をサポートしていない場合や、アプリケーション リンクを経由して、アプリケーションと信頼された関係を確立できない場合に、この方法が必要になります。

両方の方法について以下で説明します。まず、Confluence と他のアプリケーションの間に信頼された関係を設定する必要があるかどうかを検討します。

他のアプリケーションとの信頼された関係の設定

外部ガジェットの登録に加えて、ガジェットを提供するアプリケーション（サービス提供者）と Confluence（取得者）との間に OAuth リンク、または信頼されたアプリケーション関係を設定することをお勧めします。外部 Web アプリケーションからのアクセスを制限しているデータにアクセスするガジェットには、信頼された関係が必要です。

See how to configure OAuth or Trusted Applications Authentication, using Application Links.

ガジェットに必要なすべてのデータへの匿名アクセスを外部 Web アプリケーションが提供している場合、信頼された関係は必要ありません。

For example, if your gadgets will retrieve data from JIRA and your JIRA server includes projects and issues that are restricted to logged-in users, then you will need a trust relationship between Confluence and JIRA. If you do not set up the trust relationship, then the gadgets will show only the information that JIRA makes visible to anonymous users.

アプリケーションのガジェットすべての購読

You can add all the gadgets from your JIRA, Bamboo, FishEye or Crucible site – or from another Confluence site – to your Confluence gadget directory. People can then pick and choose the gadgets to add to their Confluence pages.

別のサイトのガジェットを購読するには、

  1. Choose Browse > Confluence Admin.
  2. Click External Gadgets in the left-hand panel.
  3. Click the Gadget Feeds tab.
  4. Enter the base URL of the application you want to subscribe to, in the text box labelled Gadget Feed URL. For example, http://example.com/jira or http://example.com/confluence.
  5. Click Add. Confluence will convert the URL to a gadget feed and place it in the list of 'Added Gadget Feeds'.

On this page:

関連ページ

(warning) The information on this page does not apply to

[Unable to render {include} The included page could not be found. ({include} をレンダリングできません。ページが見つかりませんでした)] を選択し、
.

Screenshot 1: Subscribing to a gadget feed

個々のガジェットの登録

アプリケーションのガジェットを購読できない場合は、ガジェットを １ つずつ登録する必要があります。アプリケーションやウェブサイトがガジェットの購読をサポートしていない場合や、アプリケーション リンクを経由して、アプリケーションと信頼された関係を確立できない場合に、この方法が必要になります。

First you will need to obtain that gadget's URL and copy it to your clipboard.

アトラシアン アプリケーションからのガジェット URL の取得

If your web application is another Atlassian application such as Confluence or JIRA:

ガジェットの URL はガジェットの XML 仕様ファイルを指し示しています。一般的には、ガジェットの URL は次のようになります。
http://example.com/my-gadget-location/my-gadget.xml

プラグインでガジェットが提供されている場合、URL は次の形式になります。
http://my-app.my-server.com:port/rest/gadgets/1.0/g/my-plugin.key:my-gadget/my-path/my-gadget.xml
例:
http://mycompany.com/jira/rest/gadgets/1.0/g/com.atlassian.streams.streams-jira-plugin:activitystream-gadget/gadgets/activitystream-gadget.xml

JIRAで ガジェットのURLを見つけるには：

  • 画面左上の「ダッシュボード」リンクをクリックして、ダッシュボードに移動します。
  • ガジェット追加 をクリックして、 ディレクトリ内にあるガジェットの一覧を表示します。
  • 次のツールを 1 つ以上使用して、必要なガジェットを探します：
    • 右のスクロールバーを使用して、ガジェット一覧を上下に移動します。
    • 左側のパネルでカテゴリを選択して、そのカテゴリのガジェットだけを表示します。
    • 検索 テキストボックスにガジェットのキーワードを入力します。入力に応じてガジェット一覧が変わり、検索語に一致するガジェットだけが表示されます。
  • そのガジェットの ガジェット URL リンクを右クリックし、 クリップボードにガジェットの URL をコピーします。

Confluenceで ガジェットのURLを見つけるには：

  • ヘルプ > Confluence ガジェット を選択して、利用可能な Confluence ガジェットの一覧を表示します。
  • 希望のガジェットを検索します。
  • そのガジェットの ガジェット URL リンクを右クリックし、 クリップボードにガジェットの URL をコピーします。

他のアプリケーションからのガジェット URL の取得

If the gadget comes from a non-Atlassian web application or web site, please consult the relevant documentation for that application to obtain the gadget's URL.

Confluence で使用するためのガジェット登録

Now that you have the gadget's URL, you can register it in Confluence, so that people can add it to their pages.

Confluence にガジェットを登録するには、

  1. Choose Browse > Confluence Admin.
  2. Click External Gadgets under 'Configuration' in the left panel. The 'External Gadgets' page is displayed.
  3. In the 'Add a new Gadget' section, paste your gadget's URL into the Gadget Specification URL field.
  4. Click Add. Your gadget will be shown in the list of registered gadgets below and it will also become available in the macro browser.

Screenshot 2: Registering external gadgets one by one

外部ガジェットへのアクセス削除

To remove a single gadget from Confluence, click the Remove button next to the gadget URL.

If you have subscribed to an application's gadgets, you will need to remove the entire subscription. You cannot unregister a single gadget. Click the Remove button next to the gadget feed URL.

ガジェットはマクロ ブラウザで利用できなくなり、ユーザーはガジェット マクロを使用してガジェットを追加することはできなくなります。それまでにガジェットを使用していたすべてのページには、切れたガジェット リンクが表示されます。

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.