Jira連携

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

Jira は、プロジェクト管理と課題追跡に使用されるソフトウェア開発ツールです。Jira をプラットフォームとして利用することで、プロジェクトの計画、プロジェクト関連のタスクや課題の管理が行えます。また、チームがタスクや課題を重大度に基づいて整理・優先順位付けするのにも役立ちます。

Zoho Sprints と Jira を連携すると、チームは両方のプラットフォーム間でシームレスにコラボレーションできます。この連携により、ユーザーは Jira の課題と Zoho Sprints のワークアイテムを双方向に同期でき、すべてのプロジェクトデータの一貫性を保てます。コメントやステータスの更新も双方向に同期されるため、チームは慣れたプラットフォーム上で作業しながら、コンテキストの欠落やデータ不整合を防ぐことができます。

この連携により、Jira または Zoho Sprints を利用しているチームは、プラットフォーム間のデータ同期と、プロジェクトライフサイクル全体を通したスムーズな連携を実現できます。

利用シーン

あるプロジェクト管理会社で、複数のチームのうち一部は Zoho Sprints を、その他は Jira をプロジェクト管理業務に使用しているとします。このような場合、データ不整合を避けるために、両方の製品間でデータを同期したくなるでしょう。この連携を利用すると、アプリケーション間でデータを同期し、複数の製品にまたがる作業タスクを効率的に管理できます。
クライアントやベンダーが Jira を使用し、自社は Zoho Sprints でプロジェクト関連業務を管理している場合、この連携を利用して製品間のデータ同期を有効にできます。

メリット

製品間の高速な双方向同期
両方の製品を同時に柔軟に利用可能

利用可能プラン: Premier、Enterprise プラン

アクセス権限: ワークスペースの管理者のみが連携を有効にできます。［アイテムを追加］権限を持つユーザーは、Zoho Sprints から Jira へワークアイテムを同期できます。

メモ: この連携はワークアイテムに対してのみサポートされています。

Jira 拡張機能をインストールする

右上の歯車アイコンをクリックします。［設定］ウィンドウが表示されます。
［マーケットプレイス］セクションで［すべて］をクリックします。拡張機能の一覧ページが表示されます。
［Jira for Zoho Sprints］を選択します。
次のページで［Install］をクリックします。
プロジェクトを選択し、ユーザーのアクセス権限を設定します。
［Install Now］をクリックします。インストール完了後、［Configuration］タブに移動します。
有効な形式で Jira ドメインを入力します。例: https://abc.atlassian.net.
［保存 & 次］をクリックします。完了すると、［Authorization］タブに移動します。
［認証］ボタンをクリックして外部連携を認証し、Zoho Sprints と Jira アカウントへのアクセスを許可します。
［認証］をクリックすると、ユーザー名とパスワードの入力を求められます。パスワード欄には、Personal Access Token（PAT）を入力してください。
PAT を作成するには、このリンクにアクセスしてください。

チーム管理者: チーム管理者は、プラットフォーム間の双方向同期を有効にするために、スコープなしで PAT を作成する必要があります。スコープなしで PAT を作成すると、Jira に Webhook を登録できるようになり、タスクや課題の同期に役立ちます。
チームユーザー: チームユーザーは、以下のスコープを付与した PAT を作成する必要があります。

read:jira-work

read:jira-user

write:jira-work

メモ: PAT を作成する際、有効期限の入力を求められます。有効期限は最長 1 年まで設定できます。有効期限が切れると、製品間の同期は失敗します。既存の接続を取り消し、新しい PAT で再認証することができます。

PAT を入力すると、認証が完了し、連携が有効になります。これで製品間でワークアイテムを同期できるようになります。

ワークアイテムを同期する

Zoho Sprints のワークアイテムは、新規アイテムの作成時、またはアイテム詳細ビューから Jira と同期できます。同期はまず Zoho Sprints から Jira へ行われます。その後、Jira 側の課題で行われた以降の操作は、Zoho Sprints に反映されます。

アイテム作成ページから

