Funkcja kalkulacji: LLicznik

Opis funkcji działania funkcji LLicznik( Symbol, Rodzaj, ZakresMc , Co)¶

Opis parametrów funkcji¶

1. Symbol - opcjonalny parametr (łańcuch znaków) zawierający symbol użytej pozycji z słownika elementów naliczenia obciążeń
2. Rodzaj - opcjonalny parametr (łańcuch znaków) zawierający symbol rodzaju naliczenia jakie jest ustalone na kartotece lokalu
3. ZakresMc - opcjonalny parametr (liczba całkowita) określająca przesunięcie ilości miesięcy w stosunku do miesiąca naliczenia. Domyślna wartość to 0, ujemne wartości przesuwają wstecz a dodatnie w
   przód.
4. Co - opcjonalny parametr zmieniający co ma być zwracane przez funkcje. Wartość pusta parametru Co w zwraca rożne wartości w zależności od tego co licznik przechowuje. W przypadku jak to jest odczyt to wartość jest równa różnicy bieżącego odczytu i poprzedniego.
   

Dopuszczalne wartości parametru Co funkcji ¶

• 'średnia_dzienna' , 'srednia_dzienna' , 'sd' - zwraca wartość średniej jaka była w podanym okresie. W przypadku gdy licznik nie ma odczytów zwracana jest średnia z kartoteki licznika
• 'ilość_mc_okresu' , 'ilosc_mc_okresu' , 'imo' - zwraca ilość miesięcy pomiędzy odczytami (bieżący - poprzedni)
• 'ilość_dni_okresu' , 'ilosc_dni_okresu' , 'ido' - zwraca ilość dni pomiędzy odczytami (bieżący - poprzedni) licząc pełne miesiące
• 'odczyt_bieżący' , 'odczyt_biezacy' , 'ob' - zwraca wartość odczytu bieżącego
• 'odczyt_poprzedni' , 'op' - zwraca wartość odczytu poprzedniego. W przypadku jak licznik przechowuje wartości lub zużycie odczyt poprzedni jest równy bieżącemu
• 'data_bieżąca' , 'data_biezaca' , 'db' - zwraca datę odczytu bieżącego (data w formacie Clarion)
• 'data_poprzednia' , 'dp' - zwraca datę odczytu poprzedniego (data w formacie Clarion)
  

Szczegółowy opis działania funkcji¶

• w przypadku nie podania parametru Symbol funkcja próbuje szukać kartoteki licznika na składniku naliczenia lokalu z poziomu którego została wywołana. W np. 1 jest pokazane wywołanie.
• w przypadku podania parametru Symbol funkcja szuka pierwszego wystąpienia tego składnika na kartotece lokalu do którego jest wywołana. Jeśli funkcja nie znajdzie symbolu generuje błąd i przerywa działanie generacji obciążeń.
• parametr Rodzaj reprezentuje pozycje rodzaj naliczenia na zakładce składniki naliczenia kartoteki lokalu. Użycie parametru Rodzaj jest zasadne w przypadku gdy parametr Symbol występuje w kilku rodzajach naliczenia dla tego samego lokalu do tego żeby funkcja jednoznacznie identyfikowała pozycje wywołania. W większości algorytmów podawanie tego parametru nie jest potrzebne w np. 2 jest przykładowe wywołanie bez podania.
• jeśli funkcja nie znajdzie kartoteki licznika lub kartoteka licznika jest w archiwum lub zlikwidowana to funkcja zwraca ilość 0
• parametr ZakresMc pozwala na określenie miesiąca w którym ma być znaleziony odczyt. Brak użycia parametru lub wartość 0 powoduje szukanie w bieżącym miesiącu. Użycie wartości ujemnych powoduje szukanie wstecz a dodatnich w przód względem bieżącego miesiąca. Przykład użycia jest w np. 3
• nie znalezienie odczytu powoduje zwrócenie wartości 0
• licznik nie obsługuje kalkulacji po przekręceniu się licznika
  

Przykłady wywołania¶

 LLicznik()

 LLicznik( 'kis',,-1)

 LLicznik( ,,-2) 

Kom( 'średnia dzienna = ' & LLicznik( , , , 'średnia_dzienna')) & 
Kom( 'ilość miesięcy okresu = ' & LLicznik( , , , 'ilość_mc_okresu')) &
Kom( 'ilość dni okresu = ' & LLicznik( , , , 'ilość_dni_okresu')) & 
Kom( 'odczyt bieżący = ' & LLicznik( , , , 'odczyt_bieżący')) & 
Kom( 'odczyt poprzedni = ' & LLicznik( , , , 'odczyt_poprzedni')) &
Kom( 'data poprzednia odczytu = ' & LLicznik( , , , 'data_bieżąca')) &
Kom( 'data bieżąca odczytu = ' & LLicznik( , , , 'data_poprzednia')) 

LLicznik( , , , 'średnia_dzienna') * dr( 'ilosc_dni_mc', 0, 5)

((LLicznik( , , , 'data_bieżąca')-LLicznik( , , , 'data_poprzednia'))+1) * LLicznik( , , , 'średnia_dzienna')