利用可能な対象：Jira Cloud、Jira Server（オンプレミス）、Datacenter（LDAP 保護も）
設定者：プロジェクトの管理者権限がある Miro のチームの管理者と Jira システムの管理者
⚠️ 技術的な問題が発生した場合、起こり得る問題と解決方法についての記事をご覧ください。
️💡 Jira カードについての詳細は、Jira カードの FAQ と Jira カードの WebHook の設定方法に関する記事をご覧ください。
Jira と Miro の設定
✏️️ ️ Jira のメニューは、使用している Jira バージョンによって異なる場合がありますが、一般的なフローは同じです。以下の手順は、Atlassian サポートでも確認できます。
ステップ 1 - アプリケーションのリンク
まず、アプリケーションのリンクを作成し、設定します。
- [Jira の設定] > [プロダクト] > [インテグレーション] > [アプリケーションのリンク] > [リンクの作成]
に移動します。Jira インターフェイスは、Jira のバージョンによって異なる場合があります。 - [ダイレクト アプリケーション リンク] を選択し、[アプリケーション URL] フィールドに https://miro.com/ と入力します。
重要：URL をこの正確なフォーマットに入力する必要があります。[続行] をクリックします。
リンクの作成 - 次のメニューで、[続行] をもう一度クリックするだけです。
- [レビューリンク] メニューで、URL が正確に https://miro.com/ であることを再度確認し、選択したアプリケーション名を入力します。スクロールダウンして、一番下の [受信リンクの作成] ボックスをオンにします。残りのフィールドをスキップし、[続行] をクリックします。
アプリケーション名フィールドの入力のみ必須です - ここに、Miro の値のフィールドが表示されます。値を取得するには、Miro にログインし、[チームの設定] > [アプリとインテグレーション] > [Jira カード]
に移動します。まだアプリリストに Jira カードがない場合は、このセクションを上までスクロールし、[アプリをインストール] をクリックして、Miro マーケットプレイスからアプリのインストールに進みます。リストに Jira カードが表示されたら、クリックして開きます。
プラグインタブが開き、ステップ 1 が表示されて、必要な値を取得することができます。
Jira カードの値
値をコピーし、Atlassian [レビューリンク] メニューに追加します。 - 1 ～ 2 秒間、処理メッセージが表示されます。
リンク作成の最終ステップ
これで、Atlassian 側での設定は完了です。このリンクは、アプリケーション リンクのリストに表示されます。
ステップ 2 - 接続
Miro のページに戻り、Webhook を手動で作成するか、自動で作成するか、2 つのオプションのどちらかを選択します。選択に応じて、オプションの署名を解除します。詳細については、こちらの記事をご覧ください。プラグインが大幅に更新された際にリセットする必要がないよう、自動 Webhook を使用することを強くお勧めします。
最後に、Jira の URL を入力し、[接続] をクリックします：
Jira カードの接続
Jira の URL を取得するには、Jira インスタンスのベース URL をコピーしてください。Miro では以下の形式を利用できます：
https://name.domain/
https://name.domain:port/
https://IPaddress/
https://IPaddress:port/
Jira の URL が受け入れられない場合は、こちらの記事をご覧ください。また、接続を確立するために Miro が Jira に対して十分なアクセス権があることも確認してください。
これで Miro のチームに Jira インスタンスが接続されました。
ユーザー認証
インテグレーションが接続されたら、各エンドユーザーは個人の Jira プロフィールを接続して適切なアクセス権を確立する必要があります。これにより、Miro 側の各ユーザーのアクセスが、Jira インスタンス側と全く同じになります。エンドユーザーが Jira カードを初めてインポートまたは編集しようとする場合、個人のユーザー資格情報を使用して Jira へログインするよう求められます。
これでホワイトボードにタスクをカードとして追加することができます。Jira で行われた変更はすべて、ボード上の Jira カードに反映されます。
✏️ ユーザーが Jira 資格情報を持っておらず、カードが追加されたボードへのアクセス権を持っている場合、カードのタイトル、課題の種類、優先度、担当者、Jira カードに表示されるように設定されているすべての属性が表示されます。ただし、許可しない限り、カードを展開して、他の属性を表示したり、カードを編集したりすることはできません。ユーザーが Jira 資格情報を接続しない場合、担当者のアバターが表示されず、カードの全体像も異なるものとなります。
複数の Miro のチームに Jira の 1 つのインスタンスを使用（オプション）
カードはチームレベルでインストールされるため、Enterprise プランを使用し、複数のチームがある場合、接続したいチームごとにステップ 2 を繰り返す必要があります。既存のアプリケーション リンクは、そのすべてのチームに使用されます。
チームを Jira インスタンスに接続すると、Jira WebHook では、接続した特定の Miro チームに対して、新しい Webhook が作成されます。Webhook を作成すると、更新リクエストのチャネルを確立できます。
⚠️ 複数のチームを接続する場合は、Jira Webhook ページに移動し、新しく作成された各 WebHook を編集して固有の名前を付けることをお勧めします。そうしないと、混乱する可能性があります。
複数の Jira インスタンスを 1 つの Miro のチームに接続することはできません。
プラグインのアンインストール
[チームの設定] > [アプリとインテグレーション] > [Jira カード] に移動し、ステップ 2 の Jira の URL を無効にします。その後、[チーム用にアンインストール] をクリックします。
Jira カードのアンインストール
💡 Jira カードの使用方法に関する主要記事もぜひご覧ください。