Using the Issue Collector
「課題コレクター」とは
課題コレクターを使用すると、JIRA フィードバックフォームをユーザー自身の Web サイトに容易に組み込むことができます。一般的に、Web サイトのページの端にある「トリガー」タブをクリックすることでこのフォームにアクセスできます。
Web サイトを訪れた訪問者がこのトリガータブをクリックして、記入した JIRA フィードバックフォームを送信すると、JIRA で課題が簡単に作成されます。
Web サイトの訪問者は JIRA フィードバックフォームを使用するために JIRA のログインアカウントを持っている必要はありません。
JIRA の課題コレクターへのアクセス
In JIRA, issue collectors are configured (and hence organised) on a per-project basis.
JIRA で設定されたすべての課題コレクターにアクセスするには:
- 「JIRA 管理者」グローバル権限を持つユーザーとしてログインします。
- Choose > Add-ons. Select Issue Collectors to open the Issue Collectors page, which shows a list of all existing issue collectors in your JIRA system.
Keyboard shortcut: g + g + start typing issue collectors
- プロジェクトの名前をクリックして、そのプロジェクトに属している課題コレクターの詳細リストにアクセスするか、課題コレクターの名前をクリックして、詳細情報にアクセスします。課題コレクターページ (詳細情報を含む) では以下にアクセスできます。
- アクティビティグラフ。この課題コレクターを通じて作成された課題の数 (Y 軸) が日単位 (X 軸) で表示されます。
- この課題コレクターを通じて作成された最近の課題のリスト (新しい順)。
On this page:
特定のプロジェクトに属す課題コレクターにアクセスするには:
- Log in to JIRA as a project administrator or a user with the JIRA Administrators global permission.
A project administrator is someone who has the Administer Project project-specific permission, but not necessarily the JIRA Administrators global permission.
- Choose > Projects.
Keyboard shortcut: g + g + start typing project
- On the left of the Project Summary page, click the Issue Collectors tab. The Issue Collectors page is displayed, listing any issue collectors that have already been set up in your project.
- 課題コレクターの名前をクリックして詳細情報にアクセスします (特に、最近のアクティビティや課題コレクターを Web サイトに組み込む方法の詳細)。
課題コレクターの追加
- Log in to JIRA as a project administrator or a user with the JIRA Administrators global permission.
- Choose > Projects.
Keyboard shortcut: g + g + start typing project
- On the left of the Project Summary page, click the Issue Collectors tab. The Issue Collectors page is displayed, listing any issue collectors that have already been set up in your project.
- Click the Add Issue Collector button to open the Add Issue Collector page.
In the top section of the Add Issue Collector page, specify the following:
名前 JIRA ユーザーインターフェイスで一貫して表示される課題コレクターの名前を指定します。 説明 Specify a description for the issue collector. This description will appear adjacent to the Name of your issue collector, throughout the JIRA user interface. 課題タイプ Web サイトの訪問者が課題コレクターの JIRA フィードバックフォームを送信したときに JIRA で作成される課題のタイプを選択します。 Issue Reporter Web サイトの訪問者が課題コレクターの JIRA フィードバックフォームを送信すると作成される JIRA 課題の既定の報告者となるユーザー名を指定します。 Match Reporter? 以下のいずれかを選択します。 - Always use Issue Reporter — select this option to ensure that the default Issue Reporter you specify above, will always be the reporter of issues created by submission of the JIRA feedback form on your web site.
- 送信者のセッションまたは送信者のメール アドレスと一致するか試す — Web サイトの JIRA フィードバックフォームの送信により作成される課題の報告者を JIRA ユーザーにする場合はこのオプションを選択します。
- あなたの Web サイトにおいて JIRA フィードバックフォームの送信時に JIRA にログイン中のユーザー (同じブラウザーセッション内)。
- Who's email address matches the email address specified in the E-mail field of the JIRA feedback form.
Please note that if the JIRA user does not have the Create Issues project permission in your JIRA project, the default Issue Reporter you specify above will be used as the issue's reporter.
Collect Browser Info ブラウザの統計に関するメタ情報を収集する場合はこのオプションを選択します。この情報は Web サイトで JIRA フィードバックを送信することで、作成された課題に組み込まれます。 In the middle section of the Add Issue Collector page (entitled Trigger), specify the following:
Trigger Text Web サイトのトリガータブに表示される短い簡潔なフレーズを指定します。 Trigger Style Choose the style in which trigger tab will appear on your web site. Custom will not display a trigger but will add additional javascript to the generated script, so you can create a custom trigger on your web page. In the lower section of the Add Issue Collector page (entitled Issue Collector Form), specify the following:
テンプレート 提供されているオプションから選択します。一般的に、選択内容は作成する課題タイプを反映します (例: 上記で選択したもの)。選択肢は次のとおりです。
- A predefined template for your JIRA feedback form — either Got Feedback? or Raise a Bug.
- Custom to create a custom JIRA feedback form, which allows you to specify your own wording on the dialog box as well as add or remove other fields on the form and change their positions on the form.
- 選択した課題タイプでフィールドが必須となっており、フィールドが以下にあてはまる場合は注意してください:
既定値が指定されていない場合。フィールドはフォーム上に自動的に表示されます。フォーム上でこのフィールドの位置を変更できが、削除することはできません。
- フィールド以外の既定値がフォームに追加されていない場合。課題コレクターから課題を作成する際、フィールドの既定値が使用されます。
- 一部のフィールドは匿名ユーザーに表示できないため、すべてのタイプのフィールドをフォームに追加することはできません。表示可能なフィールドは次のとおりです。
- 標準フィールド: サマリー、説明、コンポーネント、影響を受けるバージョン、環境、優先度、添付ファイル
- カスタムフィールドタイプ: 日付と時刻、ラジオボタン、複数チェックボックス、マルチ選択、数字、選択リスト、URL フィールド、バージョンピッカー、カスケーディング選択、プロジェクトピッカー、単一バージョンピッカー、テキストフィールド、自由テキストフィールド
- 選択した課題タイプでフィールドが必須となっており、フィールドが以下にあてはまる場合は注意してください:
メッセージ ダイアログボックスの一番上の青い「情報」ペインに表示されるメッセージを入力します。 「送信 」ボタンをクリックして変更を保存します。
課題コレクターを自分の Web サイトに埋め込む
After clicking the Submit button (above) to save your new issue collector, a page containing code snippets is displayed. Use the code and information provided to embed your new issue collector into your web site.
If you accidentally click away from this page, you can easily retrieve the information that was on it by accessing your issue collector's details (above) and scrolling to the end of the page.
課題コレクターの編集
Editing an issue collector should not require any changes to web pages that include the issue collector, unless you change the Trigger Style to or from a custom trigger. Changing the Trigger Style to or from a custom trigger will change the generated javascript, so you may need to change what you embed in any web page that includes the issue collector.
To edit an existing issue collector:
- プロジェクト管理者またはJIRA 管理者グローバル権限を持つユーザーとして JIRA にログインします。
- 関連プロジェクトの課題コレクターのリストにアクセスします (上記)。
- In the Operation dropdown for the issue collector you would like to edit, select Edit to open the Edit Issue Collector page.
- 必要に応じて課題コレクターを更新します。
- 「更新」をクリックして変更を保存します。
課題コレクターのコピー
課題コレクターをコピーすると、完全に新しいコレクターが作成され、既存の課題コレクターには影響を与えません。新しい課題コレクターを作成した場合と同じように、希望する Web ページにコピーした課題コレクターを埋め込む必要があります。
To copy an existing issue collector:
- Log in to JIRA as a project administrator or a user with the JIRA Administrators global permission.
- 関連プロジェクトの課題コレクターのリストにアクセスします (上記)。
- In the Operation dropdown for the issue collector you would like to edit, select Copy to open the Add Issue Collector page.
- All the information from the copied issue collector will be the same as the copied issue collector with the exception of the name (which will be "Copy of " + the original name of the copied issue collector.
- Update the issue collector, if desired.
- 「送信 」をクリックして変更を保存します。
課題コレクターの無効化または削除
To disable or delete an issue collector:
- 関連プロジェクトの課題コレクターのリストにアクセスします (上記)。
- On the list of the project's issue collectors, click Disable or Delete to respectively disable or delete the associated issue collector.
While an issue collector is disabled, its trigger tabs will still be visible on pages of your web site(s) to which the issue collector code has been added until a user refreshes the page. However, clicking these triggers results in a message indicating that the issue collector is currently out of action.
既知の制限事項
フレームセット内に課題コレクタープラグインを配置しても、プロンプト画面は自動では閉じられません。
This is a known limitation for Issue Collector plugin and has been tracked at JRA-29886 - Getting issue details... STATUS

