この設定は、Parasoft 管理者が一度だけ行う必要があります。
このセクションの内容:
DTP を Azure DevOps に接続する
- 設定メニュー (歯車のアイコン) から [Report Center 設定] を選択します。
- [External System] を選択して [設定の編集] をクリックし、[システム タイプ] メニューから Azure DevOps を選択します。
- [Enabled] オプションを有効化します。
- [名前] フィールドにサーバー名を入力します。名前は必須ですが、接続設定に影響したり、他のインターフェイスで表示されたりすることはありません。
- [アプリケーション URL] フィールドに Azure DevOps システムの URL を入力します。Azure DevOps のコレクション名を含める必要があります。
- [表示 URL] フィールドは、Azure DevOps システムへのリンクが Web ブラウザーに表示されるときに Parasoft DTP ページに表示される URL を定義します。通常、これは上記の [アプリケーション URL] フィールドと同じである必要がありますが、リバース プロキシ環境で作業していて、Parasoft DTP を使用しているユーザーのローカル Web ブラウザーから Azure DevOps へのリンクが Parasoft DTP サーバーからとは異なる場合など、場合によっては異なることもあります (例: https://dev.azure.com/<yourorganization>)
- ユーザー名と Azure DevOps APIトークンを適切なフィールドに入力します (下記の「Azure DevOps トークンを生成する」を参照)。ログインには、[プロジェクトの関連付け] セクションで指定されたプロジェクトで Azure DevOps の課題を作成するのに十分な権限が必要です。
- [接続のテスト] をクリックして設定を確認し、[確認] をクリックします。
Azure DevOps トークンを生成する
Azure DevOps (
https://dev.azure.com/<yourorganization>) で自分の組織にサインインします。ホームページからユーザー設定を開き、[Personal Access Tokens] を選択します。
- [+New Token] を選択します。
- トークンに名前を付け、トークンを使用する組織を選択してから、トークンの有効期間を選択します。
このトークンのスコープを選択して、特定のタスクを承認します。
- [Scopes] で [Custom defined] を選択します。
- [Show all scopes] をクリックします。
- [Test Management] を選択し、[Read & write] を有効にします。
- [Tokens] を選択し、[Read & manage] を有効にします。
- [Work items] を選択し、[Read, write, & manage] を有効にします。
- [保存] をクリックします。
- 完了したら、必ずトークンをコピーしてください。セキュリティ上の理由から、再度表示されることはありません。このトークンをパスワードとして使用します。
個人用アクセス トークンが作成されると、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.workItemType.requirements | DTP トレーサビリティ レポート、Parasoft C/C++ および SOAtest の [要件] ビュー、およびテストケースの同期処理で要件として扱われる Azure DevOps の作業項目タイプのリストを指定します。名前はセミコロン (;) で区切ります。 デフォルト:
|
| azuredevops.syncTestCases.chunkSize | syncTestCases 操作中に Azure DevOps サーバーを呼び出すときに、リクエストの URL で使用する作業項目の最大数を設定します。すべての結果が同期されますが、URL の長さ制限などの API 制限を処理するために、サーバーへの各リクエストのサイズが制限されます。デフォルト値は 200 です。 デフォルト:
|
| azuredevops.syncTestCases.pointsQueryChunkSize | syncTestCases 操作中に Azure DevOps サーバーにテスト ポイント データをクエリーするときに、リクエストの URL で使用するテスト ケース ID の最大数を設定します。すべての結果が同期されますが、URL の長さの API 制限を処理するために、サーバーへの各リクエストのサイズが制限されます。 デフォルト:
|
2021.2 以前のバージョンから Parasoft DTP をアップグレードした場合、これらの Azure DevOps パラメーターが ExternalSystemSettings.properties ファイルにない可能性があります。その場合、上記の表にあるデフォルト値が使用されます。これらのパラメーターを変更するには、必ずパラメーターを ExternalSystemSettings.properties ファイルに追加してください。
