Files

T

Marcin Wojas 898fd6a98d Optymalizacja soneta-form-xml skill

2026-03-05 15:31:31 +01:00

26 KiB

Raw Blame History

name, description

name	description
soneta-form-xml	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:

Elementy proste - Field, Label, Command, Gap, Html, GroupBy, Axis
Kontenery elementów - Group, Stack, Row, Flow, Bar, Dashboard, Include, Page (dziedziczą po ContainerElement)
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 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:

<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ć:

Listę pól w kolumnie - pola ułożone pionowo jedno pod drugim
Układ wielokolumnowy - <Row> zawierający kilka <Stack> z polami
Listę elementów podrzędnych - np. Grid, ewentualnie poprzedzony polami filtrującymi

<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:

<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:

<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:

<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:

<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:

<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

<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:

<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:

<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).

<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

<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:

<!-- 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

<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

<Grid EditValue="{Pozycje}">
  <GroupBy EditValue="{Kategoria}" />
  <Field CaptionHtml="Nazwa" EditValue="{Nazwa}" />
</Grid>

Elementy specjalne

Chart - Wykres

<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

<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

<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

<Html EditValue="{TrescHtml}" Width="*" Height="200" />
<Markdown EditValue="{TrescMarkdown}" Width="*" />

Indicator - Wskaźnik

<Indicator CaptionHtml="Sprzedaż" 
           EditValue="{WartoscSprzedazy}" 
           UnitSymbol="PLN" />

Dashboard - Panel kafelkowy

<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:

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.

Przez atrybut DataType w DataForm - jawne określenie typu:

<DataForm DataType="Soneta.Handel.Towar,Soneta.Handel">

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:

<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):

<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

<!-- 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)

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ą:

<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

<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 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 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
Schemat XSD: references/Form.xsd

26 KiB Raw Blame History

Soneta Form XML - Formularze UI

Typy plików formularzy

Format nazwy pageform.xml

Format nazwy viewform.xml

Format nazwy gridform.xml

Format nazwy lookupform.xml

Hierarchia elementów XML

Struktura dokumentu

Atrybuty DataForm

Wspólne atrybuty elementów

Atrybut CaptionHtml

Elementy kontenerowe

Page - Zakładka

Zasada budowania zakładki formularza

Group - Grupa pól

Stack - Układ pionowy

Row - Układ poziomy

Flow - Układ płynny

Elementy pól i kontrolek

Field - Pole edycyjne

RadioButton

Label - Etykieta

Gap - Odstęp

Command - Przycisk/Polecenie

Include - Dołączenie fragmentu

Kolekcje i listy

Grid / List - Tabela danych

Atrybuty dla drzewa (Tree)

GroupBy - Grupowanie w Grid

Elementy specjalne

Chart - Wykres

Scheduler - Kalendarz

Gantt / GanttDiagram - Harmonogram

Html / Markdown - Treść formatowana

Indicator - Wskaźnik

Dashboard - Panel kafelkowy

Bindowanie danych

Powiązanie typu z formularzem

Zmiana kontekstu danych

Składnia wyrażeń w klamrach

Wyrażenia porównań

Przykłady bindingów

Wyrażenia warunkowe (RowCondition)

Atrybut Class - Style i zachowania

Style etykiet

Style czcionek

Wyrównanie

Typy edytorów

Zachowania

Układy i pozycjonowanie

Przyciski

Appearance - Warunkowe formatowanie

Przykłady

Prosta zakładka (pageform.xml)

Współdzielony fragment (form.xml)

Referencje

26 KiB

Raw Blame History