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.

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

JIRA や Bamboo、FishEye、Crucible サイト、または別の Confluence サイトから、すべてのガジェットを Confluence ガジェット ディレクトリに追加できます。これで、ユーザーはガジェットを選択して、Confluence ページに追加できるようになります。

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

  1.  Choose the cog icon , then choose General Configuration under Confluence Administration 
  2. Choose 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. 追加 を選択します。Confluence は URL をガジェット フィードに変換して、「追加されたガジェット フィード」の一覧に配置します。

On this page:

関連ページ

スクリーンショット：ガジェット フィードの購読

個々のガジェットの登録

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

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 で使用するためのガジェット登録

ガジェット URL を入手したあと、Confluence に登録すると、ユーザーはページにその URL を追加できるようになります。ガジェットを登録するには、システム管理者権限が必要です。 

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

  1. Choose the cog icon , then choose General Configuration under Confluence Administration
  2. Choose External Gadgets in the left-hand panel.
  3. 「新しいガジェットの追加」セクションの ガジェット仕様 URL  フィールドにガジェット URL を貼り付けます。
  4. Choose Add. Your gadget will be shown in the list of registered gadgets below and it will also become available in the macro browser.

スクリーンショット：外部ガジェットを一つずつ登録する


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

Confluence から単一のガジェットを削除するには、ガジェット URL の横にある 削除 ボタンをクリックします。

アプリケーションのガジェットを購読している場合は、購読全体を削除する必要があります。単独のガジェットの登録解除はできません。ガジェット フィード URL の横にある 削除 ボタンをクリックします。

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

  • ラベルなし