課題コレクターの利用
特定のプロジェクトに属す課題コレクターにアクセスするには:
- > [プロジェクト] を選択し、関連するプロジェクトを選択します。
- プロジェクトを選択します。
- プロジェクト管理ページで、[課題コレクター] タブをクリックします。課題コレクター ページが表示され、プロジェクトでセットアップ済みの課題コレクターの一覧が表示されます。
- 課題コレクターの名前をクリックして詳細情報にアクセスします (特に、最近のアクティビティや課題コレクターを Web サイトに組み込む方法の詳細)。
課題コレクターの追加
- > [プロジェクト] を選択し、関連するプロジェクトを選択します。
- プロジェクトサマリーページの左側にある課題コレクタータブをクリックします。課題コレクターページが表示され、プロジェクトで既に設定済みの課題コレクターがリストされます。
- 課題コレクターの追加ボタンをクリックして課題コレクターの追加ページを開きます。
課題コレクターの追加ページの最上部で、次の項目を指定します。
名前 Jira ユーザーインターフェイスで一貫して表示される課題コレクターの名前を指定します。 説明 課題コレクターの説明を指定します。この説明は、Jira ユーザーインターフェイスで一貫して課題コレクターの名前の隣に表示されます。 課題タイプ Web サイトの訪問者が課題コレクターの Jira フィードバックフォームを送信したときに Jira で作成される課題のタイプを選択します。 課題の報告者 Web サイトの訪問者が課題コレクターの Jira フィードバックフォームを送信すると作成される Jira 課題の既定の報告者となるユーザー名を指定します。 報告者と一致? 以下のいずれかを選択します。 - 常に課題の報告者を使う — 上記で指定する既定の課題報告者が、自身の Web サイトの Jira フィードバック フォームの送信によって作成される課題の報告者に必ず設定されるようにするには、このオプションを選択します。
- Attempt to match user session of submitter or submitter email address — select this option if you want the reporter of an issue created by submission of the Jira feedback form on your web site to be a Jira user:
- あなたの Web サイトにおいて Jira フィードバックフォームの送信時に Jira にログイン中のユーザー (同じブラウザーセッション内)。
- Whose email address matches the email address specified in the email 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.
ブラウザ情報の収集 ブラウザの統計に関するメタ情報を収集する場合はこのオプションを選択します。この情報は Web サイトで Jira フィードバックを送信することで、作成された課題に組み込まれます。 「課題コレクターの追加」ページの真ん中のセクション (「トリガー」) で、次の項目を指定します。
テキストのトリガー Web サイトのトリガータブに表示される短い簡潔なフレーズを指定します。 スタイルのトリガー Web サイトにトリガータブを表示するスタイルを選択します。「カスタム」はトリガーを表示しますが、生成されたスクリプトに javascript を追加します。そのため、Web ページ上でカスタムのトリガーを作成できます。 「課題コレクターの追加」ページの下のセクション (「課題コレクターフォーム」) で、次の項目を指定します。
テンプレート 提供されているオプションから選択します。一般的に、選択内容は作成する課題タイプを反映します (例: 上記で選択したもの)。選択肢は次のとおりです。
- Jira フィードバックフォーム用の事前定義されたテンプレート — 「フィードバックの送信」または「バグの報告」。
- カスタムはカスタムの Jira フィードバックフォームを作成します。ダイアログボックス上で独自の用語を指定、フォーム上の他のフィールドを追加または削除、フォーム内の位置を変更できます。
- 選択した課題タイプでフィールドが必須となっており、フィールドが以下にあてはまる場合は注意してください:
既定値が指定されていない場合。フィールドはフォーム上に自動的に表示されます。フォーム上でこのフィールドの位置を変更できが、削除することはできません。
- フィールド以外の既定値がフォームに追加されていない場合。課題コレクターから課題を作成する際、フィールドの既定値が使用されます。
- 一部のフィールドは匿名ユーザーに表示できないため、すべてのタイプのフィールドをフォームに追加することはできません。表示可能なフィールドは次のとおりです。
- 標準フィールド: サマリー、説明、コンポーネント、影響を受けるバージョン、環境、優先度、添付ファイル
- カスタムフィールドタイプ: 日付と時刻、ラジオボタン、複数チェックボックス、マルチ選択、数字、選択リスト、URL フィールド、バージョンピッカー、カスケーディング選択、プロジェクトピッカー、単一バージョンピッカー、テキストフィールド、自由テキストフィールド
- 選択した課題タイプでフィールドが必須となっており、フィールドが以下にあてはまる場合は注意してください:
メッセージ ダイアログボックスの一番上の青い「情報」ペインに表示されるメッセージを入力します。 「送信 」ボタンをクリックして変更を保存します。
課題コレクターを自分の Web サイトに埋め込む
「送信」ボタンをクリックして新しい課題コレクターを保存すると、コードスニペットを含むページが表示されます。提供されたコードと情報を使用して、新しい課題コレクターを自分の Web サイトに埋め込みます。
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.
課題コレクターの編集
トリガー スタイルや、カスタム トリガーを変更しない限り、課題コレクターを編集するために、課題コレクターを含む Web ページを変更する必要はありません。トリガースタイルとカスタム トリガーを切り替えることで、生成される javascript が変わります。そのため、課題コレクターに含める Web ページへ埋め込む内容を変更する必要があります。
- プロジェクト管理者または Jira 管理者グローバル権限を持つユーザーとして Jira にログインします。
- 関連プロジェクトの課題コレクターのリストにアクセスします (上記)。
- 編集する課題コレクターの [操作] ドロップダウンで [編集] を選択して [課題コレクターの編集] ページを開きます。
- 必要に応じて課題コレクターを更新します。
- [更新] をクリックして変更を保存します。
課題コレクターのコピー
課題コレクターをコピーすると、完全に新しいコレクターが作成され、既存の課題コレクターには影響を与えません。新しい課題コレクターを作成した場合と同じように、希望する Web ページにコピーした課題コレクターを埋め込む必要があります。
- プロジェクト管理者または Jira 管理者グローバル権限を持つユーザーとして Jira にログインします。
- 関連プロジェクトの課題コレクターのリストにアクセスします (上記)。
- コピーする課題コレクターの「操作」ドロップダウンで「コピー」を選択すると、「課題コレクターの追加」ページが開きます。
- コピーされた課題コレクターからのすべての情報は、コピーされた課題コレクターと同じになります。ただし、名前 (コピーされた課題コレクターの名前 + "のコピー") を除きます。
- 必要に応じて課題コレクターを更新します。
- 「送信 」をクリックして変更を保存します。
課題コレクターの無効化または削除
- 関連プロジェクトの課題コレクターのリストにアクセスします (上記)。
- 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.
既知の制限事項
- iframe 内に課題コレクター プラグインを配置した場合、プロンプト画面は自動的に閉じられません。
これは Issue Collector プラグインに関する既知の制限であり、 JRASERVER-41400 - 課題情報を取得中... ステータス で追跡されています。
匿名ユーザーがプロジェクトで課題コレクターを作成しようとしたときに、そのプロジェクトに必須フィールドがあった場合、匿名ユーザーにそれらのフィールドは表示されません。結果として、ユーザーはコレクターを作成できません。
回避策として、フィールドを任意にします。これは Issue Collector プラグインに関する既知の制限であり、 JRASERVER-67094 - 課題情報を取得中... ステータス で追跡されています。