Azure DevOps拡張機能

Azure DevOps拡張機能

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

Azure DevOpsは、ソフトウェアの開発とデプロイに使用するDevOpsツールを提供するMicrosoftのプラットフォームです。Zoho SprintsにAzure DevOpsをインストールすると、ソフトウェア開発を効率化できます。

この連携は、クラウドアカウントと自己管理アカウントの両方に対応しています。必要なセキュリティを確保しながら、クラウドサーバーとオンプレミスサーバーの利便性を活用できます。

クラウドアカウント向けのAzure DevOpsの設定

Azure DevOpsアカウントをZoho Sprintsと連携するには:
  1. 右上の歯車アイコンをクリックします。設定画面が表示されます。
  2. [マーケットプレイス]セクションの[その他]をクリックします。一覧ページが表示されます。
  3. Azure DevOpsの下にある[設定]をクリックします。
  4. [利用規約]のチェックボックスにチェックを入れます。

  5. [認証]ボタンをクリックします。Azure DevOpsアカウントに移動します。
  6. 認証情報を入力し、アプリケーションに許可されるアクセス範囲を確認します。
  7. Azure DevOpsのプロジェクトが[自分のAzure DevOpsプロジェクト]に表示されます。Zoho Sprintsのプロジェクトに関連付けられているプロジェクトは、[チームのAzure DevOpsプロジェクト]に表示されます。
  8. 関連付けるプロジェクトが属する組織を選択します。
  9. カーソルを合わせて矢印をクリックし、リポジトリをワークスペースに関連付けます。
  10. [プロジェクトの関連付け]をクリックし、関連付けるプロジェクトを選択します。作業項目を同期する場合は、[課題のみを同期]をクリックします。
  11. [関連付け]をクリックします。

自己管理アカウント向けのAzure DevOpsの設定

Azure DevOpsアカウントをZoho Sprintsと連携するには:
  1. 右上の歯車アイコンをクリックします。設定画面が表示されます。
  2. [マーケットプレイス]セクションの[その他]をクリックします。一覧ページが表示されます。
  3. Azure DevOpsの下にある[設定]をクリックします。
  4. [利用規約]のチェックボックスにチェックを入れます。

  5. [自己管理]を選択します。連携を認証するには、Azure DevOpsのユーザー名とアクセストークンの入力が必要です。

    アクセストークンを生成するには:
  6. 認証情報を入力してAzure DevOpsアカウントにログインします。

  7. 右上の[セキュリティ]に移動します。
  8. [個人用アクセストークン]を選択します。
  9. [新しいトークン]をクリックして、Zoho Sprints用の個人用アクセストークンを作成します。
  10. [名前]を入力します。
  11. [組織]で[アクセス可能なすべての組織]を選択します。
    メモ:[組織]でこのオプションを選択しないと、認証に失敗します。
  12. アクセス範囲として、すべてのユーザーと所有者に[コード(読み取り)]、[プロジェクトとチーム(読み取り)]、[作業項目(読み取り)]を選択し、所有者にのみ[ビルド(読み取り)]も選択します。
  13. Azure DevOpsからアクセストークンをコピーし、Zoho Sprintsに貼り付けます。
  14. [認証]ボタンをクリックします。

メモ
メモ:Azure DevOpsの2019年版では、APIが利用できないため、コメントの更新は同期されません。

コミットの添付

項目にコミットを添付するには:
  1. Zoho Sprintsで作業項目の詳細ページに移動します。
  2. [Azure DevOps]タブを選択します。
  3. [+ コミット]ボタンをクリックします。
  4. 関連付けられているプロジェクトを選択します。
  5. リポジトリを選択します。
  6. 開始日と終了日でコミットを絞り込みます。
  7. コミットを選択します。
  8. [添付]ボタンをクリックします。コミットが項目に添付されます。

 

プルリクエストの添付

項目にプルリクエストを添付するには:
  1. Zoho Sprintsで作業項目の詳細ページに移動します。
  2. [Azure DevOps]タブを選択します。
  3. [プルリクエスト]タブを選択します。
  4. [+ プルリクエスト]ボタンをクリックします。
  5. 関連付けられているプロジェクトを選択します。
  6. リポジトリを選択します。
  7. ステータスで絞り込みます。
  8. プルリクエストを選択します。
  9. [添付]ボタンをクリックします。プルリクエストが項目に添付されます。


メモ
メモ:
  1. これらのクイックコマンドを使用して、Azure DevOpsからコミットやプルリクエストを添付することもできます。
  2. 作業項目へのタグ付けは、プルリクエストの[説明]項目からのみ行えます。

 

 

