Jira連携

Jira連携

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

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

Zoho SprintsとJiraを連携すると、チームは両方のプラットフォーム間でシームレスに共同作業を進められます。この連携により、Jiraの課題とZoho Sprintsの作業項目を双方向に同期し、すべてのプロジェクトデータの整合性を維持できます。コメントやステータスの更新も双方向に同期されるため、チームは必要な情報を失ったり、データの不整合を生じさせたりすることなく、使い慣れたプラットフォームで作業できます。

この連携により、JiraまたはZoho Sprintsを使用するチームは、プラットフォーム間でデータを同期し、プロジェクトのライフサイクル全体を通じて円滑に連携できます。

活用例

  1. あるプロジェクト管理会社には複数のチームがあり、一部のチームはZoho Sprintsを、他のチームはJiraを使用してプロジェクト管理活動を行っています。このような場合、データの不整合を防ぐには、製品間でデータを同期する必要があります。この連携により、アプリケーション間でデータを同期し、製品をまたいで業務のタスクを効率的に管理できます。

  2. 顧客や協力会社がJiraを使用し、自社ではZoho Sprintsでプロジェクト関連の活動を管理している場合、この連携を使用して製品間でデータを同期できます。

メリット

  1. 製品間での迅速な双方向同期
  2. 両方の製品を同時に使用できる柔軟性
情報
利用可能なプラン:プレミア、エンタープライズ
警告
アクセス権限:この連携を有効にできるのは、ワークスペースの所有者のみです。「項目の追加」権限を持つユーザーは、Zoho Sprintsの作業項目をJIRAに同期できます。
メモ
メモ:この連携は作業項目にのみ対応しています。

Jira拡張機能のインストール

  1. 右上の歯車アイコンをクリックします。設定画面が表示されます。
  2. マーケットプレイスセクションの[すべて]をクリックします。一覧ページが表示されます。
  3. Jira for Zoho Sprintsを選択します。
  4. 次のページで[インストール]をクリックします。
  5. プロジェクトを選択し、ユーザーのアクセス権限を設定します。
  6. [今すぐインストール]をクリックします。インストールが完了すると、[設定]タブに移動します。

  7. Jiraのドメインを有効な形式で入力します。例:https://abc.atlassian.net。
  8. [保存して次へ]をクリックします。完了すると、[認証]タブに移動します。
  9. [認証する]ボタンをクリックして外部連携と実行条件を認証し、Zoho SprintsとJiraのアカウントへのアクセスを許可します。
  10. [認証する]をクリックすると、ユーザー名とパスワードの入力を求められます。パスワード項目には、個人用アクセストークン(PAT)を入力してください。
  11. PATを作成するには、こちらのリンクにアクセスしてください。
    1. チームの所有者:プラットフォーム間の双方向同期を有効にするには、チームの所有者がスコープを指定せずにPATを作成する必要があります。スコープを指定せずにPATを作成すると、JiraにWebhookを登録できるようになり、タスクや課題を同期できます。
    2. チームメンバー:チームメンバーは、次のスコープを指定してPATを作成する必要があります:
read:jira-work
read:jira-user
Write:jira-work
メモ
メモ:PATの作成時には、有効期間の入力を求められます。有効期間は最長1年に設定できます。有効期間が過ぎると、製品間の同期に失敗するようになります。既存の外部連携を取り消し、新しいPATで外部連携を再認証できます。

PATを入力すると認証が完了し、連携が有効になります。これで、製品間で作業項目を同期できるようになります。

作業項目の同期

Zoho Sprintsの作業項目は、新しい項目の作成時、または項目の詳細画面からJiraに同期できます。最初にZoho SprintsからJiraへの同期が行われます。その後、Jiraの課題に対して行われた活動がZoho Sprintsに同期されます。

項目の作成ページからの同期

  1. Zoho Sprintsでプロジェクトに移動します。
  2. 右上の[作成]ボタンの横にあるドロップダウンをクリックし、[項目の作成]を選択します。
  3. 必要な項目に詳細情報を入力します。
  4. [他のアプリに追加]ボタンをクリックし、[Jiraに同期]を選択します。

  5. Jiraセクションが開きます。ドロップダウンからJiraのプロジェクトを選択します。
  6. 必須項目やその他の必要な項目に値を入力します。
  7. [同期]をクリックします。