Zoho Sprints で任意のプロジェクトに移動します。
右上の［作成］ボタン横のドロップダウンをクリックし、［アイテムを作成］を選択します。
必須フィールドにアイテムの詳細を入力します。
［他のアプリに追加］ボタンをクリックし、［Sync to Jira］を選択します。
Jira セクションが開きます。ドロップダウンから Jira プロジェクトを選択します。
必須フィールドおよびその他の必要なフィールドに値を入力します。
［Sync］をクリックします。

アイテム詳細ページから

Zoho Sprints で任意のプロジェクトに移動します。
既存のワークアイテムを選択します。
アイテム詳細ページが表示されます。
アイテムの右側ナビゲーションバーにある Jira ウィジェットをクリックします。
［Sync to Jira］ボタンをクリックします。
同期先の Jira プロジェクトを選択します。
設定が完了すると、フィールドは 2 つのセクションに分かれます。

同期済みフィールド: 必須の Jira フィールドがこのセクションに表示され、Zoho Sprints から取得した値が自動入力されます。事前入力された値は編集できません。Zoho Sprints 側で値が未入力の場合は、このセクションで入力を求められます。
未同期フィールド: その他の Jira フィールドがこのセクションに表示されます。必須フィールドの値と、必要に応じてその他の値を入力します。

［Sync］をクリックします。

Zoho Sprints のワークアイテムは、これで Jira と同期されます。［Jira で表示］ボタンをクリックすると、対応するワークアイテムを Jira 上で表示できます。

同期が完了すると、Zoho Sprints のワークアイテムのリンクが Jira の課題説明に追加されます。ユーザーが説明を編集してハイパーリンクを削除した場合、そのユーザーは Zoho Sprints のワークアイテムに遷移できなくなります。ただし、Sprints 側で課題説明を編集するたびに、ワークアイテムのリンクは再度 Jira に追加されます。

機能の動作

同期のシナリオ

担当者

ワークアイテムを Zoho Sprints から Jira に同期する際、アイテムに複数の担当者がいる場合は、Jira 上で該当する担当者を検索します。Jira では 1 課題につき 1 担当者のみサポートされるため、最初に見つかった担当者が割り当てられます。該当する担当者が Jira に存在しない場合、その Jira 課題は未割り当てのままになります。
同期済みアイテムで、Zoho Sprints 側の担当者を更新した場合、システムは Jira 上で新しい担当者を検索し、最初に見つかった担当者を Jira に反映します。
同期済みアイテムで、Jira 側の担当者を更新した場合、システムは新しい担当者が Zoho Sprints の担当者として追加済みかを確認します。追加されていない場合は、既存の担当者に加えて新しい担当者が Zoho Sprints に追加されます。
チーム管理者がワークスペースユーザーのメールアドレスをマスクしている場合、Zoho Sprints から Jira への担当者の同期は行われません。
担当者が Jira 側でメールの表示設定を「なし」にしている場合、Jira から Zoho Sprints への担当者の同期は行われません。詳細はこちら

ステータス

アイテムを Zoho Sprints から Jira に同期する際、システムは大文字・小文字を区別せずに Jira 上で一致する値を検索します。一致するステータスが存在する場合、その値が自動入力されます。Jira に存在しない場合は、課題は Jira の初期設定ステータスで作成されます。
同期済みアイテムで、Jira または Zoho Sprints 側のステータスを更新した場合、システムはもう一方のアプリケーションで一致する値を検索します。該当する値が見つかればステータスが更新されますが、見つからない場合は、ワークアイテムの既存ステータスが維持されます。

優先度

アイテムを Zoho Sprints から Jira に同期する際、システムは大文字・小文字を区別せずに Jira 上で一致する値を検索します。一致する優先度が存在する場合、その値が自動入力されます。Jira に存在しない場合、優先度が必須フィールドに設定されているときは、同期前に同等の優先度を選択するようユーザーに求められます。必須でない場合は、優先度の入力をスキップできます。
同期済みアイテムで、Jira または Zoho Sprints 側の優先度を更新した場合、システムはもう一方のアプリケーションで一致する値を検索します。該当する値が見つかれば優先度が更新・同期されますが、見つからない場合は、ワークアイテムの既存の優先度が維持されます。