形式

構文

用途

#workitem

#<Project Prefix>- <i/I><Item number>

例:#SP-i30

作業項目のIDを表します。

#comment

#workitemid #comment <message1> #comment <message2>

例:#SP-I15 #comment 本日中に最終ビルドを共有してください。 #comment 既存の課題を修正し、ローカルビルドを更新してください。

メモ:

1つの作業項目に複数のコメントを追加できます。

作業項目にコメントを追加します。

#status

#workitemid #status <status_name>

例1:#SP-i20 #status Done

例2:#SP-i20 #status To_be_Tested

メモ:

1. ステータス名が複数の単語で構成されている場合は、単語をアンダースコアで区切ります。

2. ステータス名では、大文字と小文字は区別されません。

作業項目のステータスを更新します。

#priority

#workitemid #priority <priority_name>

例1:#SP-i40 #priority Critical

例2:#SP-i42 #priority Should_be

メモ:

1. 優先度名が複数の単語で構成されている場合は、単語をアンダースコアで区切ります。

2. 優先度名では、大文字と小文字は区別されません。

作業項目の優先度を更新します。

#time

#workitemid #time <hours>h <minutes>m

例:#SP-I52 #time 5h 30m

作業項目に工数を追加します。

    

メモ:Azure DevOpsアカウントのメールアドレスがZoho Sprintsのチームに登録されている必要があります。登録されている場合にのみ、コミット内の#comment、#time、#status、#priorityを処理できます。

 

高度なコマンド

複数の作業項目に対する単一のコマンド

 

構文

#workitemid,#workitemid,#workitemid #comment <message>

例

#SM-I25,#SM-I42,#SM-I98 #comment 課題を解決し、ローカルビルドに反映しました。

実行結果

3件すべての作業項目にコメントが追加されます。

 

単一の作業項目に対する複数のコマンド

 

構文

#workitemid #comment <message> #priority <priority_name> #time < > h < > m #status <status_name>

例

#SM-I34 #comment 要件を洗い出す #priority High #time 5h 3m #status In_progress

実行結果

作業項目にコメントと工数が追加されます。また、ステータスと優先度が更新されます。

 

複数の作業項目に対する複数のコマンド

 

構文

#workitemid,#workitemid,#workitemid #comment <message> #priority <priority_name> #time <>h <>m #status <status_name>

例

#SM-I34, #SM-I45, #SM-I54 #comment 要件を洗い出す #priority High #time 5h 3m #status In_progress

実行結果

3件すべての作業項目にコメントと工数が追加され、ステータスと優先度が更新されます。

 


メモ
メモ:
  1. 作業項目にコミットやプルリクエストを関連付けるには、Azure DevOpsのプロジェクトが、その作業項目の属するZoho Sprintsのプロジェクトに関連付けられている必要があります。
  2. Zoho Sprintsで作業項目の詳細ページを表示するには、ユーザーのAzure DevOpsのプロフィールで必要な権限が付与されている必要があります。

プルリクエスト:クイックコマンドによる項目の自動完了

クイックコマンドを使用すると、プルリクエストから作業項目を直接更新できます。プルリクエストの説明に、「#接頭語付きエンティティID #status <実際のステータス>」の形式でクイックコマンドを入力します(例:'#SP-I1 #status done')。(接頭語付きエンティティIDの取得方法をご確認ください)。これにより、作業項目がプルリクエストに関連付けられ、プルリクエストのマージ時に項目のステータスが自動的に完了に更新されるため、開発状況と作業状況の同期を保ちながら時間を節約できます。作業項目は、プルリクエストの処理の一環として一貫して更新されます。
 
プルリクエストが実行されると、作業項目に対してステータスコマンドが処理され、項目のステータスが指定した値に更新されます。マージ要求を開始したユーザーが、ステータスを更新したユーザーとして扱われます。この情報は監査ログに記録されます。

メモ
メモ:
  1. プルリクエストを通じてステータスが更新されると、ユーザーにフィード通知が届きます。
  2. プルリクエストの説明を編集することで、新しい作業項目を関連付けることができます。
  3. プルリクエストの説明に入力したクイックコマンドでは、項目の関連付けを解除できません。項目の詳細ページにある[プルリクエスト]タブから解除できます。
  4. ステータスにスペースが含まれる場合は、クイックコマンド内の単語を「_」で区切ります。例:#SP-L1 #status to_do。ステータスの大文字と小文字は区別されません。

作業項目の同期

