課題コレクターの利用

「課題コレクター」とは

課題コレクターを使用すると、Jira フィードバックフォームをユーザー自身の Web サイトに容易に組み込むことができます。一般的に、Web サイトのページの端にある「トリガー」タブをクリックすることでこのフォームにアクセスできます。

Web サイトを訪れた訪問者がこのトリガータブをクリックして、記入した Jira フィードバックフォームを送信すると、Jira で課題が簡単に作成されます。

Web サイトの訪問者は Jira フィードバックフォームを使用するために Jira のログインアカウントを持っている必要はありません。

注: 次のすべての手順では、Jira 管理者グローバル権限を持つユーザーとしてログインしている必要があります。

Jira の課題コレクターへのアクセス

Jira アプリケーションでは、課題コレクターはプロジェクトごとに設定されます (したがって編成も同様)。

Jira で設定されたすべての課題コレクターにアクセスするには:

  1.  > [システム] の順に選択し、
  2. [課題コレクター] を選択して課題コレクター ページを開くと、Jira システム内のすべての既存の課題コレクターの一覧が表示されます。
  3. プロジェクトの名前をクリックして、そのプロジェクトに属している課題コレクターの詳細リストにアクセスするか、課題コレクターの名前をクリックして、詳細情報にアクセスします。課題コレクターページ (詳細情報を含む) では以下にアクセスできます。
    • アクティビティグラフ。この課題コレクターを通じて作成された課題の数 (Y 軸) が日単位 (X 軸) で表示されます。
    • この課題コレクターを通じて作成された最近の課題のリスト (新しい順)。

特定のプロジェクトに属す課題コレクターにアクセスするには:

  1. > [プロジェクト] を選択し、関連するプロジェクトを選択します。
  2. プロジェクトを選択します。 
  3. プロジェクト管理ページで、[課題コレクター] タブをクリックします。課題コレクター ページが表示され、プロジェクトでセットアップ済みの課題コレクターの一覧が表示されます。
  4. 課題コレクターの名前をクリックして詳細情報にアクセスします (特に、最近のアクティビティや課題コレクターを Web サイトに組み込む方法の詳細)。

課題コレクターの追加

  1. > [プロジェクト] を選択し、関連するプロジェクトを選択します。
  2. プロジェクトサマリーページの左側にある課題コレクタータブをクリックします。課題コレクターページが表示され、プロジェクトで既に設定済みの課題コレクターがリストされます。
  3. 課題コレクターの追加ボタンをクリックして課題コレクターの追加ページを開きます。
  4. 課題コレクターの追加ページの最上部で、次の項目を指定します。

    名前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.
      (info) 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 フィードバックを送信することで、作成された課題に組み込まれます。
  5. 「課題コレクターの追加」ページの真ん中のセクション (「トリガー」) で、次の項目を指定します。

    テキストのトリガーWeb サイトのトリガータブに表示される短い簡潔なフレーズを指定します。
    スタイルのトリガーWeb サイトにトリガータブを表示するスタイルを選択します。「カスタム」はトリガーを表示しますが、生成されたスクリプトに javascript を追加します。そのため、Web ページ上でカスタムのトリガーを作成できます。
  6. 「課題コレクターの追加」ページの下のセクション (「課題コレクターフォーム」) で、次の項目を指定します。

    テンプレート

    提供されているオプションから選択します。一般的に、選択内容は作成する課題タイプを反映します (例: 上記で選択したもの)。選択肢は次のとおりです。

    • Jira フィードバックフォーム用の事前定義されたテンプレート — 「フィードバックの送信」または「バグの報告」。
    • カスタムはカスタムの Jira フィードバックフォームを作成します。ダイアログボックス上で独自の用語を指定、フォーム上の他のフィールドを追加または削除、フォーム内の位置を変更できます。
      • 選択した課題タイプでフィールドが必須となっており、フィールドが以下にあてはまる場合は注意してください:
        • 既定値が指定されていない場合。フィールドはフォーム上に自動的に表示されます。フォーム上でこのフィールドの位置を変更できが、削除することはできません。

        • フィールド以外の既定値がフォームに追加されていない場合。課題コレクターから課題を作成する際、フィールドの既定値が使用されます。
      • 一部のフィールドは匿名ユーザーに表示できないため、すべてのタイプのフィールドをフォームに追加することはできません。表示可能なフィールドは次のとおりです。
        • 標準フィールド: サマリー、説明、コンポーネント、影響を受けるバージョン、環境、優先度、添付ファイル
        • カスタムフィールドタイプ: 日付と時刻、ラジオボタン、複数チェックボックス、マルチ選択、数字、選択リスト、URL フィールド、バージョンピッカー、カスケーディング選択、プロジェクトピッカー、単一バージョンピッカー、テキストフィールド、自由テキストフィールド
    メッセージダイアログボックスの一番上の青い「情報」ペインに表示されるメッセージを入力します。
  7. 送信 」ボタンをクリックして変更を保存します。

課題コレクターを自分の Web サイトに埋め込む

送信」ボタンをクリックして新しい課題コレクターを保存すると、コードスニペットを含むページが表示されます。提供されたコードと情報を使用して、新しい課題コレクターを自分の Web サイトに埋め込みます。

(tick) 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 ページへ埋め込む内容を変更する必要があります。

  1. プロジェクト管理者または Jira 管理者グローバル権限を持つユーザーとして Jira にログインします。
  2. 関連プロジェクトの課題コレクターのリストにアクセスします (上記)。
  3. 編集する課題コレクターの [操作] ドロップダウンで [編集] を選択して [課題コレクターの編集] ページを開きます。
  4. 必要に応じて課題コレクターを更新します。
  5. [更新] をクリックして変更を保存します。

課題コレクターのコピー

課題コレクターをコピーすると、完全に新しいコレクターが作成され、既存の課題コレクターには影響を与えません。新しい課題コレクターを作成した場合と同じように、希望する Web ページにコピーした課題コレクターを埋め込む必要があります。

  1. プロジェクト管理者または Jira 管理者グローバル権限を持つユーザーとして Jira にログインします。
  2. 関連プロジェクトの課題コレクターのリストにアクセスします (上記)。
  3. コピーする課題コレクターの「操作」ドロップダウンで「コピー」を選択すると、「課題コレクターの追加」ページが開きます。
  4. コピーされた課題コレクターからのすべての情報は、コピーされた課題コレクターと同じになります。ただし、名前 (コピーされた課題コレクターの名前 + "のコピー") を除きます。
  5. 必要に応じて課題コレクターを更新します。
  6. 送信 」をクリックして変更を保存します。

課題コレクターの無効化または削除

  1. 関連プロジェクトの課題コレクターのリストにアクセスします (上記)。
  2. On the list of the project's issue collectors, click Disable or Delete to respectively disable or delete the associated issue collector.
    (info) 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 - 課題情報を取得中... ステータス で追跡されています。

最終更新日: 2020 年 2 月 26 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.