config
/config
Konfiguracja platformy Soneta (enova365, Triva) — dla partnerów i zespołu Soneta: (A) IMPORT/EKSPORT DANYCH I USTAWIEŃ przez XML — element session, import według rekordów (*.dbinit.xml, demo) i przez logikę biznesową (business="true"), eksport datapacku, GUID; import/eksport list Excel/CSV; (B) `scan-folders` — foldery menu (`[assembly: FolderView]`) z DLL; (C) KONFIGURACJA URUCHOMIENIOWA `appsettings.json` — porty, warstwy nadpisań (`-c`, `SONETA_`, CLI); (D) REJESTR KONFIGURACJI (ConfigReg, „Zarządzanie konfiguracją") — `*.reg.json`, porównanie i scalanie, sigile (`$strict`, `#klucz`, `@atry
- Author
- soneta ↗
- Repository
- soneta-erp-skills ↗
- Licence
- MIT
- Last repository change
- 13.10.2026
Assessment and security
- Files in this package
- 18
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 13.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Konfiguracja platformy Soneta (enova365, Triva) — dla partnerów i zespołu Soneta: (A) IMPORT/EKSPORT DANYCH I USTAWIEŃ przez XML — element session, import według rekordów (*.dbinit.xml, demo) i przez logikę biznesową (business="true"), eksport datapacku, GUID; import/eksport list Excel/CSV; (B) `scan-folders` — foldery menu (`[assembly: FolderView]`) z DLL; (C) KONFIGURACJA URUCHOMIENIOWA `appsettings.json` — porty, warstwy nadpisań (`-c`, `SONETA_`, CLI); (D) REJESTR KONFIGURACJI (ConfigReg, „Zarządzanie konfiguracją") — `*.reg.json`, porównanie i scalanie, sigile (`$strict`, `#klucz`, `@atry
Triggers from the description
Original author description
Konfiguracja platformy Soneta (enova365, Triva) — dla partnerów i zespołu Soneta: (A) IMPORT/EKSPORT DANYCH I USTAWIEŃ przez XML — element session, import według rekordów (*.dbinit.xml, demo) i przez logikę biznesową (business="true"), eksport datapacku, GUID; import/eksport list Excel/CSV; (B) `scan-folders` — foldery menu (`[assembly: FolderView]`) z DLL; (C) KONFIGURACJA URUCHOMIENIOWA `appsettings.json` — porty, warstwy nadpisań (`-c`, `SONETA_`, CLI); (D) REJESTR KONFIGURACJI (ConfigReg, „Zarządzanie konfiguracją") — `*.reg.json`, porównanie i scalanie, sigile (`$strict`, `#klucz`, `@atry
How it works
- Kiedy ten skill, a kiedy inny
- Artykuły i narzędzia
- Powiązania
SKILL.md preview
--- name: config description: > Konfiguracja platformy Soneta (enova365, Triva) — dla partnerów i zespołu Soneta: (A) IMPORT/EKSPORT DANYCH I USTAWIEŃ przez XML — element session, import według rekordów (*.dbinit.xml, demo) i przez logikę biznesową (business="true"), eksport datapacku, GUID; import/eksport list Excel/CSV; (B) `scan-folders` — foldery menu (`[assembly: FolderView]`) z DLL; (C) KONFIGURACJA URUCHOMIENIOWA `appsettings.json` — porty, warstwy nadpisań (`-c`, `SONETA_`, CLI); (D) REJESTR KONFIGURACJI (ConfigReg, „Zarządzanie konfiguracją") — `*.reg.json`, porównanie i scalanie, sigile (`$strict`, `#klucz`, `@atrybut`). Używaj gdy użytkownik: (1) buduje XML importu, pyta o atrybuty guid/where/key/id/business/dbversion; (2) eksportuje rekordy guidowane; (3) mapuje menu z DLL; (4) pyta o `appsettings.json`; (5) pyta o rejestr konfiguracji, debuguje `*.reg.json` albo przenosi ustawienia między bazami; (6) importuje/eksportuje listę Excel/CSV (migracja). Kod importu → /soneta:programming; operacje na bazie z CLI → /soneta:tools. --- # Ustawienia, konfiguracja i funkcje domenowe platformy Soneta (enova365, Triva) Skill gromadzi narzędzia i mechanizmy związane z **konfiguracją systemu** oraz **funkcjami domenowymi** platformy Soneta. Zawartość jest rozwijana — poniżej udokumentowane są wyłącznie mechanizmy faktycznie obecne w skillu; kolejne artykuły dodawane są sukcesywnie. ## Kiedy ten skill, a kiedy inny | Potrzeba | Skill | |---|---| | **Budowa pliku XML importu danych i ustawień** (dbinit.xml, demo, tryby importu) | **/soneta:config** ([import-xml](references/import-xml.md)) | | **Eksport rekordów do XML** (datapack, zakres eksportu, przenoszenie konfiguracji) | **/soneta:config** ([export-xml](references/export-xml.md)) | | **Eksport listy do Excela/CSV** (ścieżki w nagłówku, pola kluczowe, kolejność kolumn, podlisty) | **/soneta:config** ([export-excel](references/export-excel.md)) | | **Import z Excela/CSV do listy, migracja z innego systemu** (akcje, kolumny specjalne, weryfikacja, raport błędów) | **/soneta:config** ([import-excel](references/import-excel.md)) | | **Import/eksport przez MCP** (`export_folder_list`, `import_folder_list`, `*_business_xml`, `*_configreg`), **import próbny** `testing=true` | **/soneta:config** ([mcp-import-export](references/mcp-import-export.md)) | | **Gotowy wzorzec pliku importu** dla typowego obiektu (słownik, definicja, rola, cecha, szablon, kokpit) | **/soneta:config** ([import-xml-examples](references/import-xml-examples.md)) | | Inwentaryzacja/mapa **folderów statycznych menu** (`[assembly: FolderView]`) z DLL | **/soneta:config** ([scan-folders](references/scan-folders.md)) | | **Konfiguracja uruchomieniowa** (porty, adresy komponentów, warstwy nadpisań `appsettings.json`) | **/soneta:config** ([appsettings](references/appsettings.md)) | | **Rejestr konfiguracji** (ConfigReg): `*.reg.json`, porównanie i scalanie ustawień między bazami | **/soneta:config** ([config-reg](references/config-reg.md)) | | Kod obsługujący import/eksport (`SessionReader`/`SessionWriter`), klasy ORM, workery | [/soneta:programming](../programming/SKILL.md) | | Inwentaryzacja modułów/tabel (`scan-modules`), pól (`scan-props`), workerów (`scan-workers`) | [/soneta:programming](../programming/SKILL.md) | | Operacje na bazie z CLI (dbmgr), test na żywej aplikacji (buscall) | [/soneta:tools](../tools/SKILL.md) | | Definicja struktury tabel/kolumn/relacji w XML (business.xml) | [/soneta:business-xml](../business-xml/SKILL.md) | | Formularze i widoki UI (form.xml) | [/soneta:form-xml](../form-xml/SKILL.md) | | Planowanie całego dodatku/modułu | [/soneta:addon-planning](../addon-planning/SKILL.md) | ## Artykuły i narzędzia ### Import danych przez XML — [references/import-xml.md](references/import-xml.md) Struktura i sposób budowania plików XML (`<session xmlns="http://www.soneta.pl/schema/business">`) do wczytywania danych i ustawień konfiguracyjnych. Dwa tryby: 1. **Import według rekordów** (domyślny) — dane wprost do pól rekordów, bez logiki biznesowej; kolejność pól bez znaczenia; do danych konfiguracyjnych, plików `*.dbinit.xml` i bazy demo. 2. **Import przez logikę biznesową** (`business="true"`) — ustawianie właściwości biznesowych z pełną walidacją; kolejność elementów jak przy wpisywaniu danych na formularzu. Artykuł specyfikuje identyfikację rekordów (GUID, `where`, `key`, `id`), formaty wartości (liczby, daty, referencje, kwoty z walutą), atrybuty specjalne oraz reguły plików `*.dbinit.xml` (`priority`, `versionName`, `dbversion`). Zawiera też gotowy, zweryfikowany importem **przykład** (obiekt w modelu „root + historia") — [examples/import-pracownik-etatowy.xml](examples/import-pracownik-etatowy.xml). ### Eksport listy do Excela i CSV — [references/export-excel.md](references/export-excel.md) Eksport dowolnej listy do `.xlsx` albo CSV (TAB, UTF-16) na właściwościach biznesowych obiektów. Nagłówek „ścieżka dostępu do danych" czyni plik szablonem importu. Artykuł opisuje opcje okna eksportu, zasady budowy ścieżek (`A.B`, `Obiekt:Klucz`, `Obiekt:Class`, sufiksy wartości złożonych, `//`), pola kluczowe identyfikujące obiekty przy imporcie (`Guid`, `ID`, klucze unikalne), kolejność kolumn zgodną z formularzem, podlisty (`Kolekcja:Pole` i wiersze kontynuacji) oraz checklistę eksportu pod ponowny import. ### Import z Excela i CSV do list (migracja) — [references/import-excel.md](references/import-excel.md) Wczytanie arkusza lub CSV do listy przez właściwości biznesowe z pełną walidacją, także migracja z innych systemów. Artykuł opisuje miejsca uruchomienia, budowę pliku (pierwszy arkusz, separator i kodowanie CSV), identyfikację obiektów (`Guid`, `ID`, klucze unikalne), akcje (`!Action` Add/Edit/EditAdd/Delete, także dla odwołań), odwołania i ich tworzenie, formaty wartości, podlisty, dane historyczne (`!Update`…), kolumny specjalne (`!Ignore`, `!Problem`, `!Thread`, `//`), przebieg (jedna transakcja „wszystko albo nic", paczki, wątki), etapy weryfikacji obiektów, raportowanie błędów (log „Excel", raport „Problem", tabela komunikatów), opcje konfiguracji, procedurę migracji i checklisty. ### Import i eksport przez MCP — [references/mcp-import-export.md](references/mcp-import-export.md) Metody pakietu „Import i eksport danych" dla agentów AI: lista ↔ Excel/CSV, XML, rejestr konfiguracji. Artykuł porównuje **tryby próbne** (`testing=true`): import listy wykonuje zapis wycofywany na końcu, XML kończy przed zapisem, a rejestr robi analizę scalenia. Opisuje też odpowiedzi (`errors`, `warnings`, numeracja wierszy), przekazywanie plików (`…FileName`, limit 1 MB), prawa i ustawienia pakietu, procedurę importu z próbą i checklistę. Odpowiedniki w wierszu poleceń (`dbmgr importxml`, `dbmgr configreg`) opisuje `/soneta:tools`. ### Eksport danych do XML — [references/export-xml.md](references/export-xml.md) Eksport według rekordów: wskazany rekord guidowany + rekordy powiązane (datapack; relacje inner jako kolekcje w rekordzie, outer jako osobne elementy główne). Artykuł opisuje ustalanie zakresu eksportu (`scan-forms`/`scan-props`), strukturę pliku wynikowego (`id`, `guid`, `Obiekt:GUID`, `deleted`, `fromto`), wybór między eksportem XML a rejestrem konfiguracji oraz checklistę eksportu do przeniesienia na inną bazę. Wynik jest gotowym plikiem importu według rekordów. ### Katalog wzorców importu XML — [references/import-xml-examples.md](references/import-xml-examples.md) Wzorce wyniesione z kilkuset standardowych plików `*.dbinit.xml` platformy: nagłówek i piętra `priority`, strukturalne GUID-y, trzy formy referencji (`GUID`, `Tabela:GUID`, `id` z pliku), patch rekordu w kolejnej wersji (`updateonly`), `insertonly`, `key`, `duplicate`/ `duplicateKeyField`, semantyka pustych elementów, kod C#/HTML/XML w treści pola. Szkielety dla typowych obiektów: słowniki, definicje dokumentów i zadań, cechy, szablony e-mail, konfiguracja (`CfgNode`), role systemowe i prawa (`Right`), projekty runtime, kokpity, tuple. Pliki w [examples/](examples/): `dbinit-slownik-i-poprawki.dbinit.xml`, `import-rola-i-prawa.xml`, `import-cecha-i-szablon-email.xml`, `import-definicja-elementu-wynagrodzenia.xml` (kreator algorytmu i edytor z kodem C#; parametry algorytmu → [/soneta:place-def-elementow](../place-def-elementow/SKILL.md)). ### Mechanizm zasilania bazy Demo — [references/demo-data.md](references/demo-data.md) Jak działa import danych przykładowych przy tworzeniu bazy (`dbmgr create --demo gold|silver`, kreator baz): katalog `Demo` obok binariów (bez manifestu, nierekurencyjnie), kolejność plików przez sortowanie leksykograficzne (prefiksy numeryczne stałej szerokości, referencje tylko „w przód"), sufiksy koloru licencji `.gold`/`.silver`, GUID-y wstawiane 1:1, rekordy standardowe (dbinit) przed danymi demo. Z checklistą nowego pliku demo i sposobami testowania (podwójny `importxml` / pełne `create --demo`). ### `scan-folders` — [references/scan-folders.md](references/scan-folders.md) Buduje drzewo **folderów statycznych menu** programu z atrybutów assembly `[assembly: FolderView(...)]` (oraz pochodnych) w skompilowanych bibliotekach. Klasyfikuje węzły na listy (`ViewInfoType`/`ViewType`/`TableName`), formularze (`ObjectType`) i menu; przy widokach pokazuje `Description` oraz powiązaną tabelę/`ViewInfo`. Filtr prefiksem ścieżki i tryb `--flat`. Czyta metadane przez Roslyn — bez uruchamiania aplikacji i bez ładowania IL do CLR. Skrypt: [scripts/scan-folders.csx](scripts/scan-folders.csx). Perspektywa **funkcjonalno-użytkowa** (co użytkownik klika w menu) — komplementarna do perspektywy **danych** (`scan-modules`) i **pól** (`scan-props`) ze skilla [/soneta:programming](../programming/SKILL.md). Planistyczne użycie inwentaryzacji opisuje [/soneta:addon-planning](../addon-planning/SKILL.md). ### Konfiguracja uruchomieniowa `appsettings.json` — [references/appsettings.md](references/appsettings.md) Ustawienia uruchomieniowe komponentów (orchestrator, server, web, webapi, webwcf, router, commhub): **dwa pliki** `appsettings.json` (część back-end i część front-end) i które komponenty obsługują, mapa domyślnych **portów** oraz **trzy pary adresów, które muszą się zgadzać** (`Server:Urls`↔`ServerEndpoint`, `Router:Urls`↔`RouterEndpoint`, `CommHub:Urls`↔`CommHubClient`), **kolejność warstw nadpisań** (plik bazowy → profil systemu → nakładka `-c` → zmienne `SONETA_` → argumenty CLI) — źródło najczęstszej pułapki „zmieniłem `appsettings.json`, a nic się nie zmieniło" — dwa tryby połączenia frontend→serwer (bezpośredni vs przez router) oraz słownik znaczeń kluczy. Zawiera checklistę zmiany portu/adresu. Uruchamianie komponentów, ramki hostującej i zarządzanie bazami opisuje [/soneta:tools](../tools/SKILL.md). ### Rejestr konfiguracji (ConfigReg) — [references/config-reg.md](references/config-reg.md) Zrzut **całej konfiguracji bazy** do jednego drzewa zapisywanego jako `*.reg.json`, który da się porównać z inną bazą, scalić i wgrać z powrotem (menu **Narzędzia → Zarządzanie konfiguracją**). Artykuł opisuje pięć operacji formularza, strukturę drzewa (moduły → `Config` i tabele konfiguracyjne, `Addins`, `Storage` z mapą folderów magazynu plików i sufiksami kontekstów), pola wyłączone z rejestru (m.in. wrażliwe), format pliku wraz z sigilami (`$strict`, `$v`, `#klucz`, `@atrybut`, `$blob`), składnię ścieżek węzłów, semantykę kolekcji `$strict` (**usuwa** wiersze nieobecne w pliku) oraz diagnostykę najczęstszej pułapki — wiersza pokazywanego jednocześnie jako usunięty i dodany. Zawiera dwie checklisty: przeniesienie ustawień między bazami i kroki przed scaleniem do bazy operacyjnej. **Nie myl dwóch mechanizmów przenoszenia ustawień.** XML (`<session>`, `*.dbinit.xml`) przenosi *wskazane rekordy* i nie wykrywa różnic. Rejestr zdejmuje *stan konfiguracji jako całość*, porównuje i scala. Formaty plików są rozłączne — kryterium wyboru i porównanie w tabeli na początku artykułu. ## Powiązania - [/soneta:programming](../programming/SKILL.md) — warstwa kodu importu/eksportu (*sessionreader-sessionwriter*), rekordy guidowane (*datapack-guidedrow*), `OnImporting`/ `OnImported` (*row-types*), testy z `ImportBusinessXml` (*integration-tests*), skany DLL (`scan-modules`, `scan-props`, `scan-workers`) oraz pisanie folderów/list w C#. - [/soneta:addon-planning](../addon-planning/SKILL.md) — użycie inwentaryzacji menu na etapie planowania dodatku. - [/soneta:tools](../tools/SKILL.md) — operacje na bazie z CLI, weryfikacja efektów importu na żywej aplikacji (buscall). - [/soneta:business-xml](../business-xml/SKILL.md) — definicja tabel i kolumn, w tym oznaczanie tabeli jako konfiguracyjnej, co decyduje o jej obecności w rejestrze konfiguracji. - [/soneta:erp](../erp/SKILL.md) — mapa wyboru skilla.
Files in this package (18)
- SKILL.md 13 KB
- examples/aktualizacja-historyczna-stawka.xml 2 KB
- examples/dbinit-slownik-i-poprawki.dbinit.xml 3 KB
- examples/import-cecha-i-szablon-email.xml 2 KB
- examples/import-definicja-elementu-wynagrodzenia.xml 8 KB
- examples/import-pracownik-etatowy.xml 5 KB
- examples/import-rola-i-prawa.xml 2 KB
- references/appsettings.md 14 KB
- references/config-reg.md 21 KB
- references/demo-data.md 5 KB
- references/export-excel.md 15 KB
- references/export-xml.md 6 KB
- references/import-excel.md 25 KB
- references/import-xml-examples.md 25 KB
- references/import-xml.md 34 KB
- references/mcp-import-export.md 7 KB
- references/scan-folders.md 8 KB
- scripts/scan-folders.csx 12 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · soneta/soneta-erp-skills | 100 | MIT |
| kubb-labs/kubb | 100 | MIT |
| colonyops/hive | 100 | MIT |
| vinnie357/claude-skills | 100 | MIT |
| tab/fuku | 100 | MIT |
| florianbuetow/claude-code | 100 | MIT |
| patforna/auto-task | 100 | MIT |
| mariozzj/cc-notify-hooks | 96 | MIT |
| finom/vovk | 95 | MIT |
Database snapshot: 13.11.2026 · package version 00ffab5958b5 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 86erp
Mapa i przewodnik po skillach platformy Soneta (enova365, Triva): soneta:programming (ORM, kod biznesowy), soneta:addon-planning, soneta:business-xml, soneta:form-xml, soneta:repx (wydruki .repx), soneta:place-def-elementow, soneta:config (import/eksport XML, scan-folders,… - 100tools
Narzędzia deweloperskie wiersza poleceń (CLI) platformy Soneta (enova365, Triva) — dla partnerów i zespołu Soneta (repozytorium źródłowe programu). Używaj gdy użytkownik: (1) zarządza bazami przez `dbmgr` — tworzy, rejestruje, konwertuje, backup/restore, licencje, rozszerzenia,… - 100migrate-content-appsettings
Generates appsettings.json for the Kentico Migration Tool CLI. Use when configuring migration settings, ConvertClassesToContentHub, EntityConfigurations, FieldMigrations, or QuerySourceInstanceApi.