Jira カードを活用することで、Miro のボードで Jira 課題の作業を直接することができます。これにより、共同でのふりかえり、ストーリーサイジング、バックログの優先順位付け、ストーリーマッピング、その他のチーム活動に Jira 課題を取り入れることができます。
利用可能な環境：Starter、Business、Education、Enterprise
Jira Cloud、Jira Server（オンプレミス）、Data Center
利用可能ユーザー：チームメンバーのボード編集者
💡 Jira Cards についてはこちらをご覧ください：
Jira カードに関するよくある質問
Jira カードの設定とアンインストールの方法
– How to set up webHook for Jira Cards（Jira カード用に Webhook を設定する方法）/strong>
Jira カードと Jira アドオンで起こり得る問題
Jira カードの使用方法
Jira カードのインポート
ボードに Jira カードをインポートするには 2 つの方法があります。
- Jira 課題の URL をコピーしてボードに貼り付ける方法。もしくは、
- 作成] ツールバーの[ツール、メディア、インテグレーション] (+) アイコンを クリックし、[ Jira Cards] を選択して、ページ上の課題を 1 つ、複数、またはすべて選択し、[ 追加] をクリックします 。
まず、ご利用の Jira アカウントを Miro に接続する必要があります。ダイアログボックスで、個人の認証情報を使って Jira にログインし、接続を承認するよう促されます。
認証をクリックして Jira のアカウントにログイン
次に、アクセスできる課題が表示されます。
Jira カードのピッカー
ユーザーの Jira アカウント認証がない場合、担当者アバターは表示されず、カードの全体像も異なるものとなります。
閲覧者がボードのチームメンバーではない場合
Jira カードの作成
Jira カードは Miro 上で直接作成できます。Jira の課題は同時進行で作成され、すべてのカードフィールドが自動的に同期されます。
ボード上で Jira カードをゼロから作成するには 2 つの方法があります。
- Miro で Jira アプリを使用する方法。
- 既存の付箋またはカードを Jira カードに変換する方法。
- 作成ツールバーから、[他のアプリ] アイコン（ >> または + ）をクリックします。
- [Jira Cards] を選択します。
- ダイアログボックスで、[課題を作成] をクリックします。
- 必要事項を記入し、[作成] をクリックします。
ピッカーによる Jira カードの
Jira カードに一括変換
- 変換したい付箋を選択します
- コンテキストメニューの [Jira 課題に変換する] アイコンをクリックします
- モーダルで値（課題の種類、優先順位、担当者など）を選択し、[変換する] をクリックします。選択した値は、すべての Jira カードに適用されます（つまり、課題の種類にバグを設定すると、すべての付箋はバグに変換されます）。付箋のテキストは、[要約] フィールドに移されます。
付箋は最大 50 件まで一度に変換できます。
カードを Jira カードに変換します
- 変換したいカードを選択します
- コンテキストメニューの [Jira 課題に変換する] アイコンをクリックします
- モーダルで値（課題の種類、優先順位、担当者など）を選択し、[変換する] をクリックします。選択した値は、すべての Jira カードに適用されます。たとえば、課題の種類にバグを設定すると、すべてのカードはバグに変換されます。カードの担当者、期日、説明は、新しい Jira カードにマッピングされます。
最大 50 枚までカードを一度に変換できます。
カードを Jira カードに一括変換
Jira カードの閲覧と編集
⚠️ Jira カードの編集は、Miro デスクトップアプリ、モバイルアプリ、タブレットアプリではサポートされていません
Jira カードは、サイドビューまたはセンタービューで閲覧できます。
カード表示オプション
Jira カードを編集するには、次の 2 つの方法があります。
- Miro ボード上のカードから編集する方法。あるいは、
- Miro ボード上のカードを介して Jira を編集する方法。
- 編集したいカードを選んで、ダブルクリックか、 [編集] アイコンをクリックします。
edit_jira_cards.png
編集ボタン
- 新しいポップアップ ウィンドウに Jira 課題が表示されます。変更を確定するには、ページの末尾にある [更新] をクリックし、ウィンドウを閉じます。
カードの
Jira 課題のステータスを変更するには、[ワークフロー] オプションを選択します。
jira_workflows.png
Jira 課題のステータスを編集
ポップアップから、 [ステータス] と [解決状況] を選択します。
Jira 課題を解決
⚠️ このオプションは、アトラシアンの基本的な機能（標準的なステータスと解決状況）のみに対応しています。ワークフローをプラグインやその他の方法でカスタマイズしている場合、利用できない可能性があります。
- Jira カードを編集するには、カードを選択し、 [ソース] ボタンをクリックします。
jira_edit_source.png
Jira カードを編集 -
次のタブで Jira の課題ページにリダイレクトされます。Jira のインターフェイスで変更を行うと、Jira カードは自動的に更新されます。
⚠️ 手動変更したものは即座に表示されます。スクリプトやその他の方法で自動的にアップデートされた Jira の課題変更は、わずかな遅れを伴うこともあります。
アップデート方法
| Jira インスタンスの更新 vs Miro カードの更新 | アップデートはいつ行われますか？ |
| OAuth 1.0 を介した Jira での更新 | Miro Jira Card はWebhook経由で即座に更新されます。 |
| OAuth 2.0 を介した Jira での更新 | Miro JiraカードはMiroボードの接続/再接続時に更新されます。 |
| ミロのアップデート | Miro Jiraカードは即座に更新され、対応するJira課題も同時に更新されます。 |
ポーリングは60分以上の一定間隔、またはMiroボードの接続/再接続中に行われます。ポーリング中、Miroは各ユーザーのトークンを使用してJira API経由でリクエストを送信し、カード/インスタンスデータが変更されたかどうかを確認します。
カードの色の変更
Jira カードの色を変更するには、カードを選択または、カードをクリックしコンテキストメニューから [色を塗る] をクリックします。カードを複製すると、新しい色がコピーに適用されます。jira_cards_color
Jira カードの塗りつぶしの色の変更
Jira カードでカスタムフィールドを有効化
アプリ内の Jira ピッカーを利用すると、見積、タグ、スプリント、その他多くのカスタムフィールドが、Miro ボードで使用する Jira カードに対して有効になります。カードに表示したいフィールドを選択するには、[Jira] > [Configure cards（カードを設定する）] をクリックします。
ボード上のカードに表示したいフィールドを選択
⚠️ 設定は作業中のボードのみに適用されるため、Jira のフィールドはボードによって異なる場合がありますのでご注意ください。デフォルトフィールド（担当者、課題タイプ、優先度、ステータス）をピッカーやカードから削除することはできませんが、追加フィールドがカードに不要な場合、いつでも設定をデフォルトにリセットできます。
✏️ ピッカーで選択したフィールドがボードに表示されない場合は、以下を意味しています。
- ボードに表示する値がフィールドに存在しない
- そのフィールドは該当する課題の種類に利用できない（例：Epic Name（エピック名）のフィールドはエピックの課題タイプのみで利用可能）
✏️ カードフィールドのリストにフィールドが見当たらない場合、以下を意味しています。
- Miro はその種類のフィールドに対応していない（例：カラータイプ カスタムフィールド）
- フィールドが Jira インスタンスに関連付けされていない。詳細は、Configuring custom field contexts（カスタムフィールドのコンテキストの設定）に関する Atlassian ガイドをご覧ください。Jira カードと Jira アドオンで起こり得る問題をお読みください。
検索オプション、JQL 検索
課題を選択すると、常に最新のタスクが最初に表示されます。
タスクの順序は以下の項目で変更することができます。
- 課題タイプ
- 優先度
- キー
- 要約
- 担当者
- ステータス
ベーシック検索ではキーワードで課題を見つけることができます。
高度な検索では Jira クエリ言語（JQL）を利用して構造化させたクエリを作成できます。クイック検索もしくはベーシック検索では設定できない条件を指定できます。JQL クエリの作成方法についてはこちらのアトラシアンの記事をご覧ください。
JQL 検索
✏️ インテグレーションの仕組みについては、こちらの FAQ 記事をご覧ください。
✏️ Miro チームへの Jira カードのインストールと設定方法については、こちらのガイドをご覧ください。
✏️ インテグレーションに問題が発生した場合（例：Jira カードが更新されない、報告者を選択できないなど）、こちらの記事をご参照ください。