Liczniki / Counters

W celu nadawania m.in. numerów dokumentów korzystamy z metody licznik, dzięki której można dowolnie formułować format zapisu.

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

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.

Formularz dopisania / edycji przykładowego kodu SQL dla 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

Formularz edycji licznika – dodawanie kodu SQL

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

Components – Help -> Counter modal