Azure DevOps パイプライン拡張機能

Azure DevOps パイプライン拡張機能

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

Azure DevOps Pipelineは、ウェブサービスを利用してコードプロジェクトの作成、テスト、実行を自動化するツールです。Azure DevOps Pipeline拡張機能は、Zoho Sprintsにインストールできるようになりました。この拡張機能をインストールすると、Azure DevOps Pipelineから商品、スプリント、リリースの操作が可能になります。また、Zoho Sprints内の作業商品にビルドをマッピングしたり、パイプライン作成の詳細を表示したりできます。

Notes
メモ: Azure DevOpsパイプラインの実行時に詳細ログやHTTPトレースログを設定すると、ログファイルに機密情報が記録されます。これらのログは他者と共有しないでください。

Azure DevOps Pipeline拡張機能をクラウドとサーバーで設定する

拡張機能を設定するには、次の手順に従います:
  1. 右上の歯車アイコンをクリックします。設定ウィンドウが表示されます。
  2. マーケットプレイスセクションのその他をクリックします。リストページが表示されます。
  3. Azure DevOps Pipeline拡張機能の下にある設定するをクリックします。
  4. プロジェクトとアクセシビリティコントロールを選択し、今すぐインストールをクリックします。
  5. ドメイン／ホストURLを入力します。

  6. Azure DevOps 組織名（Azure DevOpsサーバーの場合はコレクション名）を入力します。
  7. 保存 & 次をクリックします。
  8. 外部連携およびトリガーの認証を行います。Azure DevOps接続の認証時には、以下のスコープを使用してPersonal Access TokenをAzure DevOpsで生成してください。
    1. 作成.Read
    2. コード.Read
    3. プロジェクトおよびTeam.Read
    4. 拡張機能.Read＆管理（ポータル担当者のみ）
    5. サービス外部連携.Read、query & manage（ポータル担当者のみ）
  9. Azure DevOpsから関連付けたいプロジェクトを選択します。サーバーの場合は、AzureのAPI制限により1つのプロジェクトのみ選択してください。

  10. 関連付けるをクリックします。選択されたプロジェクトがマッピングされます。
Azure DevOps Pipeline拡張機能をインストールすると、Visual StudioのZoho Sprints拡張機能も自動的にインストールされます。Visual Studioマーケットプレイスから直接Zoho Sprints拡張機能をインストールしないでください。Zoho Sprintsタスクの操作は、関連付けられたプロジェクトでのみ実行できます。

Azure認証の挙動

Azure DevOpsのクラウドおよびサーバーとの連携は、AzureのAPI制限により挙動が異なります。クラウドベースの取引先の場合、最大5つのプロジェクトを関連付けることができます。サーバーベースの取引先では、挙動が同じではありません。

サーバーベースのアカウントでは、API制限のため1つのプロジェクトのみ関連付け可能です。ただし、インストール時に複数のプロジェクトを選択しても、最初に選択したプロジェクトのみが関連付けられ、インストールは完了します。しかし、連携認証は解除されます。そのため、最初の連携後に他のプロジェクトを関連付けようとすると、Azure側で不正なアクセスとみなされ、認証ページへリダイレクトされます。連携を復元するには、再認証が必要です。

Azure DevOps Pipelineの共通タスクパラメーター

インストールが完了すると、Azure DevOps PipelineからZoho Sprints内の商品、スプリント、リリースの作成や更新が可能になります。データの入力形式については、下記リストを参照してください。必要なデータの取得方法については、こちらをクリックしてgifをご確認いただけます。
 

項目

種類

プロジェクト 番号

番号

Sprint 番号

番号

商品 番号

番号

Release 番号

番号

日付

2022-05-20T00:00:00Z (UTC 形式)   

 

タスク

  1. Zoho SprintsでFeedステータスを追加
  2. Zoho Sprintsで商品コメントを追加
  3. Zoho SprintsでSprintコメントを追加
  4. Zoho SprintsでSprintを完了
  5. Zoho Sprintsで商品を作成
  6. Zoho SprintsでReleaseを作成
  7. Zoho SprintsでSprintを作成
  8. Zoho SprintsでSprintを開始
  9. Zoho Sprintsで商品を更新
  10. Zoho SprintsでReleaseを更新
  11. Zoho SprintsでSprintを更新
この拡張機能を利用するには、Zoho Sprintsで有効にする必要があります。Azure DevOps PipelineをZoho Sprintsにインストールすると、Zoho Sprints拡張機能が自動的にAzure組織にインストールされます。

タスクパラメーター

Zoho Sprints の Work 商品

