smartx-development について
TOTVS Smart Xのルーチンを開発するためのスキルです。データモデル、インターフェース、メニュー起動処理に加え、新規開発、ADVPL連携、MVCブラウズの移行、トラブルシューティングを扱います。
主な機能
- 01ObjectからLauncherへの構成
- 02Model・Interfaceクラス
- 03PO-UI画面の描画
- 04ADVPLアクション連携
- 05従来のMVCブラウズ移行
活用シーン
- 01Smart Xルーチンの開発
- 02ADVPL関数をページ・テーブル操作に接続
- 03MVCブラウズをSmart Xへ移行
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ thalysjuvenal/ advpl-specialist --skill smartx-developmentインストール後、Claude Code で/smartx-developmentを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
patterns-advpl-integration.mdpatterns-interface.mdpatterns-launcher-browse.mdpatterns-migration.mdpatterns-model.mdreference.mdtroubleshooting.md詳細
Smart X
このスキルでは、TOTVS Smart X ルーチンの開発について説明します。Object → Model → Interface → Launcher の流れにより、データディクショナリテーブル(SX2/SX3)から、Angular コンポーネントを手書きすることなく PO-UI 画面を自動レンダリングします。Model(totvs.framework.structure.model.th)および Interface(totvs.framework.structure.Interface.th)の TLPP クラスに必要なインクルードとアノテーション、Protheus メニューにルーチンを登録する Launcher 関数、pageActions/tableActions/イベントを介して既存の ADVPL 関数をインターフェイスに統合する方法、さらに、ModelDef/ViewDef/MenuDef はそのままに、レガシー MVC ルーチンのブラウズ(Data View)のみを Smart X に変換する方法を説明します。
新しい Smart X ルーチンを一から作成するとき、ADVPL 関数の呼び出しを Smart X のページ/テーブルアクションに組み込むとき、レガシー MVC のブラウズを Smart X のブラウズに変換するとき、または Smart X の画面/Model/Interface の問題をデバッグするときに、このスキルを有効にしてください。Smart X を使用しない従来型 MVC ルーチンの開発(advpl-code-generation の patterns-mvc.md を参照)や、SX2/SX3 自体のデータディクショナリ設定スクリプトは対象外です(sx-configuration を参照)。また、TReports 分析ツールである Smart View とは無関係です。同ツールのカスタムビジネスオブジェクトについては smartview-development で説明しています。名前は似ていますが、フレームワークは異なります。
参照ファイルはブラジルポルトガル語で記述されています。
| 参照ファイル | 読むタイミング |
|---|---|
| reference.md | 常に — Smart X の概念、Object/Model/Interface/Launcher のアーキテクチャ、インクルード/アノテーション、最小限のエンドツーエンドの例 |
| patterns-model.md | Model(model.tlpp)クラスと、そのデータ/ビジネスルール定義を作成またはレビューするとき |
| patterns-interface.md | Interface(interface.tlpp)クラスと、その UI コントラクト(ブラウズ/フォーム)を作成またはレビューするとき |
| patterns-launcher-browse.md | 既存の MVC ルーチンのブラウズ(Data View)のみを Smart X レンダリングに変換するとき |
| patterns-advpl-integration.md | pageActions、tableActions、onChange などのイベントを介して、Smart X から既存の ADVPL 関数を呼び出すとき |
| patterns-migration.md | レガシールーチン全体を 100% Smart X 実装に移行するとき |
| troubleshooting.md | Smart X の画面、Model、または Interface でエラーや予期しない動作を診断するとき |