Jira タスク

Jira タスクについて

クアルトリクスでは、クアルトリクスで発生したイベントに基づいて、Jira で課題を作成または更新することができます。例えば、顧客がフィードバックアンケートに否定的な製品評価を投稿するたびに、それに基づいてJira課題を作成することができます。

Jira 課題の作成または更新後の操作については、アトラシアンのドキュメントを参照してください。

Jira クレデンシャルをクアルトリクスに接続する

ブランドのユーザーに Jira タスクを使用させる前に、ブランド全体で使用できる Jira アカウントを指定できます。管理ページの拡張機能タブに移動し、Jira を選択して開始します。

その後、2つの異なる認証機能を使って接続することができます：

• OAuth：Jira アカウントに直接ログインすることで、クアルトリクスに認証情報を入力することなくアクセスできます。
• 基本: 次の Jira 認証情報を提供して Jira に接続します：
  
  • Jira ユーザー名: Jira アカウントに関連付けられたメールアドレス。
  • API キー：Jira API トークン。新しいトークンの作成方法については、アトラシアンのドキュメントを参照してください。
  • Jira ドメイン：Jira インスタンスのドメインで、通常は Jira を使用する際のブラウザーの URL に記載されています。

クレデンシャルがここに追加されると、アカウントにアクセスできる人は誰でも Jira タスクでそのアカウントを使用できるようになります。

ブランド全体の認証情報を追加しない場合、Jira タスクを作成するユーザーは自分の Jira アカウントを追加する機会があります。

Jira タスクの設定

1. アンケートのワークフロータブまたはスタンドアロンのワークフローページに移動します。
   
2. ［ワークフローを作成］をクリックします。
3. ワークフローをスケジュール型にするかイベント型にするかを選択します。スケジュールワークフローとワークフローの比較 を参照。イベントベースワークフロー 各オプションの詳細については、こちらをご覧ください。
4. ワークフローにイベントを設定するか（イベントベースの場合）、スケジュールを決定します（スケジュールされた場合）。
   
5. ワークフローに条件を追加するには、プラス記号 (+ ) をクリックし、Add a condition をクリックします。条件は、ワークフローがどのような状況で実行されるかを決定します。詳しくは「条件の作成」を参照。
6. プラス記号 (+ ) をクリックし、タスクを追加します。
7. Jiraを選択します。
   
8. issueを更新するか、issueを作成するかを決定します。
   
9. ［次へ］をクリックします。
10. 接続するアカウントを選択します。
    
11. リストにない Jira アカウントをリンクする場合は、[ユーザー アカウントを追加] をクリックします。対比として、ブランド管理者がExtensionsページで追加したアカウントは、ブランド全体で使用することができます。
12. ［次へ］をクリックします。
13. issueを作成するインスタンスを選択します。

課題の作成

1. 課題を作成したいJira プロジェクトを選択します。
   
2. 作成したいissueのタイプを選択してください。
3. フィールドと値をマップする。詳細については、「課題フィールドと値のマッピング」を参照してください。
4. 終了したら、［保存］をクリックします。

コメントを追加

1. コメントを追加したい問題のキーを入力してください。イシューキーの例はQLTRCS-123である。
   
   Qtip: issueキーがアンケートデータとして回答に保存されている場合、テキストの差し込み ({a}) を使用してキーを取得することもできます。
2. このissueに添付されるコメントを入力します。テキストの差し込み ({a}) を使用して、アンケートのデータをコメントに含めることができます。

アップデートの問題

1. 更新する課題のJira プロジェクトを選択します。
   
2. 更新するissueのタイプを選択します。
3. 更新したいissueのキーを入力してください。イシューキーの例はQLTRCS-123である。
   Qtip: issueキーがアンケートデータとして回答に保存されている場合、テキストの差し込み ({a}) を使用してキーを取得することもできます。
4. 更新したいフィールドと値をマップします。詳細については、「課題フィールドと値のマッピング」を参照してください。

課題フィールドと値のマッピング

は必須項目です。必須フィールドに入力しないと、Jira タスクを作成できません。

• 課題の作成時に必要なフィールドすべてのissueタイプには、issueの名前であるSummary、または何を達成するかを説明する簡単なタイトルが必要です。サブタスクにも親を追加する必要があります。これはサブタスクを追加したいタスクのissue ID（issueキーではありません）です。
• issueの更新時に必要なフィールド：issueを更新するには、少なくとも1つのフィールドに任意の値を追加する必要があります。

必須項目を入力した後、issueに任意の項目を追加することができます。マッピングできる追加フィールドは、インスタンスやプロジェクトによって異なります。Jira によって提供される一般的なフィールドの例には以下が含まれます：

• エピック・リンク issueに追加したいエピックリンク。
• 担当者課題を割り当てたいJiraユーザー。名前からユーザーを検索し、ドロップダウンから選択することができます。あるいは、ユーザーのアカウントID（accountId）（24桁の一意識別子）を貼り付けることもできる。
• 説明関係する作業や解決するために取るべき行動など、問題の一般的な説明を書いてください。
• リンクされた課題：課題を Jira の別の課題にリンクし、関連する作業を追跡します。どのような種類のリンクでissueを関連付けたいかを選択し、次にどのissueにリンクするかを選択します。
  Qtip: ワークフロー内で作成された Jira ID を参照するためにテキストの差し込みを使用する場合、課題キーのテキストの差し込みを使用する必要があります。

フィールドの追加

1. テキスト差し込みボタン ({a}) を使用して、アンケート調査で収集した情報に基づいてフィールドの値を設定します。
   QTIP:ワークフローのイベントがアンケート回答に基づいていない場合、パイプされたテキストの差し込みフィールドは、イベントのソース（例えば、チケット更新イベントのチケットデータフィールド）に基づきます。
2. 作成するissueのフィールドの値をさらに指定するには、[フィールドの追加]をクリックします。
3. フィールドを削除するには、マイナス記号（–）をクリックします。デフォルトのフィールドを削除することはできません。

保存]をクリックして、Jira タスクの設定を完了します。

よくある質問