Azure DevOps PipelineタスクからWork商品を作成または更新する際に入力が必要な項目は以下の通りです。
  1. プロジェクト: プロジェクト番号を入力してください
  2. Sprint: Sprint番号を指定してください（0はプロジェクトバックログを意味します）
  3. 商品番号: 更新対象となる商品の商品番号を入力してください
  4. 名前: Work商品の名前を入力してください
  5. 説明: Work商品の説明を入力してください
  6. ステータス: Work商品のステータスを指定してください
  7. 種類: Work商品の種類を指定してください（例：タスク）
  8. 優先度: Work商品の優先度を設定してください（例：高い）
  9. 開始日: Work商品の開始日を指定してください（例：2022-08-13T00:00:00Z）
  10. 終了日: Work商品の終了日を指定してください。開始日より後の日付にしてください（例：2022-09-13T00:00:00Z）
  11. 商品担当者: 商品ユーザーのメールアドレスを入力してください（カンマ区切り）
  12. Estimation points: 商品に設定された見積ポイントのインデックスを入力してください（例：フィボナッチ見積種類で2のインデックスは2、8のインデックスは5）
  13. コメント: Work商品に追加するコメントを入力してください
  14. 期間: Work商品の経過時間を入力してください（例：2時間50分）
  15. カスタム項目: カスタム項目の値をここに指定します。複数のカスタム項目がある場合、新規折れ線グラフで記載してください。
    1. 例
    2. UDF1_BOOLEAN=123456
    3. UDF1_TEXT=text値

Zoho Sprints の Sprints

Azure DevOps PipelineタスクからSprintを作成・更新・開始・完了する際に入力が必要な項目は以下の通りです。
  1. プロジェクト: プロジェクト番号を入力します。
  2. Sprint: スプリント番号を入力します。
  3. Sprint 名前: スプリントに名前を付けます。
  4. 説明: スプリントの内容を記載します。
  5. Scrum Master: スクラムマスターのメールアドレスを入力します。
  6. Sprint ユーザー: スプリントユーザーのメールアドレスをカンマ区切りで入力します。
  7. 開始日: スプリントの開始日を指定します（例: 2022-08-13T00:00:00Z）。
  8. 終了日: スプリントの終了日を指定します（例: 2022-08-13T00:00:00Z）。
  9. 期間: スプリントのおおよその期間を入力します。strict scrumが有効な場合、スプリント期間は8週間を超えることはできません。strict scrumが無効の場合、最大30週間まで設定できます（例: 2時間50分）。
  10. コメント: そのスプリントに追加するコメントを入力します。
  11. カスタム項目: カスタム項目の値をここに指定します。複数のカスタム項目がある場合は、新規折れ線グラフで記載してください。
    1. 例:
    2. UDF1_BOOLEAN=12345
    3. UDF1_TEXT=text 値

Zoho Sprints のリリース


Azure DevOps Pipelineタスクからリリースを作成または更新する際に入力する項目は以下の通りです。
  1. プロジェクト: プロジェクト番号を入力します。
  2. Release 名前: リリースに名前を付けます。
  3. Release Goal: リリースの目的を記載します。
  4. 開始日: リリースの開始日を入力します（例: 2022-08-13T00:00:00Z）。
  5. Release 日付: リリースの日付を入力します（例: 2022-10-13T00:00:00Z）。
  6. Owners: 担当者のメールアドレスをカンマ区切りで入力します。
  7. Release Stage: 現在のリリースステージを指定します（例: プラン）。
  8. カスタム項目: カスタム項目の値をここに指定します。複数のカスタム項目がある場合は、新規折れ線グラフで記載してください。
    1. 例:
    2. UDF1_BOOLEAN=12345
    3. UDF1_TEXT=text 値

Azure DevOps から作成を関連付ける

  1. Zoho Sprints でワーク商品の詳細ページに移動します。
  2. 右上のAzure DevOps Pipelineアイコンをクリックします。
  3. 関連付ける作成ボタンをクリックします。
  4. 標準の条件を入力します。
  5. 検索をクリックします。
  6. 関連付けたい作成を選択し、関連付けるをクリックします。
 

Azure DevOps Pipeline の作成ステータスを表示する

Azure DevOps パイプラインを確認するには:
  1. Zoho Sprints にサインインします。
  2. 左のナビゲーションパネルからCI/CD表示を選択します。
  3. Azure DevOps Pipeline を選択します。
  4. マウスオーバーしてログを表示をクリックします。各パイプラインのログは履歴を表示するボタンをクリックして確認できます。
  5. これらのパイプラインは、特定の条件に基づいて表示することも可能です。右上をクリックし、条件を設定してフィルターを適用するをクリックしてください。


拡張機能を無効にする

プラグインを一時的に無効にするには:
  1. 右上の歯車アイコンをクリックします。設定ウィンドウが表示されます。
  2. マーケットプレイスセクションの「すべて」をクリックします。リストページが表示されます。
  3. Zoho Sprints 用の Azure DevOps Pipeline を探します。
  4. 無効にするをクリックします。拡張機能は無効になります。

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

アンインストールするには:
  1. 右上のギアアイコンをクリックします。設定ウィンドウが表示されます。
  2. マーケットプレイス セクションの すべて をクリックします。リストページが表示されます。
  3. Zoho Sprints 用 Azure DevOps Pipeline を探します。
  4. アンインストールする をクリックします。拡張機能がアンインストールされ、設定も削除されます。