Azure DevOps拡張機能

Azure DevOps拡張機能

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

Azure DevOps は、Microsoft が提供する、ソフトウェアの開発とデプロイのための DevOps ツールを備えたプラットフォームです。Zoho Sprints に Azure DevOps を連携して、ソフトウェア開発プロセスを加速させましょう。

この連携は、クラウド版とセルフマネージド版の両方のアカウントでサポートされており、必要なセキュリティを確保しつつ、クラウドおよびオンプレミスサーバーの利便性を提供します。

クラウドアカウントで Azure DevOps を設定する

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

  5. [認証] ボタンをクリックします。Azure DevOps アカウントにリダイレクトされます。
  6. 認証情報を入力し、このアプリケーションがアクセスできるスコープを確認します。
  7. Azure DevOps のプロジェクトは [My Azure DevOps プロジェクト] に一覧表示されます。Zoho Sprints のプロジェクトにマッピングされたプロジェクトは [Team Azure DevOps プロジェクト] に表示されます。
  8. 連携したいプロジェクトの組織を選択します。
  9. ワークスペースにリポジトリをマッピングするには、矢印にカーソルを合わせてクリックします。
  10. [プロジェクトを関連付ける] をクリックし、マッピングするプロジェクトを選択します。作業項目のみを同期したい場合は、[課題のみ同期] をクリックします。
  11. [関連付ける] をクリックします。

セルフマネージドアカウントで Azure DevOps を設定する

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

  6. [Self-managed] オプションを選択します。連携を認証するために、Azure DevOps のユーザー名とアクセス トークンの入力が必須になります。

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

  8. 右上の [Security] に移動します。
  9. [Personal Access Tokens] を選択します。
  10. Zoho Sprints 用の新しいパーソナルアクセストークンを作成するには、[New Token] をクリックします。
  11. [名前] を入力します。
  12. [組織] として [すべてのアクセス可能な組織] を選択します。
    メモ: 組織でこのオプションを選択しない場合、認証は失敗します。
  13. スコープとして、すべてのユーザーおよびオーナーに対して [Code (Read)]、[Project and Team (Read)]、[Work Items (Read)] を、オーナーに対してのみ [Build (Read)] を選択します。
  14. Azure DevOps から アクセス トークン をコピーし、Zoho Sprints に貼り付けます。
  15. [認証] ボタンをクリックします。

Notes
メモ: Azure DevOps 2019 バージョンでは、API が提供されていないため、コメントの更新同期はサポートされません。

コミットを添付する

作業項目にコミットを添付するには:
  1. Zoho Sprints で作業項目の詳細ページに移動します。
  2. [Azure DevOps] タブを選択します。
  3. [+ Commit] ボタンをクリックします。
  4. マッピング済みのプロジェクトを選択します。
  5. リポジトリを選択します。
  6. 開始日と終了日でコミットをフィルターします。
  7. コミットを選択します。
  8. [添付する] ボタンをクリックします。コミットが作業項目に添付されます。

 

プルリクエストを添付する

作業項目にプルリクエストを添付するには:
  1. Zoho Sprints で作業項目の詳細ページに移動します。
  2. [Azure DevOps] タブを選択します。
  3. [Pull Request] タブを選択します。
  4. [+ Pull Request] ボタンをクリックします。
  5. マッピング済みのプロジェクトを選択します。
  6. リポジトリを選択します。
  7. ステータスでフィルターします。
  8. プルリクエストを選択します。
  9. [添付する] ボタンをクリックします。プルリクエストが作業項目に添付されます。


Notes
メモ:
  1. Azure DevOps からコミットやプルリクエストを添付する際には、これらのクイックコマンドも使用できます。
  2. 作業項目のタグ付けは、プルリクエストの「説明」フィールドからのみサポートされます。

 

 

形式

構文

目的

#workitem

#<プロジェクト 接頭語>- <i/I><Item 番号>

例: #SP-i30

作業項目 ID を表します。

#コメント

#workitemid #コメント <メッセージ1> #コメント <メッセージ2>

例: #SP-I15 #コメント 最終版を EOD までに共有してください。 #コメント 既存の不具合を修正し、ローカル版を更新してください。

メモ:

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

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

#ステータス

#workitemid #ステータス <ステータス名>

例 1: #SP-i20 #ステータス 完了

例 2: #SP-i20 #ステータス To_be_Tested

メモ:

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

2. ステータス名は大文字と小文字を区別しません。

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

#優先度

#workitemid #優先度 <優先度名>

例 1: #SP-i40 #優先度 Critical

例 2: #SP-i42 #優先度 Should_be

メモ:

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

2. 優先度名は大文字と小文字を区別しません。

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

#時間

#workitemid #時間 <時間>h <分>m

例: #SP-I52 #時間 5h 30m

作業項目に作業時間を記録します。

    

メモ: Azure DevOps アカウントのメールアドレスは Zoho Sprints チームに登録されている必要があります。登録されている場合のみ、#コメント、#時間、#ステータス、#優先度 のコミットを処理できます。

 

詳細コマンド

 

複数のワークアイテムに対する単一コマンド

 

構文

#workitemid,#workitemid,#workitemid #コメント <メッセージ>

例

#SM-I25,#SM-I42,#SM-I98 #コメント Issues are resolved and updated in the local build.

What happens?

3 つすべてのワークアイテムにコメントが追加されます。

 

単一のワークアイテムに対する複数コマンド

 

構文

#workitemid #コメント <メッセージ> #優先度 <priority_name> #時間 < > h < > m #ステータス <status_name>

例

#SM-I34 #コメント List out the requirements #優先度 高い #時間 5h 3m #ステータス In_progress

What happens?

ワークアイテムにコメントと作業時間が追加されます。また、ステータスと優先度も更新されます。

 

複数のワークアイテムに対する複数コマンド

 

構文

#workitemid,#workitemid,#workitemid #コメント <メッセージ> #優先度 <priority_name> #時間 <>h <>m #ステータス <status_name>

例

#SM-I34, #SM-I45, #SM-I54 #コメント List out the requirements #優先度 高い #時間 5h 3m #ステータス In_progress

What happens?

3 つすべてのワークアイテムにコメントと作業時間が追加され、ステータスと優先度も更新されます。

 


Notes
メモ:
  1. Azure DevOps プロジェクトが、そのワークアイテムの Zoho Sprints プロジェクトに関連付けられている場合にのみ、コミットとプルリクエストをワークアイテムに添付できます。
  2. ユーザーは、Zoho Sprints でワークアイテムの詳細ページを表示できる Azure DevOps 権限を持っている必要があります。

 

ワークアイテムの同期

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

Azure DevOps から同期される項目


Info
項目: 件名, 説明, アイテム種類, ステータス, 担当者, Tags, 優先度
  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 と同期する際、システムは同じワークアイテム種類が存在するかを確認し、選択された種類でアイテムを作成します。選択された種類が存在しない場合、システムは既定でアイテム種類を「Bug」に設定します。
  9. 既存のワークアイテム種類が Azure DevOps で更新された場合、システムは Zoho Sprints 内で同じアイテム種類を確認し、同じアイテム種類が存在する場合にのみアイテム種類を更新します。

 

同様に、Sprints でワークアイテムを作成する際、作成画面には Azure DevOps に追加するオプションが含まれます。これにより、Sprints アカウントから Azure DevOps にアイテムを追加できます。

Sprints から同期される項目

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