StudioSystem RS

Liczniki (Counters) - formatowanie numerów dokumentów z tokenów

Liczniki formułują numery dokumentów z tokenów daty, liczby porządkowej i kodów SQL. Opisujemy zakładki General i Grouping oraz wykorzystanie Code SQL.

rs.softwarestudio.com.pl/studiosystemrs/
Zrzut ekranu - image
Zrzut ekranu - image

W celu nadawania m.in. numerów dokumentów korzystamy z metody licznik, dzięki której można dowolnie formułować format zapisu. Licznik może składać się między innymi z kolejnej liczby porządkowej, różnych elementów daty (rok, miesiąc, dzień), dodatkowych symboli stałych, jak również wyników zwróconych w specjalnie przygotowanych kodach SQL.

Formularz dopisania i edycji Licznika

Formularz służy do tworzenia nowych definicji , w których korzystamy z metody licznik oraz edycji już istniejących rekordów. Składa się on z dwóch zakładek:

  • GENERAL
  • GROUPING

GENERAL

Zakładka służy do określenia podstawowych danych licznika takich jak nazwa, czy kod PRX, jak również formułowania formatu licznika.

Składa się z następujących pól w sekcji Ogólne:

  • NAZWA- nazwa konfiguracyjna elementu
  • PRX - kod, który ma za zadanie grupowanie elementów w logicznie lub biznesowo powiązane zbiory
  • OPIS- krótka charakterystyka licznika lub/i jego wykorzystania
  • ACTIVE - Oznaczenie czy licznik ma być aktywny tj. dostępny w innych elementach konfiguracyjnych oraz czy może być obecnie wykorzystywany przez program
  • SYSTEM - Oznaczenie czy wskazany licznik jest elementem konfiguracji systemu

Natomiast w sekcji Konfiguracja wzorca składa się z pól:

  • WYBIERZ TOKEN- lista rozwijana z dostępnym gotowymi częściami składowymi licznika, spośród listy można wybierać również przygotowane wcześniej kody SQL
  • Button DODAJ DO WZORCA - pozwala wstawić wybrany token do konfigurowanego wzorca licznika
  • WZORZEC- Wzorzec licznika składający się z wielu elementów z możliwością dodawania kolejnych
  • POCZĄTKOWA WYGENEROWANA WARTOŚĆ- Podgląd pierwszej wartości wygenerowanej przez skonfigurowany licznik
  • POCZĄTKOWA WARTOŚĆ LICZNIKA- Cyfra, bądź liczba będąca pierwszą nadaną wartością w danym liczniku
  • MINIMALNA DŁUGOŚĆ WARTOŚCI- ilość znaków składających się na kolejny numer w reklamacji
  • MIESIĄC ROZPOCZĘCIA ROKU PODATKOWEGO- określenie początku roku podatkowego
Zrzut ekranu - image
Formularz dopisania / edycji licznika

GROUPING

Zakładka pozwala według określonego parametru. Katalog parametrów jest zamknięty, co oznacza, że do jego rozszerzenia niezbędna jest praca programisty. W trakcie przygotowania jest rozwiązanie pozwalające określić nowy sposób grupowania za pomocą kodu SQL („Grupuj po Code SQL”).

Zrzut ekranu - image 1
Formularz dopisania / edycji licznika

Code SQL

W treści licznika może zostać zawarta dowolna wartość zwrócona przez przygotowany kod SQL.

W celu dopisania UID z kodem należy przejść do pozycji menu konfiguratora FORMS ->Code SQL.

UID kodu można przekopiować w odpowiedni fragment wzorca licznika lub dodać poprzez wybór z listy „Wybierz token” w definicji licznika.

Dodawanie kodu SQL do licznika

Dodając kod SQL do treści licznika poprzez funkcję dodawania tokena należy kolejno wskazać rodzaj tokena: Code SQL, następnie z listy wskazać odpowiedni kod, natomiast w polu Code SQL field name wskazać nazwę zwracanej przez kod wartości (może być to np. nazwa szukanej kolumny, lub nadany alias).

Dodając kod ręcznie należy użyć sformułowania:

@CODESQL{’numer UID wykorzystanego kodu’; 'fields name’}@VALUE

Dodatkowe informacje dotyczące podpięcia definicji licznika dostępne w instrukcji

Components - Help -> Counter modal

Powiązane strony dokumentacji

Wdrażasz lub konfigurujesz StudioSystem RS?

Zespół SoftwareStudio pomoże dobrać ustawienia platformy do procesów w Twojej firmie.