Wzorce. Funkcje TrExtLang. Opis ogólny

1. Opis ogólny 2. Charakterystyka języka TrExtLang (porównawczo) 3. Przykład prostego zastosowania 4. Typowe scenariusze użycia TrExtLang 5. Korzyści i zalety podejścia TrExtLang 6. Dla kogo jest TrExtLang ? 7. Zestawy funkcji podobne do TrExtLang 8. Tematy powiązane

1. Opis ogólny

TrExtLang. Język rozszerzeń do sterowania wydrukami i szablonami w Trawers ERP

TrExtLang (Trawers Extension Language) to wbudowany język szablonów, używany w systemie Trawers ERP do dynamicznego generowania treści dokumentów, raportów, etykiet i innych wydruków. Pełni on funkcję analogiczną do: * SAPScript / SmartForms w SAP * makr raportów i formuł w Comarch ERP XL / Optima * AL Reports w Microsoft Dynamics 365 Business Central * języków szablonów w narzędziach typu Crystal Reports, JasperReports, FastReport Jego składnia i funkcje pozwalają użytkownikowi na osadzanie logiki, formatowania i przetwarzania danych bez konieczności pisania kodu programistycznego - w stylu znanym z języków szablonów czy raportów.

Do czego służy TrExtLang ?

TrExtLang pozwala na: * Warunkowe wyświetlanie i drukowanie informacji (np. tylko dla wybranych klientów, dokumentów, wartości). * Formatowanie danych liczbowych, dat i tekstów. * Operacje arytmetyczne i logiczne, np. porównania. * Wstawianie elementów graficznych (np. logo, kody kreskowe, obrazy). * Iterację (cykliczne powtarzanie) po danych (np. pozycje dokumentu). * Łączenie danych z wielu źródeł (np. kartoteka KIM, dane transakcyjne). * Tworzenie raportów, formularzy i wydruków dopasowanych do kontekstu. Patrz też: Wzorce TrExtLang. Funkcje

2. Charakterystyka języka TrExtLang (porównawczo)

| Element | TrExtLang | Odpowiedniki | | ----------------------- | ------------------------------------- | -----------------------------------------------| | Funkcje warunkowe | `ţJeśli`, `ţWarunek` | `IF`, `IIF` (Crystal), | | | | `Condition` (SmartForms), `=IF(...)` (Excel) | | Pętle / iteracje | `ţPętla`, `ţSQL`, `ţWiersz` | `FOR EACH`, subreports, loops | | Funkcje tekstowe | `ţLeft`, `ţReplace`, `ţFormatTekstu` | `LEFT`, `REPLACE`, `UPPER` | | Funkcje daty/czasu | `ţData`, `ţDniRobocze` | `NOW()`, `TODAY()`, `DATEADD()` | | Kody kreskowe i grafika | `ţKodKreskowy`, `ţObrazek` | `Barcode()`, `Image()` | | Zmienność kontekstu | Dostęp do zmiennych systemowych (`@`) | `Fields!`, `Parameters!`, `&Zmienna` |

3. Przykład prostego zastosowania

Wyobraźmy sobie fakturę, na której: * Logo firmy zmienia się zależnie od oddziału * Kwoty większe niż 10 000 są oznaczone jako DO AUTORYZACJI * Pod każdą pozycją pokazujemy kod kreskowy towaru

Przykładowe wyrażenia w TrExtLang

