Skip to content
Skills Library
Programming · Tool integration

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

Licence
MIT
Last repository change
13.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
18
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 13.10.2026, without references to retired models or APIs.

Licence

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

trueZarządzanie konfiguracją
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

  1. Kiedy ten skill, a kiedy inny
  2. Artykuły i narzędzia
  3. Powiązania
Original SKILL.md headings · 164 lines, 1,241 words
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

RepositoryScoreLicence
This page · soneta/soneta-erp-skills100MIT
kubb-labs/kubb100MIT
colonyops/hive100MIT
vinnie357/claude-skills100MIT
tab/fuku100MIT
florianbuetow/claude-code100MIT
patforna/auto-task100MIT
mariozzj/cc-notify-hooks96MIT
finom/vovk95MIT

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.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.