この設定は、Parasoft 管理者が一度だけ行う必要があります。 

このセクションの内容:

DTP を Azure DevOps に接続する

  1. 設定メニュー (歯車のアイコン) から [Report Center 設定] を選択します。
  2. [External System] を選択して [設定の編集] をクリックし、[システム タイプ] メニューから Azure DevOps を選択します。
  3. [Enabled] オプションを有効化します。
  4. [名前] フィールドにサーバー名を入力します。名前は必須ですが、接続設定に影響したり、他のインターフェイスで表示されたりすることはありません。
  5. [アプリケーション URL] フィールドに Azure DevOps システムの URL を入力します。Azure DevOps のコレクション名を含める必要があります。
  6. [表示 URL] フィールドは、Azure DevOps システムへのリンクが Web ブラウザーに表示されるときに Parasoft DTP ページに表示される URL を定義します。通常、これは上記の [アプリケーション URL] フィールドと同じである必要がありますが、リバース プロキシ環境で作業していて、Parasoft DTP を使用しているユーザーのローカル Web ブラウザーから Azure DevOps へのリンクが Parasoft DTP サーバーからとは異なる場合など、場合によっては異なることもあります (例: https://dev.azure.com/<yourorganization>)
  7. ユーザー名と Azure DevOps APIトークンを適切なフィールドに入力します (下記の「Azure DevOps トークンを生成する」を参照)。ログインには、[プロジェクトの関連付け] セクションで指定されたプロジェクトで Azure DevOps の課題を作成するのに十分な権限が必要です。 
  8. [接続のテスト] をクリックして設定を確認し、[確認] をクリックします。

Azure DevOps トークンを生成する

  1. Azure DevOps (https://dev.azure.com/<yourorganization>) で自分の組織にサインインします。

  2. ホームページからユーザー設定を開き、[Personal Access Tokens] を選択します。

  3. [+New Token] を選択します。
  4. トークンに名前を付け、トークンを使用する組織を選択してから、トークンの有効期間を選択します。

  5. このトークンのスコープを選択して、特定のタスクを承認します。

    1. [Scopes] で [Custom defined] を選択します。
    2. [Show all scopes] をクリックします。
    3. [Test Management] を選択し、[Read & write] を有効にします。
    4. [Tokens] を選択し、[Read & manage] を有効にします。
    5. [Work items] を選択し、[Read, write, & manage] を有効にします。
    6. [保存] をクリックします。
  6. 完了したら、必ずトークンをコピーしてください。セキュリティ上の理由から、再度表示されることはありません。このトークンをパスワードとして使用します。

個人用アクセス トークンが作成されると、Azure DevOps での認証にユーザー資格情報が必要な場所ならどこでも使用できます。

詳細設定

<DTP_DATA_DIR>/conf ディレクトリにある ExternalSystemSettings.properties 構成ファイルを変更して、統合のデフォルトの動作を変更できます。すぐに利用できる DTP と Azure DevOps の統合は、デフォルトまたは一般的に使用されるフィールドと作業アイテム タイプを使用するように構成されています。ただし、Azure DevOps システムをカスタマイズしている場合は、以下で説明する設定を行って、DTP のデータをカスタム構成に合わせることができます。

ExternalSystemSettings.properties は ISO 8859-1 (Latin1) 文字エンコーディングを使用することに注意してください。ISO 8859-1 でサポートされていない文字は、Unicode エスケープ シーケンス、つまりバックスラッシュ (\) と小文字の u の後に、その文字の 4 桁の 16 進コードが続くものを使用して、キーと要素で表現する必要があります。たとえば、ダッシュ (-) (ハイフン - マイナス ”-” と混同しないでください) は ISO 8859-1 ではサポートされていないため、Unicode エスケープ シーケンス \u2013 で表す必要があります。これにより、example.property.value=Foo – Bar のようなものは、example.property.value=Foo \u2013 Bar と入力する必要があります。

azuredevops.workItem.url

AzureDevOps の特定の項目への URL テンプレートを指定します。

デフォルト:

azuredevops.workItem.url=<AZUREDEVOPS_URL>/<PROJECT>/_workitems/edit/<ID>

azuredevops.workItemType.requirements

DTP トレーサビリティ レポート、Parasoft C/C++ および SOAtest の [要件] ビュー、およびテストケースの同期処理で要件として扱われる Azure DevOps の作業項目タイプのリストを指定します。名前はセミコロン (;) で区切ります。

デフォルト:

azuredevops.workItemType.requirements=Product Backlog Item;User Story;Requirement

azuredevops.syncTestCases.chunkSize

syncTestCases 操作中に Azure DevOps サーバーを呼び出すときに、リクエストの URL で使用する作業項目の最大数を設定します。すべての結果が同期されますが、URL の長さ制限などの API 制限を処理するために、サーバーへの各リクエストのサイズが制限されます。デフォルト値は 200 です。

デフォルト:

azuredevops.syncTestCases.chunkSize=200 

azuredevops.syncTestCases.pointsQueryChunkSize

syncTestCases 操作中に Azure DevOps サーバーにテスト ポイント データをクエリーするときに、リクエストの URL で使用するテスト ケース ID の最大数を設定します。すべての結果が同期されますが、URL の長さの API 制限を処理するために、サーバーへの各リクエストのサイズが制限されます。

デフォルト:

azuredevops.syncTestCases.pointsQueryChunkSize=25

2021.2 以前のバージョンから Parasoft DTP をアップグレードした場合、これらの Azure DevOps パラメーターが ExternalSystemSettings.properties ファイルにない可能性があります。その場合、上記の表にあるデフォルト値が使用されます。これらのパラメーターを変更するには、必ずパラメーターを ExternalSystemSettings.properties ファイルに追加してください。