Azure DevOps拡張機能

Azure DevOps拡張機能

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

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

この連携は、クラウドアカウントとセルフマネージドアカウントの両方に対応しており、必要なセキュリティを確保しながら、クラウドサーバーとオンプレミスサーバーを便利に利用できます。

クラウドアカウント向け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. ［利用規約］のチェックボックスを選択します。

  6. ［セルフマネージド］オプションを選択します。連携を認証するには、Azure DevOpsのユーザー名とアクセストークンを入力する必要があります。

    アクセストークンを生成するには、次の手順を実行します。
  7. 認証情報を入力し、Azure DevOpsアカウントにログインします。

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

Notes
メモ：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. ［添付］ボタンをクリックします。プル要求が項目に添付されます。


Notes
メモ：
  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件すべての作業項目にコメントと作業時間が追加され、ステータスと優先度も更新されます。

 


Notes
メモ：
  1. Azure DevOpsプロジェクトが、その作業項目を含むZoho Sprintsプロジェクトに関連付けられている場合にのみ、コミットとプルリクエストを作業項目に添付できます。
  2. Zoho Sprintsで作業項目の詳細ページを表示するには、ユーザーのAzure DevOpsプロフィールに権限が必要です。

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

クイックコマンドを使用すると、プルリクエストから作業項目を直接更新できます。プルリクエストの説明に、#entity ID with prefix #status <actual status>の形式でクイックコマンドを入力します（例：'#SP-I1 #status done'）。（接頭辞付きエンティティーIDの取得方法）。これにより、作業項目がプルリクエストに関連付けられ、プルリクエストがマージされると項目のステータスが自動的に完了に更新されます。開発状況と作業状況を同期したまま、時間を節約できます。作業項目は、プルリクエストの処理の一環として一貫して更新されます。
 
プルリクエストが実行されると、作業項目に対してステータスコマンドが処理され、該当する項目のステータスが更新されます。ステータスを更新したユーザーとして、マージリクエストを開始したユーザーが記録されます。この情報は監査ログに記録されます。

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

作業項目の同期

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

Azure DevOpsから同期される項目


Info
項目：件名、説明、項目の種類、ステータス、担当者、タグ、優先度
  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で［High］が選択リストの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と同期すると、システムは同じ作業項目の種類があるか確認し、選択した種類で項目を作成します。選択した種類がない場合、項目の種類として初期設定で［Bug］が選択されます。
  9. Azure DevOpsで既存の作業項目の種類を更新すると、システムは同じ項目の種類がZoho Sprintsに存在するか確認し、存在する場合にのみ項目の種類を更新します。

 

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

Zoho Sprintsから同期される項目

Info
項目：件名、説明、担当者、優先度、ステータス、タグ、作業項目の種類
  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. ［アンインストール］をクリックします。拡張機能がアンインストールされ、設定が削除されます。