Soneta Tools — narzędzia deweloperskie CLI
Skill dokumentuje narzędzia wiersza poleceń stosowane w Soneta do programowania
i zarządzania platformą (enova365, Triva). Każde narzędzie ma własny, dokładny
reference oparty na rzeczywistym interfejsie (--help + kod źródłowy).
Mapa skilla — które narzędzie do czego
Każde narzędzie ma referencję funkcji/parametrów oraz osobny dokument o konkretnym zastosowaniu.
| Narzędzie | Dokument | Rodzaj | Co zawiera |
|---|---|---|---|
dbmgr |
references/dbmgr.md | referencja | Zarządzanie bazami danych z CLI: tworzenie/rejestracja/kasowanie, konwersja, backup/restore (.bac/.zip), licencje i klucz wirtualny, rozszerzenia, import XML, analiza, kompilacja. Wszystkie komendy i opcje. |
dbmgr |
references/dbmgr-cli-menu.md + assets/dbmgr-menu.cs | zastosowanie | Wzorzec + gotowy szablon: owinięcie dbmgr w interaktywne menu CLI (Spectre.Console) na jednoplikowej aplikacji C# — wybór bazy z listy, tryby środowisk, gotowe akcje. |
buscall |
references/buscall.md | referencja | Zdalne wywoływanie metod aplikacji: tryby call/callmcp, składnia argumentów klucz=wartość, odkrywanie metod (methods.list), katalog metod Bundle (nawigacja, formularze, gridy, zrzuty), kody wyjścia. |
SonetaFrame |
references/sonetaframe.md | referencja | Aplikacja ramki (SonetaFrameNew) hostująca webową wersję programu: uruchamianie (dotnet SonetaFrameNew.dll), parametry -s/--start, -c/--connection, plik konfiguracyjny (Settings_<Product>.json) i pełna składnia źródeł baz danych (demo:, http(s):, docker:, process:, orchestrator: + modyfikatory). |
Uwaga: wizualną weryfikację kodu na żywej aplikacji przez
buscall(baza startująca z Twojego kodu, przeładowanie DLL, pułapki osieroconych procesów/portów, zrzuty ekranu do oceny wyglądu formularzy) opisuje dokumentbuscall-live-testing.mdw skillu/soneta-programming.
Żywa aplikacja z WŁASNYM dodatkiem — kompletny przepis w trzech krokach: (1) per-bazowy
serversettings.json(Ext+Server.DbRegister) i utworzenie bazy z tabelami dodatku — references/dbmgr.md, sekcja „Baza z własnym dodatkiem"; (2) wpięcie tej samej konfiguracji wSourcesramki przezconfig-file=— references/sonetaframe.md; (3) sterowanie i zrzuty ekranu — references/buscall.md, „Typowy przepływ".
Wspólny kontekst
- Binaria znajdują się w katalogu wyjściowym buildu (
bin/Debug) odpowiedniego projektu. Dokładna ścieżka zależy od Twojego układu repozytoriów — w przykładach piszemy krótkodbmgr/buscall, zakładając alias, wpis wPATHalbo uruchamianie z katalogu buildu:dbmgr→dbmgr.exe(Windows) lubdotnet dbmgr.dll(cross-platform),buscall→buscalllubdotnet BusCall.dll(katalog buildu projektu BusCall),SonetaFrame→dotnet SonetaFrameNew.dll(aplikacja ramki).
- Nazwa bazy w obu narzędziach (
--db <Baza>wbuscall,<database_name>wdbmgr) odwołuje się do wpisu w konfiguracji (połączenie zdefiniowane wSonetaFrame/ plikSettings_<Product>.json), a nie bezpośrednio do fizycznej nazwy bazy SQL. Szczegóły w referencjach. - Platforma .NET 10, narzędzia działają cross-platform (macOS/Windows/Linux).
Jak wybrać
- Operujesz na strukturze/danych bazy (utwórz, skonwertuj, backup, licencja, extension)
→
dbmgr(references/dbmgr.md). - Sterujesz uruchomioną aplikacją (nawigacja, formularze, zrzuty ekranu)
→
buscall(references/buscall.md). - Uruchamiasz samą aplikację, konfigurujesz połączenia/źródła baz danych albo pytasz
o plik ustawień ramki →
SonetaFrame(references/sonetaframe.md).
Powiązane skille
/soneta-programming— warstwa ORM i kod biznesowy;buscallsłuży do weryfikacji napisanego tam kodu na żywej aplikacji./soneta-containers— uruchamianie i wdrażanie produktu w kontenerach (docker compose, Apple container / Container Desktop, Helm). Tu wołaszdbmgrw kontenerze (obrazserver.standardmadbmgr.dll) — składnię komend bierzesz z tego skilla, orkiestrację z/soneta-containers./soneta-erp— meta-skill z mapą wszystkich skilli platformy Soneta.