soneta-form-xml.skill

2026-01-12 10:49:17 +01:00
parent 64a8868797
commit 3f5d9a795e
6 changed files with 2818 additions and 0 deletions
@@ -0,0 +1,734 @@
+---
+name: soneta-form-xml
+description: Tworzenie plików form.xml opisujących formularze, zakładki i widoki UI dla platformy enova365/Soneta Enterprise. Używaj gdy użytkownik prosi o utworzenie zakładki formularza (pageform.xml), widoku listy (viewform.xml), formularza (form.xml), lookupu (lookupform.xml), lub gdy pyta o strukturę i składnię plików form.xml dla enova365.
+---
+
+# Soneta Form XML - Formularze UI
+
+Skill do tworzenia plików XML definiujących interfejs użytkownika w systemie enova365/Soneta Enterprise.
+
+## Typy plików formularzy
+
+| Typ pliku | Wzorzec nazwy | Przeznaczenie |
+|-----------|---------------|---------------|
+| **pageform.xml** | `{DataType}.{PageName}.pageform.xml` | Zakładka formularza edycji obiektu |
+| **viewform.xml** | `{NazwaWidoku}.viewform.xml` | Widok listy zarejestrowanej jako folder (listy główne) |
+| **gridform.xml** | `{IdentyfikatorListy}.gridform.xml` | Indywidualne ustawienia listy na formularzu |
+| **lookupform.xml** | `{NazwaPodpowiedzi}.lookupform.xml` | Lista wyboru (lookup) |
+| **form.xml** | `{Nazwa}.form.xml` | Współdzielony fragment UI (include) |
+
+### Format nazwy pageform.xml
+
+Nazwa pliku składa się z 4 części rozdzielonych kropkami:
+
+```
+{DataType}.{PageName}.pageform.xml
+```
+
+- **DataType** - typ danych, dla którego definiowana jest zakładka (np. `Towar`, `Kontrahent`, `DokumentHandlowy`)
+- **PageName** - nazwa zakładki (np. `Ogolne`, `Dodatkowe`, `Adresy`)
+- **pageform.xml** - stały sufiks
+
+**Przykłady:**
+- `Towar.Ogolne.pageform.xml`
+- `Towar.Dodatkowe.pageform.xml`
+- `Kontrahent.Adresy.pageform.xml`
+- `DokumentHandlowy.Pozycje.pageform.xml`
+
+### Format nazwy viewform.xml
+
+Nazwa pliku składa się z 3 części rozdzielonych kropkami:
+
+```
+{NazwaWidoku}.viewform.xml
+```
+
+**Przykłady:**
+- `Towary.viewform.xml`
+- `Kontrahenci.viewform.xml`
+- `DokumentyHandlowe.viewform.xml`
+
+### Format nazwy gridform.xml
+
+Nazwa pliku składa się z 3 części rozdzielonych kropkami:
+
+```
+{IdentyfikatorListy}.gridform.xml
+```
+
+**Przykłady:**
+- `PozycjeDokumentu.gridform.xml`
+- `RachunkiBankowe.gridform.xml`
+
+### Format nazwy lookupform.xml
+
+Nazwa pliku składa się z 3 części rozdzielonych kropkami:
+
+```
+{NazwaPodpowiedzi}.lookupform.xml
+```
+
+**Przykłady:**
+- `Towary.lookupform.xml`
+- `Kontrahenci.lookupform.xml`
+
+## Hierarchia elementów XML
+
+Elementy XML dzielą się na trzy grupy dziedziczące po `uiElement`:
+
+1. **Elementy proste** - Field, Label, Command, Gap, Html, GroupBy, Axis
+2. **Kontenery elementów** - Group, Stack, Row, Flow, Bar, Dashboard, Include, Page (dziedziczą po `ContainerElement`)
+3. **Kolekcje** - Grid, Cards, Scheduler, Chart, Diagram, Pivot (dziedziczą po `CollectionElement`)
+
+## Struktura dokumentu
+
+Każdy plik formularza zaczyna się od deklaracji XML i elementu głównego `DataForm`:
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<DataForm xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+          xmlns:xsd="http://www.w3.org/2001/XMLSchema"
+          xmlns="http://www.enova.pl/schema/form.xsd"
+          xsi:schemaLocation="http://www.enova.pl/schema/ http://www.enova.pl/schema/form.xsd">
+  <!-- zawartość -->
+</DataForm>
+```
+
+### Atrybuty DataForm
+
+| Atrybut | Opis |
+|---------|------|
+| `Priority` | Kolejność zakładek (domyślnie 100, niższa = wcześniej) |
+| `RightName` | Opcjonalny. Nazwa uprawnienia do zakładki (tylko gdy inna niż standardowa) |
+| `Contexts` | Warunki licencyjne, np. `"Licence.HAN \| Licence.FA"` (nie bindowane) |
+| `ViewType` | Typ widoku: `None`, `Dialog`, `Form`, `Folder` |
+| `Mode` | Tryb: `None`, `Form`, `Folder`, `Wizard`, `Modal`, `Popup`, `Frame` |
+| `DataType` | Opcjonalny. Pełne określenie typu danych (wymagany tylko gdy nazwa pliku nie określa jednoznacznie typu), np. `"Soneta.Handel.DokumentHandlowy,Soneta.Handel"` |
+
+## Wspólne atrybuty elementów
+
+Następujące atrybuty mogą być użyte w **dowolnym** elemencie form.xml:
+
+| Atrybut | Opis |
+|---------|------|
+| `Name` | Identyfikator elementu, który można wykorzystać w kodzie C# |
+| `Class` | Klasy stylów (lista wartości oddzielonych spacją) |
+| `DataContext` | Zmienia kontekst danych dla elementu i wszystkich jego elementów podrzędnych |
+| `Visibility` | Warunek widoczności (bindowalne z logiką biznesową) |
+| `Renderable` | Czy element ma być dostępny. Wyrażenie liczone **raz** przy logowaniu operatora - optymalne dla warunków zależnych od środowiska, licencji i innych parametrów niezmiennych w trakcie sesji |
+
+### Atrybut CaptionHtml
+
+Atrybut `CaptionHtml` występuje w elementach: `Label`, `Field`, `Group`, `Page`, `Command` i innych.
+
+Może zawierać:
+- Tekst etykiety (w formacie HTML)
+- Wyrażenia bindowane w klamrach: `{wyrażenie}` - wartość tekstowa jest automatycznie kodowana do HTML
+- Wyrażenia zwracające kod HTML: `{WłaściwośćHtml}` - nazwa musi mieć sufiks `Html`, wtedy wartość nie jest kodowana
+- Podwójne klamry dla literalnych znaków: `{{` → `{`, `}}` → `}`
+
+**Specjalne przypadki w `Field`:**
+- Brak atrybutu → automatyczna etykieta wyliczana na podstawie danych
+- `CaptionHtml=" "` (spacja) → pusta etykieta (miejsce na etykietę zostaje zachowane)
+- `CaptionHtml=""` (pusty) → brak etykiety (pole bez miejsca na etykietę)
+
+**Alternatywa:** Zamiast `CaptionHtml` można użyć `CaptionMarkdown` dla etykiet w formacie Markdown.
+
+## Elementy kontenerowe
+
+### Page - Zakładka
+
+Główny kontener dla zawartości zakładki:
+
+```xml
+<Page CaptionHtml="Ogólne" DataContext="{DataSource}">
+  <!-- zawartość zakładki -->
+</Page>
+```
+
+| Atrybut | Opis |
+|---------|------|
+| `Name` | Opcjonalny. Unikalny identyfikator zakładki |
+| `CaptionHtml` | Tytuł zakładki. Może zawierać `/` do grupowania zakładek (np. `"Dokumenty/Faktury"`) |
+| `DataContext` | Źródło danych. `{DataSource}` oznacza obiekt edytowany na zakładce, ale można wskazać inne dane |
+| `Visibility` | Wyrażenie warunkowe widoczności (bindowalne) |
+| `Renderable` | Czy zakładka ma być dostępna. Wyrażenie liczone raz przy logowaniu - optymalne dla warunków zależnych od środowiska, licencji itp. |
+| `Key` | Skrót klawiaturowy wywołujący zakładkę formularza |
+| `GroupIcon` | Ikona grupy zakładek |
+
+### Zasada budowania zakładki formularza
+
+Zakładka składa się z elementów `<Group>`. Każda grupa może zawierać:
+
+1. **Listę pól w kolumnie** - pola ułożone pionowo jedno pod drugim
+2. **Układ wielokolumnowy** - `<Row>` zawierający kilka `<Stack>` z polami
+3. **Listę elementów podrzędnych** - np. Grid, ewentualnie poprzedzony polami filtrującymi
+
+```xml
+<Page CaptionHtml="Ogólne" DataContext="{DataSource}">
+  <!-- Grupa z polami w jednej kolumnie -->
+  <Group CaptionHtml="Dane podstawowe">
+    <Field CaptionHtml="Kod" Width="20" EditValue="{Kod}" />
+    <Field CaptionHtml="Nazwa" Width="*" EditValue="{Nazwa}" />
+  </Group>
+  
+  <!-- Grupa z układem dwukolumnowym -->
+  <Group CaptionHtml="Dane szczegółowe">
+    <Row>
+      <Stack>
+        <Field CaptionHtml="Data" Width="15" EditValue="{Data}" />
+        <Field CaptionHtml="Status" Width="15" EditValue="{Status}" />
+      </Stack>
+      <Stack>
+        <Field CaptionHtml="Typ" Width="15" EditValue="{Typ}" />
+        <Field CaptionHtml="Źródło" Width="15" EditValue="{Zrodlo}" />
+      </Stack>
+    </Row>
+  </Group>
+  
+  <!-- Grupa z listą -->
+  <Group CaptionHtml="Pozycje">
+    <Grid Width="*" Height="*" EditValue="{Pozycje}">
+      <Field CaptionHtml="Nazwa" Width="*" EditValue="{Nazwa}" />
+    </Grid>
+  </Group>
+</Page>
+```
+
+### Group - Grupa pól
+
+Wizualna ramka grupująca powiązane pola:
+
+```xml
+<Group CaptionHtml="Dane podstawowe">
+  <Field CaptionHtml="Kod" Width="20" EditValue="{Kod}" />
+  <Field CaptionHtml="Nazwa" Width="*" EditValue="{Nazwa}" />
+</Group>
+```
+
+| Atrybut | Opis |
+|---------|------|
+| `CaptionHtml` | Tytuł grupy |
+| `LabelWidth` | Opcjonalny. Szerokość etykiet dla wszystkich pól w kontenerze |
+| `Visibility` | Warunek widoczności (bindowalne z logiką biznesową) |
+| `Renderable` | Czy grupa ma być dostępna (liczone raz przy logowaniu) |
+
+### Stack - Układ pionowy
+
+Układa elementy jeden pod drugim:
+
+```xml
+<Stack LabelWidth="15">
+  <Field CaptionHtml="Pole 1" EditValue="{Pole1}" />
+  <Field CaptionHtml="Pole 2" EditValue="{Pole2}" />
+</Stack>
+```
+
+### Row - Układ poziomy
+
+Układa elementy obok siebie w wierszu:
+
+```xml
+<Row>
+  <Field CaptionHtml="Kod" Width="20" EditValue="{Kod}" />
+  <Field CaptionHtml="Typ" Width="15" EditValue="{Typ}" />
+</Row>
+```
+
+**Pole na całą szerokość:** użyj `Width="*"`
+
+**Pola dosunięte do prawej:** umieść `<Gap Width="*"/>` na początku:
+
+```xml
+<Row>
+  <Gap Width="*" />
+  <Field CaptionHtml="Kod" Width="20" EditValue="{Kod}" />
+  <Field CaptionHtml="Typ" Width="15" EditValue="{Typ}" />
+</Row>
+```
+
+### Flow - Układ płynny
+
+Elementy umieszczane są od lewej do prawej. Gdy nie mieszczą się na formularzu, przenoszone są do nowego wiersza:
+
+```xml
+<Flow Align="true">
+  <Field CaptionHtml="Data od" Width="15" EditValue="{DataOd}" />
+  <Field CaptionHtml="Data do" Width="15" EditValue="{DataDo}" />
+  <Field CaptionHtml="Status" Width="12" EditValue="{Status}" />
+</Flow>
+```
+
+## Elementy pól i kontrolek
+
+### Field - Pole edycyjne
+
+Podstawowy element do wyświetlania i edycji danych. Jest generowany **dynamicznie** - w zależności od typu właściwości wyświetla odpowiednią kontrolkę (int → pole numeryczne, bool → checkbox, double → pole z kalkulatorem, typ Sonety → lookup z listą wyboru).
+
+Minimalny `<Field>` powinien zawierać:
+- `EditValue` - **wymagany**, binding do właściwości
+- `CaptionHtml` - etykieta pola  
+- `Width` - szerokość pola
+
+```xml
+<Field CaptionHtml="Nazwa pola" Width="20" EditValue="{Właściwość}" />
+```
+
+| Atrybut | Opis |
+|---------|------|
+| `EditValue` | **Wymagany**. Binding do właściwości: `{Właściwość}` lub `{new Extender.Właściwość}` |
+| `CaptionHtml` | Etykieta pola (patrz sekcja "Atrybut CaptionHtml") |
+| `Width` | Szerokość pola w znakach lub px (`*` = wypełnij) |
+| `OuterWidth` | Całkowita szerokość z etykietą (do wyrównywania w pionie) |
+| `LabelWidth` | Szerokość etykiety |
+| `Height` | Wysokość w wierszach lub px (dla pól wieloliniowych) |
+| `IsReadOnly` | Warunek tylko do odczytu (bindowalne z logiką biznesową). Logika biznesowa ma wyższy priorytet |
+| `Visibility` | Warunek widoczności (bindowalne z logiką biznesową): `true`/`false`/`Visible`/`Hidden`/`Collapsed` |
+| `Renderable` | Czy pole ma być dostępne (liczone raz przy logowaniu) |
+| `Format` | Formatowanie wartości w standardzie .NET `string.Format`. Pole `{0}` to wartość edytowana |
+| `Footer` | Agregacja w stopce **tylko na listach**: `Sum`, `Count`, `Average`, `Min`, `Max` |
+| `CheckedValue` | Wartość dla **RadioButton** |
+| `Class` | Klasy stylów (patrz sekcja Class) |
+| `DataContext` | Zmienia kontekst danych dla tego pola i elementów podrzędnych |
+
+#### RadioButton
+
+Aby utworzyć RadioButton, dodaj parametr `CheckedValue`:
+
+```xml
+<Field Width="20" CaptionHtml="Towar" EditValue="{Typ}" CheckedValue="Towar" />
+<Field Width="20" CaptionHtml="Usługa" EditValue="{Typ}" CheckedValue="Usługa" />
+<Field Width="20" CaptionHtml="Receptura" EditValue="{Typ}" CheckedValue="Receptura" />
+```
+
+Pola z tym samym `EditValue` i różnymi `CheckedValue` tworzą grupę RadioButton.
+
+### Label - Etykieta
+
+Tekst bez możliwości edycji:
+
+```xml
+<Label CaptionHtml="Tekst informacyjny" Width="30" />
+```
+
+### Gap - Odstęp
+
+Wypełniacz przestrzeni. Użyteczny do dosunięcia elementów do prawej strony (gdy `<Gap Width="*" />` jest na początku wiersza).
+
+```xml
+<Row>
+  <Gap Width="*" />
+  <Field CaptionHtml="Kod" Width="20" EditValue="{Kod}" />
+</Row>
+```
+
+**Uwaga:** `<Gap Width="*" />` jako ostatni element w wierszu nie jest potrzebny - nic nie zmienia.
+
+### Command - Przycisk/Polecenie
+
+```xml
+<Command CaptionHtml="Zapisz" 
+         MethodName="Zapisz" 
+         DataContext="{new MojExtender}"
+         Visibility="{IsVisibleButton}" />
+```
+
+| Atrybut | Opis |
+|---------|------|
+| `MethodName` | Nazwa metody do wywołania (szukana w klasie z kontekstu formularza) |
+| `MoreMethodName` | Dodatkowa metoda (dla przycisków dzielonych - wersja przeglądowa) |
+| `Key` | Skrót klawiszowy |
+| `CommandStyle` | Styl: `Default`, `Important`, `Red`, `Green`, `Blue` |
+| `Icon` | Nazwa ikony (nie działa w enova365 desktop) |
+| `Class` | Klasy stylów |
+| `DataContext` | Zmienia kontekst danych (np. `{new MojExtender}` - patrz sekcja Bindowanie danych) |
+| `Renderable` | Czy przycisk ma być dostępny (liczone raz przy logowaniu) |
+
+### Include - Dołączenie fragmentu
+
+Wstawia zawartość innego pliku form.xml lub dynamicznie generowany element UI:
+
+```xml
+<!-- Statyczne dołączenie pliku -->
+<Include Source="Adres.form.xml" />
+
+<!-- Z kontekstem danych -->
+<Include Source="Adres.form.xml" DataContext="{AdresKorespondencyjny}" />
+
+<!-- Dynamiczny element z kodu C# -->
+<Include Source="{DynamicznyFormularz}" />
+```
+
+| Atrybut | Opis |
+|---------|------|
+| `Source` | Nazwa pliku form.xml **lub** wyrażenie bindujące zwracające element DOM (`UIElement`) z kodu. Wyrażenie bindujące jest wywoływane po każdej zmianie danych, co pozwala budować dynamiczne formularze |
+| `DataContext` | Opcjonalny. Kontekst danych dla dołączanego fragmentu |
+| `Path` | Opcjonalny. Określa element pliku form.xml, który zostanie wstawiony (gdy Source jest nazwą pliku) |
+| `Suffix` | Opcjonalny. Napis dodawany do każdej nazwy (`Name`) elementów dołączonych przez Include |
+
+## Kolekcje i listy
+
+### Grid / List - Tabela danych
+
+```xml
+<Grid Width="*" Height="*" 
+      EditValue="{Pozycje}" 
+      SelectedValue="{WybranePozycje}"
+      FocusedValue="{AktualnaPozycja}"
+      IsToolbarVisible="true"
+      EditInPlace="true"
+      NewInPlace="true"
+      OrderBy="Data desc"
+      SumType="All"
+      OpenMethodName="OtworzFormularz"
+      IsSmartOpen="true">
+  <Field CaptionHtml="Kod" Width="15" EditValue="{Kod}" />
+  <Field CaptionHtml="Nazwa" Width="30" EditValue="{Nazwa}" />
+  <Field CaptionHtml="Ilość" Width="10" EditValue="{Ilość}" Footer="Sum" />
+  <GroupBy EditValue="{Kategoria}" IsDescending="false" />
+</Grid>
+```
+
+| Atrybut | Opis | Default |
+|---------|------|---------|
+| `EditValue` | Źródło danych kolekcji | - |
+| `SelectedValue` | Binding do zaznaczonych wierszy - typ `DataType[]` (tablica) | - |
+| `FocusedValue` | Binding do podświetlonego wiersza - typ `DataType` (obiekt) | - |
+| `IsToolbarVisible` | Pokazuj pasek narzędzi | `false` |
+| `IsFilterRowVisible` | Pokazuj wiersz filtrujący | `false` |
+| `IsHeaderVisible` | Widoczność nagłówków z tytułami kolumn | `true` |
+| `EditInPlace` | Edycja bezpośrednio w komórkach | `false` |
+| `NewInPlace` | Dodawanie przez kliknięcie pustego wiersza | `false` |
+| `AlwaysAddNewRow` | Nowy wiersz od razu dodawany (Esc nie usuwa) | `false` |
+| `PreventNewRowOnFocus` | Zapobiegaj nowemu wierszowi przy fokusie | `false` |
+| `KeepsSequence` | Czy po edycji in-place zachować kolejność wierszy (`true`) czy ponownie sortować (`false`) | `false` |
+| `OpenMethodName` | Metoda wywoływana po Enter/double-click (domyślnie otwarcie formularza) | - |
+| `IsSmartOpen` | Kolumna ze strzałką do otwarcia formularza | - |
+| `NewButton` | Stan przycisku Nowy: `Auto`, `None`, `Visible` | auto |
+| `EditButton` | Stan przycisku Otwórz | auto |
+| `UpdateButton` | Stan przycisku Aktualizuj | auto |
+| `RemoveButton` | Stan przycisku Usuń | auto |
+| `SearchButton` | Stan przycisku Szukaj | auto |
+| `MoreButton` | Przycisk więcej: `None`, `Visible`, `Actions` | auto |
+| `OrderBy` | Domyślne sortowanie (np. `"Kolumna desc"`) | - |
+| `Filter` | Filtr danych | - |
+| `ResourceName` | Nazwa pliku grid.xml z indywidualnymi ustawieniami | - |
+| `SumType` | Typ sum: `None`, `Selected`, `All`, `Groups`, `GroupsNewLine` | `None` |
+| `ActionsMode` | Czy workery przypięte do listy mają być w menu Czynności formularza: `FormAndControl`, `Control`, `Form` | - |
+
+#### Atrybuty dla drzewa (Tree)
+
+| Atrybut | Opis | Default |
+|---------|------|---------|
+| `TreeNodesValue` | Binding do węzłów | - |
+| `TreeHasNodesValue` | Binding sprawdzający czy ma węzły | - |
+| `TreeParentValue` | Binding do rodzica | - |
+| `TreeExpandingLevel` | Poziom rozwinięcia: `Collapsed`, `ExpandRoot`, `ExpandRootFix`, `ExpandAll` | `Collapsed` |
+
+### GroupBy - Grupowanie w Grid
+
+```xml
+<Grid EditValue="{Pozycje}">
+  <GroupBy EditValue="{Kategoria}" />
+  <Field CaptionHtml="Nazwa" EditValue="{Nazwa}" />
+</Grid>
+```
+
+## Elementy specjalne
+
+### Chart - Wykres
+
+```xml
+<Chart EditValue="{DaneWykresu}" 
+       Type="Bar" 
+       ChartColor="Blue"
+       IsLegendVisible="true">
+  <Field CaptionHtml="Miesiąc" EditValue="{Miesiac}" />
+  <Field CaptionHtml="Wartość" EditValue="{Wartosc}" />
+  <Axis Direction="X" EditValue="{Miesiac}" />
+  <Axis Direction="Y" EditValue="{Wartosc}" />
+</Chart>
+```
+
+Typy wykresów: `Line`, `Bar`, `Pie`, `Donut`, `Spider`, `Polar`, `Area`, `Pyramid`, `Funnel`, `Bubble`, `Scatter`
+
+### Scheduler - Kalendarz
+
+```xml
+<Scheduler EditValue="{Zdarzenia}" 
+           View="Weekly"
+           SelectedInterval="{WybranyOkres}">
+  <Field CaptionHtml="Tytuł" EditValue="{Tytul}" />
+  <Field CaptionHtml="Początek" EditValue="{DataOd}" />
+  <Field CaptionHtml="Koniec" EditValue="{DataDo}" />
+</Scheduler>
+```
+
+### Gantt / GanttDiagram - Harmonogram
+
+```xml
+<Gantt EditValue="{Zadania}" ViewType="WeekDay">
+  <Field CaptionHtml="Zadanie" EditValue="{Nazwa}" />
+  <Field CaptionHtml="Początek" EditValue="{Start}" />
+  <Field CaptionHtml="Koniec" EditValue="{Finish}" />
+</Gantt>
+```
+
+### Html / Markdown - Treść formatowana
+
+```xml
+<Html EditValue="{TrescHtml}" Width="*" Height="200" />
+<Markdown EditValue="{TrescMarkdown}" Width="*" />
+```
+
+### Indicator - Wskaźnik
+
+```xml
+<Indicator CaptionHtml="Sprzedaż" 
+           EditValue="{WartoscSprzedazy}" 
+           UnitSymbol="PLN" />
+```
+
+### Dashboard - Panel kafelkowy
+
+```xml
+<Dashboard>
+  <Group Class="DashboardItem" CaptionHtml="Sprzedaż">
+    <Indicator EditValue="{Sprzedaz}" />
+  </Group>
+</Dashboard>
+```
+
+## Bindowanie danych
+
+Każdy element form.xml znajduje się w odpowiednim kontekście powiązanego obiektu C#. Powiązany typ danych zależy od typu danych dla którego zdefiniowany jest pageform.xml.
+
+### Powiązanie typu z formularzem
+
+Powiązanie z typem w elemencie root odbywa się przez:
+
+1. **Przez nazwę pliku pageform.xml** - pierwszy człon nazwy pliku (DataType) określa typ obiektu. Np. dla pliku `Towar.Ogolne.pageform.xml` kontekstem jest klasa `Towar`.
+
+2. **Przez atrybut DataType w DataForm** - jawne określenie typu:
+   ```xml
+   <DataForm DataType="Soneta.Handel.Towar,Soneta.Handel">
+   ```
+
+3. **Przez rejestrację FolderViewAttribute** - wiążącą folder programu z obiektem biznesowym i formularzem prezentującym ten folder.
+
+### Zmiana kontekstu danych
+
+- **DataContext** - zmienia kontekst **aktualnego elementu i wszystkich elementów podrzędnych**:
+  ```xml
+  <Group DataContext="{Adres}">
+    <!-- wszystkie pola wewnątrz odwołują się do właściwości obiektu Adres -->
+    <Field CaptionHtml="Miasto" EditValue="{Miasto}" />
+  </Group>
+  ```
+
+- **EditValue** - zmienia kontekst **tylko elementów podrzędnych** (bez aktualnego kontenera):
+  ```xml
+  <Grid EditValue="{Pozycje}">
+    <!-- pola wewnątrz odwołują się do właściwości elementu kolekcji Pozycje -->
+    <Field CaptionHtml="Nazwa" EditValue="{Nazwa}" />
+  </Grid>
+  ```
+
+### Składnia wyrażeń w klamrach
+
+W wyrażeniach `{...}` można odwoływać się do:
+
+| Składnia | Opis |
+|----------|------|
+| `{Właściwość}` | Publiczna właściwość obiektu w kontekście |
+| `{Metoda()}` | Wartość zwracana przez publiczną metodę. Parametry metody są uzupełniane automatycznie na podstawie aktualnego kontekstu UI (`Soneta.Business.Context`) |
+| `{Obiekt.Właściwość}` | Właściwość zagnieżdżona |
+| `{Context.TypDanych.Pole}` | Wartość z aktualnego kontekstu UI (`Soneta.Business.Context`) |
+| `{Features.NazwaCechy}` | Cechy powiązane z obiektem biznesowym `Row` |
+| `{Workers.NazwaWorkera.Pole}` | Właściwość workera powiązanego z obiektem (`WorkerAttribute`) |
+| `{new NazwaExtender.Pole}` | Właściwość extendera (worker niepowiązany z konkretnymi danymi) |
+| `{Tablica[indeks]}` | Element tablicy pod wskazanym indeksem |
+| `{.}` | Aktualna wartość w kontekście elementu |
+
+### Wyrażenia porównań
+
+| Składnia | Opis |
+|----------|------|
+| `{Pole=wartość}` | Porównanie równości |
+| `{Pole!=wartość}` | Porównanie nierówności |
+| `{!PoleLogiczne}` | Negacja wartości logicznej |
+| `{?warunek}` | Warunek oparty o klasę `RowCondition` |
+
+### Przykłady bindingów
+
+```xml
+<!-- Proste właściwości -->
+<Field CaptionHtml="Kod" EditValue="{Kod}" />
+<Field CaptionHtml="Nazwa kontrahenta" EditValue="{Kontrahent.Nazwa}" />
+
+<!-- Właściwości workerów -->
+<Field CaptionHtml="Saldo" EditValue="{Workers.SaldoWorker.SaldoOgolem}" />
+
+<!-- Extendery (obiekty tworzone dynamicznie) -->
+<Field EditValue="{new MojExtender.Właściwość}" />
+<Command MethodName="Wykonaj" DataContext="{new MojExtender}" />
+
+<!-- Cechy -->
+<Field CaptionHtml="Cecha" EditValue="{Features.MojaCecha}" />
+
+<!-- Kontekst UI -->
+<Field EditValue="{Context.Operator.Nazwa}" IsReadOnly="true" />
+
+<!-- Aktualna wartość -->
+<Field EditValue="{.}" />
+```
+
+### Wyrażenia warunkowe (RowCondition)
+
+```xml
+Visibility="{?State=Added}"              <!-- stan obiektu -->
+Visibility="{?!State=Added}"             <!-- negacja -->
+Visibility="{?Typ=Towar or Typ=Usługa}"  <!-- OR -->
+Visibility="{?Aktywny and Widoczny}"     <!-- AND -->
+```
+
+## Atrybut Class - Style i zachowania
+
+Atrybut `Class` może zawierać wiele wartości oddzielonych spacją:
+
+```xml
+<Field Class="BoldLabel LeftAlign ImageEdit" ... />
+```
+
+### Style etykiet
+- `BoldLabel` - pogrubiona etykieta
+- `CenterLabel` - wycentrowana
+- `RightLabel` - wyrównana do prawej
+- `MultilineLabel` - wieloliniowa
+- `NoColonLabel` - bez dwukropka
+- `WarningLabel` - ostrzeżenie
+- `InfoLabel` - informacja
+- `TipLabel` - podpowiedź
+
+### Style czcionek
+- `LargeFont` - duża czcionka
+- `BoldFont` - pogrubiona
+- `GreenFont` - zielona
+- `RedFont` - czerwona
+- `WarningFont` - ostrzegawcza
+- `FixedWidthFont` - stała szerokość
+
+### Wyrównanie
+- `LeftAlign`, `RightAlign`, `TextRight`
+
+### Typy edytorów
+- `PasswordEdit` - hasło
+- `ColorEdit` - wybór koloru
+- `RichEdit` - edytor HTML
+- `ImageEdit` - obraz
+- `FileEdit` - wybór pliku
+- `FolderEdit` - wybór folderu
+- `PathPropertyEdit` - ścieżka
+- `HyperlinkEdit` - hiperłącze
+- `EmailEdit` - email
+- `PhoneEdit` - telefon
+- `RatingEdit` - ocena gwiazdkowa
+- `ProgressEdit` - pasek postępu
+- `IconEdit` - ikona
+- `CheckButtonEdit` - checkbox jako przycisk
+- `XmlEdit` - edytor XML
+- `DataTextEdit` - tekst danych
+
+### Zachowania
+- `Collapsable` - zwijalna grupa
+- `Expandable` - rozwijalna
+- `Expanded` - domyślnie rozwinięta
+- `Hidden` - ukryty
+- `FirstResponder` - pole z fokusem zaraz po otwarciu formularza
+- `Scrollable` - przewijalna
+- `ImageCircle` - okrągły obraz
+- `Tree` - drzewo
+
+### Układy i pozycjonowanie
+- `GroupItem` - element umieszczony na wysokości nagłówka `<Group>` (zwykle po prawej stronie), służy do sterowania zawartością pozostałych elementów grupy
+- `Reverse` - układa elementy w odwrotnej kolejności (od prawej do lewej lub od dołu do góry)
+- `SmartOpen` - kolumna w `Grid` wyróżniona do szybkiego otwierania formularza (ze strzałką)
+
+### Przyciski
+- `MainCommand` - główny przycisk
+- `SplitCommand` - przycisk z menu
+- `CommandNoText` - tylko ikona
+- `CommandIcoText` - ikona i tekst
+- `WorkerCommand` - przycisk workera
+- `WizardCommand` - przycisk kreatora
+- `PrintButton` - przycisk drukowania
+
+## Appearance - Warunkowe formatowanie
+
+```xml
+<Field CaptionHtml="Saldo" EditValue="{Saldo}">
+  <Appearance Condition="{?Saldo&lt;0}" ForeColor="Red" FontBold="true" />
+  <Appearance Condition="{?Saldo&gt;1000}" BackColor="LightGreen" />
+</Field>
+```
+
+## Przykłady
+
+### Prosta zakładka (pageform.xml)
+
+Plik: `MojObiekt.Ogolne.pageform.xml`
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<DataForm xmlns="http://www.enova.pl/schema/form.xsd"
+          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+          xmlns:xsd="http://www.w3.org/2001/XMLSchema"
+          xsi:schemaLocation="http://www.enova.pl/schema/ http://www.enova.pl/schema/form.xsd"
+          Priority="10">
+  <Page CaptionHtml="Ogólne" DataContext="{DataSource}">
+    <Group CaptionHtml="Dane podstawowe">
+      <Field CaptionHtml="Kod" Width="20" EditValue="{Kod}" />
+      <Field CaptionHtml="Nazwa" Width="*" EditValue="{Nazwa}" />
+      <Row>
+        <Field CaptionHtml="Data" Width="15" EditValue="{Data}" />
+        <Field CaptionHtml="Status" Width="15" EditValue="{Status}" />
+      </Row>
+    </Group>
+    <Group CaptionHtml="Pozycje">
+      <Grid Width="*" Height="*" EditValue="{Pozycje}" IsToolbarVisible="true">
+        <Field CaptionHtml="Lp" Width="5" EditValue="{Lp}" />
+        <Field CaptionHtml="Opis" Width="*" EditValue="{Opis}" />
+        <Field CaptionHtml="Wartość" Width="15" EditValue="{Wartosc}" Footer="Sum" />
+      </Grid>
+    </Group>
+  </Page>
+</DataForm>
+```
+
+### Współdzielony fragment (form.xml)
+
+Plik: `Adres.form.xml`
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<DataForm xmlns="http://www.enova.pl/schema/form.xsd"
+          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+          xmlns:xsd="http://www.w3.org/2001/XMLSchema"
+          xsi:schemaLocation="http://www.enova.pl/schema/ http://www.enova.pl/schema/form.xsd">
+  <Stack>
+    <Row>
+      <Field CaptionHtml="Ulica" Width="40" EditValue="{Ulica}" />
+      <Field CaptionHtml="Nr domu" Width="10" EditValue="{NrDomu}" />
+    </Row>
+    <Row>
+      <Field CaptionHtml="Kod pocztowy" Width="12" EditValue="{KodPocztowy}" />
+      <Field CaptionHtml="Miasto" Width="*" EditValue="{Miasto}" />
+    </Row>
+  </Stack>
+</DataForm>
+```
+
+## Referencje
+
+- Pełna specyfikacja elementów: [references/ELEMENTS.md](references/ELEMENTS.md)
+- Schemat XSD: [references/Form.xsd](references/Form.xsd)