Azure DevOpsアカウントで追加されたすべての作業項目は、Zoho Sprintsのバックログに自動的に追加されます。項目の種類、ステータス、優先度、タイトル、タグ、説明などの項目は、Zoho Sprintsのデータと一致する場合、同じ値が保持されます。

Azure DevOpsから同期される項目


情報
項目:タイトル、説明、項目の種類、ステータス、担当者、タグ、優先度
  1. Azure DevOpsで作業項目をごみ箱に移動すると、Zoho Sprintsの項目との同期が停止します。
  2. 作業項目のステータスは、その項目が属するスプリントによって異なります。
  3. Azure DevOpsの作業項目で追加、編集、削除されたすべてのコメントは、Zoho Sprintsに反映されます。
  4. 作業項目の担当者をAzure DevOpsからZoho Sprintsに同期する際、システムはメールアドレスを基に、Zoho Sprintsに同じユーザーが存在するかを確認します。同じユーザーが存在する場合のみ、担当者の項目が更新されます。
  5. 作業項目の優先度をAzure DevOpsからZoho Sprintsに同期する際、システムは並び順の番号が一致する優先度を確認し、Zoho Sprintsの作業項目に設定します。たとえば、Azure DevOpsで「高」が選択リストの3番目の値として追加されている場合、Zoho Sprintsの3番目の優先度の値に対応付けられます。
  6. 作業項目のタグをAzure DevOpsからZoho Sprintsに同期する際、システムはZoho Sprintsに同じタグが存在するかを確認します。存在しない場合は、Zoho Sprintsに新しいタグを作成します。
  7. 作業項目のステータスをAzure DevOpsからZoho Sprintsに同期する際、システムはZoho Sprintsに同じ値が存在するかを確認し、存在する場合のみ値を更新します。
  8. Azure DevOpsで新しい作業項目を作成してZoho Sprintsと同期すると、システムは同じ作業項目の種類が存在するかを確認し、選択された種類で項目を作成します。選択された種類が存在しない場合は、既定で項目の種類が「バグ」に設定されます。
  9. Azure DevOpsで既存の作業項目の種類を更新すると、システムはZoho Sprintsに同じ項目の種類が存在するかを確認し、存在する場合のみ項目の種類を更新します。

 

同様に、Sprintsで作業項目を作成する際、作成画面にはAzure DevOpsにも追加するオプションが表示されます。これにより、SprintsアカウントからAzure DevOpsに項目を追加できます。

Sprintsから同期される項目

情報
項目:タイトル、説明、担当者、優先度、ステータス、タグ、アイテムの種類
  1. [課題のみ同期]が有効なリポジトリのみが、アイテムの作成画面に表示されます。
  2. Zoho SprintsからAzure DevOpsに作業項目の種類を同期する際は、Azure DevOpsで利用可能なアイテムの種類がすべて表示されます。必要な種類を選択して、作業項目をAzure DevOpsに同期できます。
  3. Zoho SprintsからAzure DevOpsに作業項目の担当者を同期する際は、メールアドレスをもとに、Azure DevOpsに同じユーザーが存在するかどうかが確認されます。同じユーザーが存在する場合にのみ、担当者の項目が更新されます。
  4. Zoho SprintsからAzure DevOpsに作業項目の優先度を同期する際は、数値順で対応する優先度が確認され、Azure DevOpsの作業項目に反映されます。たとえば、Zoho Sprintsの選択リストで[高]が3番目の値として追加されている場合、Azure DevOpsの3番目の優先度の値に関連付けられます。
  5. Zoho SprintsからAzure DevOpsに作業項目のタグを同期する際は、Azure DevOpsに同じタグが存在するかどうかが確認されます。存在しない場合は、Azure DevOpsに新しいタグが作成されます。
  6. Zoho SprintsからAzure DevOpsに作業項目のステータスを同期する際は、Azure DevOpsに同じ値が存在するかどうかが確認され、存在する場合にのみ値が更新されます。

プロジェクトの関連付けの解除

  1. 右上の歯車アイコンをクリックします。設定画面が表示されます。
  2. [マーケットプレイス]セクションの[その他]をクリックします。一覧ページが表示されます。
  3. [Azure DevOps]を選択します。
  4. 関連付けられているプロジェクトを確認します。
  5. [プロジェクトを削除]をクリックします。

リポジトリの関連付けの解除

  1. 右上の歯車アイコンをクリックします。設定画面が表示されます。
  2. [マーケットプレイス]セクションの[その他]をクリックします。一覧ページが表示されます。
  3. [Azure DevOps]を選択します。
  4. 矢印アイコンをクリックして、リポジトリをワークスペースの外に移動します。

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

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