項目の詳細ページからの同期

  1. Zoho Sprintsでプロジェクトに移動します。
  2. 既存の作業項目を選択します。
    項目の詳細ページが表示されます。
  3. 項目の右側のナビゲーションバーでJiraウィジェットをクリックします。

  4. [Jiraに同期]ボタンをクリックします。

  5. 作業項目の同期先となるJiraのプロジェクトを選択します。
  6. 選択すると、項目が2つのセクションに分かれて表示されます。
    1. 同期済みの項目:このセクションには、Jiraの必須項目が、Zoho Sprintsから取得した値とともに表示されます。値が事前入力されている場合、その値は編集できません。Zoho Sprintsに値が追加されていない場合は、このセクションで入力を求められます。
    2. 未同期の項目:このセクションには、その他のJiraの項目が表示されます。必須項目の値と、必要に応じてその他の値を入力します。
  7. [同期]をクリックします。
Zoho Sprintsの作業項目がJiraに同期されます。[Jiraで表示]ボタンをクリックすると、該当する作業項目をJiraで確認できます。

同期が完了すると、Zoho Sprintsの作業項目へのリンクがJiraの課題の説明に追加されます。ユーザーが説明を編集してリンクを削除すると、Zoho Sprintsの作業項目に移動できなくなります。ただし、Sprintsで課題の説明を編集するたびに、Jiraに作業項目へのリンクが再び追加されます。

機能の動作

同期時の動作

担当者
  1. Zoho SprintsからJiraに同期する作業項目に複数の担当者がいる場合、Jiraに該当する担当者が存在するかどうかが確認されます。Jiraでは課題ごとに1人の担当者のみを設定できるため、最初に見つかった担当者に作業項目が割り当てられます。該当する担当者がJiraに存在しない場合、Jiraの課題は担当者未設定のままになります。

  2. 同期済みの項目の担当者がZoho Sprintsで更新されると、Jiraに新しい担当者が存在するかどうかが確認され、最初に見つかった担当者がJiraに設定されます。

  3. 同期済みの項目の担当者がJiraで更新されると、新しい担当者がZoho Sprintsですでに担当者として追加されているかどうかが確認されます。追加されていない場合は、既存の担当者に加えて新しい担当者が追加されます。

  4. チームの所有者がワークスペースのユーザーのメールアドレスをマスクしている場合、担当者はZoho SprintsからJiraに同期されません。

  5. 担当者がメールの表示設定を「なし」に設定している場合、担当者はJiraからZoho Sprintsに同期されません。詳細はこちら
ステータス
  1. Zoho SprintsからJiraに項目を同期すると、大文字と小文字を区別せずに、Jiraに一致する値が存在するかどうかが確認されます。一致するステータスがあれば、その値が事前入力されます。Jiraに存在しない場合、課題は初期設定のステータスで作成されます。

  2. 同期済みの項目のステータスがJiraまたはZoho Sprintsで更新されると、もう一方のアプリケーションに一致する値が存在するかどうかが確認されます。該当する値が見つかった場合はステータスが更新されます。見つからない場合は、作業項目の既存のステータスが維持されます。
優先度
  1. Zoho SprintsからJiraに項目を同期すると、大文字と小文字を区別せずに、Jiraに一致する値が存在するかどうかが確認されます。一致する優先度があれば、その値が事前入力されます。Jiraに存在せず、優先度が必須項目に設定されている場合は、同期前に相当する優先度を選択するよう求められます。必須項目でない場合は、優先度の入力を省略できます。

  2. 同期済みの項目の優先度がJiraまたはZoho Sprintsで更新されると、もう一方のアプリケーションに一致する値が存在するかどうかが確認されます。該当する値が見つかった場合は、優先度が更新され、同期されます。見つからない場合は、作業項目の既存の優先度が維持されます。
