advpr-test-automation

ADVPR — Protheus テスト自動化

このスキルでは、ADVPL ベースの社内テストロボットである ADVPR を使用して、TOTVS Protheus の業務ルールに関する回帰テストを作成、実行する方法を説明します。FWTestHelper のアサーション API、TestSuite（GPS de Testes）でテストケースを登録、整理する方法、UI の有無に応じてスイートを実行する方法（FWMyTestRunner と、ヘッドレスの FwExecSuite の違い）、および MVC、ExecAuto/MSExecAuto、レポート、処理ルーチン、Web サービス（REST/SOAP/Portal）、SmartLink、Smart View、TOTVS Message（単一メッセージ）フローなど、ルーチンのパターンごとのスクリプト作成ガイダンスを扱います。また、「ルーチンの準備」、つまり公式のヘッドレス実行時に画面を表示せずに動作するよう、レガシーコードを調整する方法と、ADVPR のスクリプト作成に関する一般的なベストプラクティスも扱います。

ユーザーが ADVPR テストスクリプトの作成やデバッグ、TestSuite の設定、ヘッドレス実行中の TimeOut や予期しない画面表示の原因の特定を求めている場合、または特定のルーチンタイプに適用する ADVPR パターンについてガイダンスが必要な場合に、このスキルを有効にしてください。手動／インターフェース操作による QA、ADVPR 外での個別 ADVPL 関数の単体テスト、テスト自動化に関連しないランタイムエラーやコンパイルエラーの一般的なデバッグは対象外です（advpl-debugging を参照）。

参照ファイルはブラジルポルトガル語で書かれています。

参照ファイル	読むタイミング
reference.md	常に — ADVPR の概念、パッチの前提条件、FWMyTestRunner とヘッドレス実行の FwExecSuite の違い、TimeOut の原因
api-fwtesthelper.md	アサーション／期待値の作成時 — FWTestHelper メソッドの完全なリファレンス
best-practices.md	ADVPR スクリプトのレビューや作成時 — 推奨されるスクリプト作成規約
gps-de-testes.md	TestSuite とそのテストケース（GPS de Testes）の作成／整理時
patterns-execauto.md	ExecAuto/MSExecAuto 経由で公開されるルーチンの自動化時
patterns-mvc.md	MVC（ModelDef/ViewDef）ルーチンの自動化時
patterns-processing.md	バッチ／処理ルーチンの自動化時
patterns-reports.md	レポート（TOTVS Report、R3、FWMSPrinter、Smart View）の自動化時
patterns-routine-prep.md	公式のヘッドレス実行に向けて、画面やアラートを回避するようルーチンを調整する時
patterns-smartlink.md	SmartLink 経由で連携するルーチンの自動化時
patterns-smartview.md	Smart View ベースのルーチンの自動化時（Smart View の業務オブジェクトをテストするのではなく 作成する 場合は、smartview-development を参照）
patterns-totvs-message.md	単一メッセージ（TOTVS Message）パターンを使用するルーチンの自動化時
patterns-webservice.md	REST、SOAP、または Portal Protheus の Web サービスエンドポイントの自動化時