タグ

同期済みアイテムで、Jira または Zoho Sprints 側のタグを更新した場合、システムはもう一方のアプリケーションで一致する値を検索します。該当する値が見つかれば、そのタグが更新・同期されます。
一致するタグが存在せず、更新が Jira 側で行われた場合、Zoho Sprints では既存のタグが維持されます。
一致するタグが存在せず、更新が Zoho Sprints 側で行われた場合、Jira に新しいタグが作成され、課題に追加されます。
Zoho Sprints で作成されたタグが Jira に同期される際、タグ名に含まれるスペース（' '）はアンダースコア（'_'）に置き換えられます。
Jira で作成されたタグが Zoho Sprints に同期される際、タグ名に含まれるアンダースコア（'_'）はスペース（' '）に置き換えられます。

添付ファイル

アイテムを Zoho Sprints から Jira に同期する際、既存の添付ファイルは Jira に同期されません。同期後に追加された新しい添付ファイルのみが Jira に同期されます。
Zoho Sprints に追加された添付ファイルは Jira と同期されますが、Jira に追加された添付ファイルは Zoho Sprints には同期されません。

各添付ファイルのファイルサイズは 15MB を超えない必要があります。

コメント

アイテムを Zoho Sprints から Jira に同期する際、既存のコメントは Jira に同期されません。同期後に追加された新しいコメントのみが Jira に同期されます。
各コメントには、投稿したユーザーの詳細と、関連付けられているアイテムを表示するカスタムヘッダーが含まれます。

双方向同期

Zoho Sprints と Jira 間の双方向同期は、次のフィールドで行われます。

Sprints	Jira
ステータス	ステータス
優先度	優先度
商品名前	概要
コメント	コメント
説明	説明
タグ	ラベル
担当者	担当者

同期時にサポートされる項目タイプ

以下の項目タイプに属する値は、Jira から Zoho Sprints へ同期されません。ユーザーは値を手動で入力する必要があります。対象の項目タイプは次のとおりです。

カスケード選択
日付ピッカー
日付/時間
浮動小数点数
グループピッカー
マルチグループピッカー
複数選択チェックボックス
マルチバージョン
ラジオボタン
テキストエリア
テキスト項目
URL
ユーザーピッカー
マルチユーザーピッカー
バージョン
ストーリーポイント
レポーター
期限日
プロジェクト

上記以外で、Jira が標準でサポートしている、またはサードパーティアプリで作成された項目タイプのうち、Zoho Sprints でサポートされていないものは、Zoho Sprints のレイアウトには表示されず、同期も行われません。これらの項目が必須に設定されている場合は、問題なく作業項目を同期できるよう、この項目を任意項目に変更する必要があります。

文字数の制限

Jira では、コメントと説明は 32,000 文字までサポートされています。Zoho Sprints から Jira に作業項目を同期する際に、コメントまたは説明が 32,000 文字を超えている場合は、先頭の 32,000 文字のみが Jira に同期されます。

同期の削除

Zoho Sprints から Jira への作業項目の同期を停止したい場合は、このオプションを使用して同期を削除できます。

対象のプロジェクト内で、該当する作業項目に移動します。
作業項目の右側ナビゲーションバーで Jira ウィジェットをクリックします。
[同期を削除] をクリックします。
操作を確認し、[削除] をクリックします。

Jira 拡張機能を無効にする

拡張機能を無効にするには、次の操作を行います。

右上の歯車アイコンをクリックします。［設定］ウィンドウが表示されます。
マーケットプレイス セクションで [すべて] をクリックします。インストール済み拡張機能タブに移動し、インストール済み拡張機能の一覧が表示されます。
Jira for Zoho Sprints をクリックします。
[無効にする] をクリックします。