不変の参照ベースライン¶
Web クライアントでテストケースまたは要件の章を開き、履歴を選択します。参照ベースラインを選ぶと、そのオブジェクトの保存済み内容が開きます。ベースラインの作成や比較は、ライブラリまたは要件から管理ページを開いて行います。
参照ベースラインは Web クライアントで作成および読み取られます。Windows はプロジェクトデータを保持しますが、専用のベースラインインターフェースはありません。
参照ベースラインは要件とテストライブラリを名前の下にまとめて保存します。元の変更や削除は保存された内容を変更しません。例えば製品機能の改訂前後で同じ範囲の今日の内容と比較して検査できます。
ベースラインは不変の参照点です。電子署名、コンテンツ承認、自動リリース承認ではありません。テストケースのバージョンは個別の通常テストケースをキャプチャし、リリース比較はテスト結果を評価します。
参照ベースラインの名前を選択して開きます。項目が多い場合は、表の下でページを切り替えられます。項目名を選択すると、保存された内容が表示されます。
前提条件と権限¶
作成には、管理者ロールのアクティブなプロジェクトアカウント、またはプロジェクト設定の編集権限を持つプロジェクトマネージャーロールが必要です。また、選択した範囲全体を読み取ることができなければなりません。これには、名前、継承された内容またはファイルが取得されるリンクされたオブジェクトおよび親ソースが含まれます。不十分な権限の場合、作成は不完全なベースラインを静かに生成するのではなく拒否されます。
ファイルの読み取り、比較、ダウンロードは現在の権限を再確認します。ベースラインの作成は恒久的な特別アクセスを付与しません。必要なオリジナルが存在しないか、コピーでプロジェクトの識別が変わった場合、保存されたベースラインを読み取れるのはプロジェクト管理者のみです。権限の取り消しにより、以前は表示されていたベースラインがリストから削除され、既知の詳細またはダウンロードリンクがブロックされる可能性があります。
ベースラインを取得する¶
- Webプロジェクトで参照ベースラインを開きます。テストライブラリや要件からもページにアクセスできます。 ベースラインを作成を選ぶと、入力ダイアログが開きます。
- 「チェックアウト前のリビジョン」などの意味のある名前と理由を入力し、この参照ポイントが必要な理由を記述してください。
- 要件のスコープを選択します:すべての要件、またはフォルダー、ドキュメント、章とその子孫。
- 完全なテストライブラリまたはテスト単位とその子孫単位およびテストケースを独立して選択します。要件リンクは他のテストケースを自動的に含めるために選択を拡張しません。
- スコープの両方を確認し、不変のキャプチャを明示的に承認します。保存されたベースラインを開き、そのオブジェクトとファイルをチェックしてください。
名前、理由、作成者、キャプチャ時間および範囲はコンテンツと共に保持されます。このバージョンでは個別のベースラインの編集、復元または削除はできません。作成は元のテストケースのバージョン、計画、実行または結果を変更しません。
アプリケーションが同時変更を報告した場合は、ソースを再読み込みし、リクエストを再確認してください。サイズ制限を超えた場合は、より小さい範囲を選択してください。切り詰められた部分的なベースラインは決して保存されません。
保存された内容およびファイル¶
ベースラインには、選択された構造と順序、説明、定義付きのカスタムフィールド、キャプチャ時に有効な継承コンテンツ、要件からテストケースへのリンクが含まれます。通常のテストケースにはバリアント、ステップ、期待結果、再利用可能なステップブロックが含まれます。クイックテストケースにはさらにフィールド定義、行、セル、行属性が含まれます。
保存された添付ファイルおよび埋め込み画像は、元のファイルに関係なくバイト単位で保持されます。これには継承された添付ファイルやQuickセル内のファイルも含まれます。キャプチャ時に既に存在しないファイルは明示的に欠落としてマークされます。外部ファイルリンクは参照のままであり、対象は自動的にダウンロードまたはファイルコピーとしてアーカイブされません。履歴プレビューは外部画像を取得しません。パスワードフィールドは除外されます。
制限はファイルあたり100 MB、保存されたすべてのファイルの合計で256 MBです。アプリケーションはオブジェクト数とコンテンツサイズも制限します。完全なプロジェクトをバックアップしてください:履歴ファイルの内容はプロジェクトデータベースに属します。スプレッドシートやテキストのエクスポートはそのバックアップの代わりにはなりません。
現在のスコープと比較する¶
保存されたベースラインを開き、現在の内容との比較を要求します。概要では追加されました、削除済み、変更済み、および変更なしオブジェクトが区別されます。詳細な差分では、リンク、バリアント、順序、ファイルを含む旧値と現在の値が表示されます。
比較は保存されたスコープを再度今日のプロジェクトに対して解決します。新たに追加された子は現在の比較に含まれ、スコープから移動されたオブジェクトは削除されたと見なされます。削除されたスコープルートは比較をプロジェクト全体に拡大しません。その側の現在のスコープは空であり、保存されたオブジェクトは削除されたものとして表示されます。Webビューは警告を表示します。ソースが削除されたため、その履歴ベースラインはプロジェクト管理者のみが閲覧可能です。現在の内容も完全に読み取り可能でなければなりません。
例:要件ドキュメントと「Checkout」テスト単位をキャプチャします。次にテストステップを変更し、要件リンクを削除し、単位内にクイックテストケースを追加します。比較では、変更されたケースのフィールド差分と新規追加されたクイックテストケースが表示されます。保存されたベースラインは元のステップとリンクを保持します。比較はライブラリやテスト計画に変更を適用しません。
MCPおよびREST¶
APIはWebと同じプロジェクトおよびオブジェクトの権限を使用します。project.library-baseline.read機能はプロジェクトAPIアクセスと現在の読み取り権限を必要とし、追加の読み取り範囲付与は不要です。RESTはツールをPOST /api/v1/operations/<tool name>として公開します。認証およびプロジェクトルーティングについてはREST 章を参照してください。利用可能性はインストールされたサーバーバージョンに依存します。
| ツール | 入力と結果 |
|---|---|
ztm_library_baseline_options |
許可された要件/テスト単位のスコープと作成可能性を読み取る |
ztm_library_baseline_list |
表示可能なベースラインを skip と take(最大 100)で読み取ります。HasMore は別ページを示します。 |
ztm_library_baseline_read |
baselineId:保存された内容とアセットのメタデータをファイルバイトなしで読み取ります。 |
ztm_library_baseline_compare |
baselineId:保存されたスコープの現在の内容と比較します。 |
ztm_library_baseline_asset |
baselineId、assetId:最大512KiBの保存ファイルを読み取ります。ContentはBase64エンコードされています。 |
認証されたWebダウンロードを通じて、許可されたユーザーはより大きなファイルをダウンロードします。APIも外部参照を取得しません。
比較はMissingScopeRoots内で削除されたスコープルートも報告します。この警告は、オブジェクトを含まない既存のスコープと欠落したスコープを区別します。
作成には明示的に付与されたproject.library-baseline.create書き込み権限および有効な書き込みアクションが必要です。ztm_project_action_prepareをこのcapabilityId、あなた自身のidempotencyKey、および例えばこれらのargumentsで呼び出してください:
{
"name": "Checkout before revision",
"reason": "Jointly confirmed reference point for the revision",
"scope": { "requirementType": "", "requirementId": 0, "testUnitId": 0 },
"operationId": "b7830698-beb9-4a89-a3c3-cf1a07543ee9",
"scopeConfirmed": true
}
空のrequirementTypeとrequirementId: 0はすべての要件を選択します。そうでなければ、スコープオプションで返されたIDを使ってReqFolders、ReqDocuments、またはReqChaptersを使用してください。testUnitId: 0はライブラリ全体を選択します。責任者ユーザーは名前、理由、および両方のスコープを実際に選択し確認する必要があります。scopeConfirmedはその決定を置き換えません。
プレビューを確認し、その後同じcapabilityIdおよび返されたpreviewTokenを持つztm_project_action_commitを通じて明示的に承認してください。準備だけではベースラインは保存されません。認証されたユーザーが作成者です。リトライ用にoperationIdを保持してください。同じIDの変更された内容は拒否されます。リトライは現在の権限も再確認します。一般的な書き込み権限は参照ベースラインの編集、復元、削除を可能にしません。
Windowsから開きます。¶
Windowsで、ライブラリのテスト単位、要件フォルダー、要件ドキュメント、または要件章を右クリックし、Webで参照ベースラインを開くを選択します。選択した範囲が作成用に事前選択されます。ページを開いてもベースラインは作成されません。Webは権限を再確認します。
認証済みのWindowsセッションにより自動的にサインインされます。ハンドオフが失敗した場合のみサインインページが表示され、遷移先は保持されます。
要件変更の影響¶
変更影響ビューの保存されたベースラインを使用して、要件章とその現在の内容および関連する読み取り可能なテストを比較します。分析は再テストを作成しません。
別のプロジェクトから標準を採用する¶
Webクライアントで、別のアクセス可能なプロジェクトから明示的に選択した参照ベースラインをローカルの通常テストケースとして採用できます。テストライブラリのヘッダーでプロジェクト標準を選択するか、インポート/コンテキストメニューで参照ベースラインをインポートするを選択してください。読み取り専用ユーザーは比較が可能です。書き込み権限がない場合はブロッカーとして表示され、適用を妨げます。通常のプロジェクトインポートは引き続き利用可能で、現在のソース内容をコピーしますが、履歴ベースラインとの制御された関係は確立しません。
- ソースプロジェクト、読み取り可能な参照ベースラインおよび宛先フォルダーを選択してください。個別の通常ケースまたはテスト単位とその子孫単位およびケースを選択します。展開された選択は最大200の単位とケースを含むことができ、重複する選択は各オブジェクトを一度だけカウントします。ベースラインを選択してもその内容の承認や公開にはなりません。
- 一致する名前の取り扱い方法を選択し、プレビューを確認してください。対象パス、最終名、影響を受けるローカルケースおよびブロッカーを含みます。採用は保存された内容とファイルを使用し、以降のソースのライブ変更はそれらを置き換えません。
- 後で新しく選択したベースラインを採用する際、プレビューはソースの変更、ローカルの変更、両者の変更を区別します。ローカルの変更はデフォルトで保持されます。ローカルの変更を置換はレビュー済みの個別ケースにのみ選択し、その後決定事項を確認するを選択して新しいプレビューを準備してください。テキストは自動的にマージされません。
- プレビューを確認した後に適用を確認してください。レシートから保存されたローカルケースを開き、再読み込み後に内容と添付ファイルを確認してください。
選択されたテスト単位は、保存された名前と履歴的階層を保持したまま、空の単位も含めて宛先フォルダーの下に作成されます。後のソースでの移動はその履歴構造を変更しません。単位はコンテナとして機能し、その独自のソース説明、属性、添付ファイル、権限はコピーされません。以前にマッピングされたターゲット単位は再インポート時に再利用され、名前変更や後のソース変更に伴う移動は行われません。
コピーは独自のローカルID、通常のバリアント、独立したファイルおよびテストケースのバージョンを持ちます。同じ完了済み操作を繰り返しても別のコピーは作成されません。後からの明示的な更新はマッピングされたターゲットケースのIDを保持します。テンプレートおよびオープンランは既存のコピーを保持し、必要に応じて別途同期してください。ソースACL、ユーザーアカウント、認証情報および外部要件や依存関係のリンクはローカル関係としてインポートされません。
インポートされた通常ケースはソースと更新を提供します。その起源を開き、比較したい読み取り可能なベースラインを明示的に選択し、比較するを選択してください。現在のソースアクセスがない場合、一般的な起源のヒントのみが残りますが、ローカルケースは引き続き使用可能です。インポート時に割り当てられた衝突サフィックスを含む元の名前の追加はケース更新時に保持され、新しいプレフィックスとサフィックスは新しいコピーに適用されます。移動されたローカルケースはターゲットフォルダーを保持します。削除またはコピーされたターゲットは名前の一致によって再マッピングされません。
ソースプロジェクトに実際にマッピングされたアクティブユーザー、選択されたベースライン全体への読み取りアクセス、および適切なターゲット権限が必要です。ケースの作成と既存ケースの更新には別々の権限が必要です。ソースアクセスの欠如は選択を静かに減らしてはなりません。新しい採用は実行開始時に認可されたソースを再チェックおよび読み取り、その後ローカルターゲットの変更を行います。両プロジェクト間に共有トランザクションはありません。後でソースアクセスを失っても正当に保存されたローカル内容は削除されません。正確な再生は現在のターゲットアクセスをチェックし、追加のソース情報は明らかにしません。
安定したオブジェクトIDや必要な履歴フィールドおよびバリアント定義が保存されていない古いベースラインは、この管理されたワークフローには使用できません。現在の定義を履歴として提示する代わりに、ソースで新しい完全なベースラインをキャプチャしてください。アクティブなテストデータバインディングを持つクイックテストケースおよびバリアントはこのワークフローから除外されます。非移植可能な内容やファイルはプレビューでブロッカーとして表示され、確定した選択は部分的に適用されません。Windowsでは、結果として得られたローカルケースを通常のテストケースとして使用できます。管理された採用および比較はWebクライアントを使用します。
一致する名前の処理¶
名前の決定は、同じターゲットフォルダー内の新しいオブジェクトに適用され、テスト単位とテストケースごとに別々に行われます。
- インポート: 同じ名前で独立したコピーを作成します。既存のオブジェクトは上書きされません。
- スキップ: 競合するオブジェクトを省略します。テスト単位の場合、選択されたサブツリー全体をスキップし、その中に既にマッピングされたケースも含みます。
- 名前の変更: 「(2)」や「(3)」などのサフィックスを付けた利用可能な名前を使用してください。プレビューには最終的な名前が表示されます。
既存の起源マッピングは同一性で認識されます。更新は個別のローカル変更判断に従い、名前の一致はマッピングを確立しません。選択された非移植ケースは スキップ があってもブロッカーのままで、採用全体を停止します。プレビュー後にターゲットが変更された場合は、新しいプレビューを確認してください。
属性、画像および制限¶
ポータブル属性には、自由記述のテキスト、明確に定義された単一行または複数行のテキストフィールド、整数、日付、チェックボックス、単一選択または複数選択リスト、簡単なHTMLフィールドが含まれます。必須フィールドは名前、タイプ、および保存された定義によって一意に一致されるか、必要な管理権限でローカルに作成されます。キャプチャ時に有効な継承値は、さらなる継承なしに独立したローカル値として保存されます。更新はインポートされたフィールドを特定的に変更し、追加のローカル属性は保持されます。
パスワード値は転送されません。SQLフィールド、ボタン、メニューおよびリンクフィールドタイプはこの制御されたワークフローから除外されます。完全な履歴フィールド定義を持たない古いベースラインは新しいキャプチャが必要であり、現在の定義は決して置き換えられません。HTML属性値およびバリアント定義内の画像は、プレビューで移植可能と確認された場合に独立してコピーされます。属性定義のデフォルト値内の画像は現在明示的なブロッカーです。ブロッカーは確認された選択全体を停止します。
Windowsから開きます。¶
Windowsで、対象のテスト単位を右クリックし、Webでプロジェクト標準を開くを選択します。Webのワークフローがその対象を事前選択します。既存の認証済みWindowsセッションでサインインされます。引き継ぎに失敗した場合でも、Webサインインは宛先を保持します。プロジェクト全体のオプションのWindows Webエントリーの可視性設定により、このメニュー項目が非表示になることがあります。採用および比較には別のWindowsエディターはなく、結果として得られるローカルケースは通常のWindowsテストケースのままです。
制御された導入のためのMCPおよびREST¶
読み取り機能はproject.standards.readです。ztm_project_standards_lookupはkind: sources、baselines、targets、itemsまたはunitsを含む認可された選択肢を返します。ベースラインにはsourceProjectIdが必要で、テストケースおよび履歴テスト単位にはsourceBaselineIdも必要です。ページングにはskipを使用し、queryはソースおよびターゲットのみ許可され、take(1~100)はケースおよび単位のみ許可されます。プロジェクトパスおよび外部ユーザーIDは入力ではありません。
ztm_project_standards_preview は保存せずに明示的に選択されたセットを比較します。sourceProjectId、sourceBaselineId、ご自身の operationId、targetTestUnitId および items をそれぞれ異なる sourceTestCaseId と共に提供してください。各ケースは replaceLocalChanges を設定でき、デフォルトは false です。特定の置換をレビューした後にのみ true に設定してください。オプションの namePrefix および nameSuffix はそれぞれ100文字以内に制限されます。sourceTestUnitIds を使用して履歴単位とそのサブツリーも選択できます。単位のみの選択でも空の配列として items が必要です。拡張選択はケースと単位の合計で200件に制限されます。conflictHandling は import(デフォルト)、skip または rename を受け入れます。プレビューと受領には追加で Containers が含まれ、ケースプレビューは TargetPath と TargetTitle を公開します。一般的な書き込み権限は選択や個別置換を決定しません。
適用するには、capabilityId: project.standards.applyおよびご自身のidempotencyKeyとともにztm_project_action_prepareに同じ引数を渡してください。返されたプレビューを確認し、同じ機能とそのpreviewTokenでztm_project_action_commitにより確定します。耐久性のある受領証は認可されたローカルターゲットと適用された改訂を識別します。繰り返しは同じoperationIdと内容を保持し、引数の変更は再生されません。読み取り不能になったターゲットIDは繰り返し要求時に非表示のままです。
受領書は誰がいつ(UTC)インポートを適用したかを記録します。作成または更新された各テストケースについて、コピーされたバリアント数およびファイル参照(インライン画像を含む)、コピーから省略されたソース要件リンクおよび依存関係をカウントします。古い受領書はこれらの詳細を省略する場合があります。
ztm_project_standards_receiptはサインインユーザーの保存済みレシートをoperationIdでソースを再度開かずに読み取ります。現在のターゲット権限がターゲット参照をフィルタリングし、操作が存在しない場合は未検出として報告されます。
追加の読み取りは後続の更新をサポートします。
| ツール | 使用法 |
|---|---|
ztm_project_standards_imported |
オプションのtargetTestUnitId、query、skip、take(1~200、デフォルト50)を指定して、読み取り可能なローカル標準を一覧表示します。非表示のソース参照は省略されます。 |
ztm_project_standards_origin |
testCaseId:ローカルの由来を読み取ります。ソースプロジェクト、ベースライン、およびケースの詳細は現在のソースアクセスがある場合のみ表示されます。そうでない場合は一般的な起源のヒントが残ります。 |
ztm_project_standards_compare |
sourceProjectId、sourceBaselineId、および1~200の異なるtargetTestCaseIds:書き込みなしで明示的に選択されたソースベースラインと既存のローカルケースを比較します。そのベースラインに存在しないことは自動的に削除を意味しません。 |
ターゲットを絞った更新の場合、itemsエントリーは追加でtargetTestCaseIdを含むことがあります。そのローカルケースは記録された起源と一致しなければなりません。任意のターゲットIDでは関係を確立できません。これにより、移動後のローカルケースにも対応可能です。Prepare/Commit前に比較および個別の置換判断を再度確認してください。
REST は POST /api/v1/operations/<tool-name> を通じて同じツールを公開します。現在のプロジェクト/オブジェクトの権限、API キーのスコープ、有効な書き込みアクションおよびデモ制限は Web クライアントと同様に適用されます。詳細は REST 章 を参照してください。利用可能な操作はインストールされているサーバーバージョンに依存します。
プロセス終了後の再開¶
制御された標準採用のために、VistaDBは一時的な完全なデータベースコピーを変更し、成功裏に完了した後に元のファイルを置き換えます。これには利用可能なデータベースアクセスおよびインポートされたファイルとバージョンを含むデータベース全体の追加ディスクスペースが必要です。別のアクセスがデータベースを開いたままにしている場合、アプリケーションはそれを報告します。そのアクセスを閉じてリクエストを再試行してください。
ファイル置換前のプロセス終了は前のデータベース状態をそのまま残します。置換後は変更と受領が保存され、同じ操作IDで再試行すると保存された結果を取得できます。この保護は管理された標準採用に適用され、既に破損したデータベースを修復しません。データベースの競合が続く場合は、バックアップ取得後に管理者に状態を確認してもらってください。自動修復は行われません。