This documentation relates to Gadgets and Dashboards 3.0.x
If you are using an earlier version, please view the previous versions of the Gadgets documentation and select the relevant version.

This page tells you how to add an Atlassian gadget to external websites.

On this page:

はじめに

Gadgets that display information from Atlassian applications, such as JIRA, should be able to run on iGoogle, Gmail and other web sites that provide OpenSocial​ containers​. Below are specific instructions for iGoogle and Gmail. You can experiment by adding a gadget to other sites, such as a Ning community like The Content Wrangler.

アトラシアンは iGoogle や Gmail など外部サイトでのガジェット使用をサポートの対象に含めていません

原則的には、iGoogle、Gmail、その他 OpenSocial ガジェットをサポートする外部サイトにアトラシアンガジェットを追加するのは可能なはずです。しかし、現段階では、こうした外部連携は試験的なものであり、連携に伴う複数の問題が発生しています。さまざまな外部連携を楽しんでいただきたいと考えますが、アトラシアンは iGoogle や Gmai、その他の外部サイトでのアトラシアンガジェットの使用をサポートしていないことにご注意ください。詳細については、ガジェットの制限を参照してください。

Permission to Access Data

External websites will only be able to access protected data if your Atlassian application recognises them as OAuth consumers. See how to configure external sites as OAuth consumers.

Without Oauth configuration, the external website will be able to display data that is visible to anonymous users, but not data that requires specific permissions.

Overview of Adding a Gadget to a Website

The exact procedure for adding a gadget depends on the website where you want to add the gadget. The basic steps are the same for all websites:

  1. Find the Atlassian gadget's URL, i.e. the URL for the gadget's XML specification file.
  2. Follow the procedure provided by the website where you want to add the gadget.

Finding an Atlassian Gadget's URL

ガジェットの 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 を検索する



iGoogle にアトラシアン ガジェットを追加する

You can customise your iGoogle home page by adding gadgets and moving them around on the page.

To add an Atlassian gadget to your iGoogle page,

  1. 上で説明したように、最初にガジェットの URL を検索します。
  2. Go to iGoogle and log in if you have a username and password.
  3. Click 'Add stuff' near the top right of the iGoogle page.
  4. The Google gadget directory will appear, showing a list of available gadgets. Click 'Add feed or gadget' in the left-hand panel.
  5. A text box will open, as shown above. Enter or paste the gadget's URL from your clipboard into the textbox and click 'Add'.
  6. iGoogle ホームページに戻ります。ガジェットが iGoogle ページに表示されます。

Gmail にアトラシアン ガジェットを追加する

You can add gadgets to the left-hand panel of your Gmail page.

To add an Atlassian gadget to your Gmail page,

  1. 上で説明したように、最初にガジェットの URL を検索します。
  2. Log in to Gmail.
  3. Click 'Settings' near the top right of the Gmail page.
  4. The Gmail settings page will appear. Click the 'Labs' tab.
  5. The Gmail Labs page will appear. This is a laboratory area or testing ground where Google allows you to use experimental features in Gmail. Scroll down to find the feature called 'Add any gadget by URL'.
  6. Select the 'Enable' radio button next to the 'Add any gadget by URL' feature, as shown here:
  7. Click 'Save Changes' to enable the new feature.
  8. A new 'Gadgets' tab will appear on your 'Settings' page. Click the 'Gadgets' tab.
  9. The 'Gadgets' page will appear, as shown in the screenshot below. Enter or paste your gadget's URL into the 'Add a gadget by its URL' textbox then click the 'Add' button.
  10. 下のスクリーンショットに示すように、ガジェットが Gmail ページの左側パネルに表示されます。


スクリーンショット：Gmail にガジェットを追加する



制限事項とサポート

The external integrations described above should work, but they are experimental at this stage. Have fun playing around with them.

(warning) Atlassian support does not cover the use of Atlassian gadgets on iGoogle, Gmail or other external web sites.

Problems with iGoogle and Gmail

You may receive an error message 'Not Found' or 'Invalid gadget specification' when you try to add an Atlassian gadget to iGoogle or Gmail. We are waiting for information from Google to determine if the problem lies in iGoogle or in the Atlassian Gadgets framework. Please watch JRA-20159 and CONF-19943 to keep track of this problem.

Please note the following limitations:

  1. Gadgets used on third-party websites must draw their content from a server that is accessible on the public internet. If you run your Atlassian applications behind a firewall, the third-party website will not be able to access the data and display it in the gadget. For example, if you put a JIRA gadget onto Gmail and your JIRA server is behind a firewall, the Google servers will not be able to retrieve the gadget specification and the JIRA gadget will display an error message on Gmail.
  2. We have had difficulty adding gadgets from servers that use SSL, because Google's servers do not appear to accept our SSL certificate. These problems can be difficult to debug without help from Google.
  3. Individual gadgets may or may not work well in Google's containers.
  4. The production version of iGoogle does not support all of the newer gadget and OpenSocial features. The newest features may require signing up for the iGoogle Developer Sandbox. See Hints for Developing in iGoogle Sandbox​.
関連トピック

Gadgets and Dashboards User Guide

2 Comments

  1. Anonymous

    iGoogle RIP

  2. Jeff Turner

    GMail Labs no longer has a Add any gadget by URL option.