ţJeśli(@Oddział = "WROCŁAW"; ţObrazek("logo_wr.png"); ţObrazek("logo_def.png") ţJeśli(@Wartosc > 10000; "DO AUTORYZACJI"; "") ţKodKreskowy(@KodTowaru; "EAN13")

4. Typowe scenariusze użycia TrExtLang

1. Formularze sprzedaży i zakupu: Faktury, WZ, zamówienia z dynamicznymi treściami, warunkowymi stopkami. 2. Etykiety magazynowe: Z kodami kreskowymi, datami ważności, zmiennym układem graficznym. 3. Raporty handlowe i logistyczne: Z warunkowym sumowaniem, kolorowaniem, filtrowaniem. 4. Dokumenty produkcyjne: Z rysunkami technicznymi, planami operacji i QR-kodami. 5. Alerty Monitorowanie zdarzeń lub warunków i automatyczne reagowanie. 6. AutoRun Automatyczne uruchamianie funkcji i zadań. Z pominięciem ręcznego menu.

5. Korzyści i zalety podejścia TrExtLang

* Brak konieczności programowania Użytkownicy mogą edytować szablony bez udziału IT. * Zgodność z modelem danych ERP Łatwy dostęp do danych z dokumentów, kartotek, transakcji. * Szybkie modyfikacje Przydatne w firmach, które często zmieniają układy wydruków lub mają wiele wariantów formularzy. * Spójność logiczna z innymi systemami ERP Użytkownik mający doświadczenie z SAP, Comarch, Dynamics, Crystal Reports odnajdzie znajome koncepcje.

6. Dla kogo jest TrExtLang ?

Dla analityków, wdrożeniowców i użytkowników zaawansowanych w systemie Trawers ERP, którzy: * Znają inne systemy ERP i narzędzia raportujące. * Potrzebują dynamicznie modyfikować wydruki. * Oczekują od narzędzia elastyczności i pełnej kontroli nad wyglądem dokumentu.

7. Zestawy funkcji podobne do TrExtLang

1. SAP - SmartForms i SAPScript

* Charakterystyka SAP posiada własne środowiska projektowania wydruków i raportów (SAPScript, później SmartForms). * Funkcje Warunki, pętle, pola dynamiczne, funkcje formatowania. * Podobieństwo Możliwość osadzania logiki w szablonach druków (np. jeśli klient = X to pokaż logo).

2. Microsoft Dynamics 365 (NAV/BC) - AL Reports + RDLC / Word Layouts

* Charakterystyka Projektowanie wydruków w formacie Word lub RDLC z użyciem danych z systemu. * Funkcje Wyrażenia warunkowe, pola formuł, funkcje tekstowe i matematyczne. * Podobieństwo Możliwość manipulowania zawartością raportu z użyciem języka AL lub formuł Word/RDLC.

3. Comarch ERP XL / Optima - Wydruki i Makra

* Charakterystyka Wydruki konfigurowane w kreatorze z obsługą makr. * Funkcje Operacje warunkowe, wyrażenia formuł, dostęp do pól bazodanowych. * Podobieństwo Podobna składnia funkcji do TrExtLang, możliwość dynamicznego formatowania danych.

4. Subiekt GT (InsERT) - Sfera + Raporty

* Charakterystyka Rozszerzalność przez język Sfera (VBScript-like) oraz edytor wydruków. * Funkcje Skrypty sterujące zachowaniem raportów i dokumentów. * Podobieństwo Możliwość warunkowego wstawiania danych, pętli, obliczeń.

5. Crystal Reports / FastReport / JasperReports (dla wielu ERP)

* Charakterystyka Ogólne narzędzia raportowe używane z różnymi systemami ERP. * Funkcje Zmienne, wyrażenia warunkowe, funkcje tekstowe i dat, pętle, podraporty. * Podobieństwo Bardzo zaawansowane możliwości raportowania i formatowania logicznego.

Główne wspólne cechy tych systemów

| | TrExtLang | | | Cecha | Trawers ERP | Inne systemy ERP | | -------------------------------- | ------------| ------------------------------ | | Język szablonów | v | v (np. SAPScript, AL, makra) | | Obsługa warunków i funkcji | v | v | | Pętle, warunki, funkcje tekstowe | v | v | | Generowanie kodów kreskowych | v | v | | Obsługa danych dynamicznych | v | v |

Podsumowanie

TrExtLang wpisuje się w szeroką kategorię języków makr lub szablonów raportowych dostępnych w systemach ERP. Choć składnia i sposób użycia różnią się między systemami, idea jest bardzo podobna: umożliwić użytkownikom dynamiczne, kontekstowe generowanie treści dokumentów i raportów z użyciem funkcji, warunków i danych.

8. Tematy powiązane

Wzorce TrExtLang. Funkcje Drukowanie Urządzenia wyjściowe Wzorce dokumentów Przykłady Wzorce etykiet Przykłady AutoRun Procesy automatyczne SOA Architektura wymiany danych Słowa kluczowe #Admin-UrządzeniaWyjściowe #Admin-WzorceDokumentów #Admin-Narzędzia #TrawersERP-Komponenty #TrawersERP-SOA/API