タグ
  1. 同期済みの項目のタグがJiraまたはZoho Sprintsで更新されると、もう一方のアプリケーションに一致する値が存在するかどうかが確認されます。該当する値が見つかった場合は、タグが更新され、同期されます。

  2. 一致するタグが存在せず、Jiraで更新が行われた場合は、Zoho Sprintsの既存のタグが維持されます。

  3. 一致するタグが存在せず、Zoho Sprintsで更新が行われた場合は、Jiraで新しいタグが作成され、課題に追加されます。

  4. Zoho Sprintsで作成したタグをJiraに同期すると、タグ名に含まれるスペース(' ')はアンダースコア('_')に置き換えられます。

  5. Jiraで作成したタグをZoho Sprintsに同期すると、タグ名に含まれるアンダースコア('_')はスペース(' ')に置き換えられます。
添付ファイル
  1. Zoho SprintsからJiraに項目を同期する際、既存の添付ファイルはJiraに同期されません。項目の同期後に新しく追加された添付ファイルのみがJiraに同期されます。

  2. Zoho Sprintsで追加された添付ファイルはJiraに同期されます。ただし、Jiraで追加された添付ファイルはZoho Sprintsに同期されません。
  1. 各添付ファイルのサイズは15MB以下にする必要があります。
コメント
  1. Zoho SprintsからJiraに項目を同期する際、既存のコメントはJiraに同期されません。項目の同期後に新しく追加されたコメントのみがJiraに同期されます。

  2. 各コメントには、投稿したユーザーの詳細と投稿元の製品を表示するカスタムヘッダーが含まれます。
双方向同期
Zoho SprintsとJira間の双方向同期は、次の項目間で行われます:

Sprints
Jira
ステータス
ステータス
優先度
優先度
作業項目名
要約
コメント
コメント
説明
説明
タグ
ラベル
担当者
担当者

同期でサポートされる項目の種類

以下の種類の項目の値は、JiraからZoho Sprintsに同期されません。ユーザーが手動で値を入力する必要があります。対象となる項目の種類は次のとおりです:
  1. 階層選択
  2. 日付選択
  3. 日時
  4. 浮動小数点数
  5. グループ選択
  6. 複数グループ選択
  7. 複数チェックボックス
  8. 複数バージョン
  9. ラジオボタン
  10. テキストエリア
  11. テキスト項目
  12. URL
  13. ユーザー選択
  14. 複数ユーザー選択
  15. バージョン
  16. ストーリーポイント
  17. 報告者
  18. 期限
  19. プロジェクト
上記以外の、Jiraでサポートされている項目の種類や外部アプリで作成された項目の種類は、Zoho Sprintsではサポートされていないため、Zoho Sprintsのレイアウトに表示されません。これらの項目が必須に設定されている場合、同期時の問題を回避するには、任意の項目に変更してから作業項目を同期する必要があります。

文字数の制限

Jiraでは、コメントと説明に入力できる文字数はそれぞれ32,000文字までです。コメントや説明が32,000文字を超える作業項目をZoho SprintsからJiraに同期する場合、最初の32,000文字のみがJiraに同期されます。

同期の解除

Zoho SprintsからJiraへの作業項目の同期を停止するには、このオプションで同期を解除できます。
  1. プロジェクト内の該当する作業項目に移動します。
  2. 作業項目の右側のナビゲーションバーで、Jiraウィジェットをクリックします。
  3. [同期を解除]をクリックします。
  4. 操作を確認し、[解除]をクリックします。

Jira拡張機能の無効化

拡張機能を無効にするには:
  1. 右上の歯車アイコンをクリックします。設定画面が表示されます。
  2. マーケットプレイスセクションの[すべて]をクリックします。インストール済みの拡張機能のタブに移動すると、インストール済みのすべての拡張機能の一覧が表示されます。
  3. [Jira for Zoho Sprints]をクリックします。
  4. [無効にする]をクリックします。

拡張機能を無効にすると、拡張機能の動作が一時的に停止します。必要に応じて、いつでも再度有効にできます。

Jira拡張機能のアンインストール

この拡張機能をワークスペースから完全に削除するには、拡張機能をアンインストールします。

拡張機能をアンインストールするには:
  1. 右上の歯車アイコンをクリックします。設定画面が表示されます。
  2. マーケットプレイスセクションの[すべて]をクリックします。一覧ページが表示されます。
  3. [Jira for Zoho Sprints]をクリックします。
  4. [アンインストール]をクリックします。