Funkcja kalkulacji: NLicznik

Zmodyfikowano dnia 2015/06/09 12:55 przez Wojtek — Skategoryzowana jako: GW-MAX, GW-MAX_Czynsze

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

Funkcja służy do pobrania wartości z licznika zgodnie z konfiguracją kartoteki licznika. Kartoteka licznika przechowuje odczyty w formie ilości (stanu licznika) lub wartości wynikowej z odczytu (to często w przypadku liczników ciepła występuje).

Opis parametrów funkcji¶

Symbol - opcjonalny parametr (łańcuch znaków) zawierający symbol użytej pozycji z słownika elementów naliczenia obciążeń
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.
Co - opcjonalny parametr zmieniający co ma być zwracane przez funkcje

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 nieruchomości z poziomu którego została wywołana.
w przypadku podania parametru Symbol funkcja szuka wystąpienia tego składnika na kartotece nieruchomości do którego jest wywołana. Jeśli funkcja nie znajdzie symbolu generuje błąd i przerywa działanie generacji obciążeń.
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.
nie znalezienie odczytu powoduje zwrócenie wartości 0
licznik nie obsługuje kalkulacji po przekręceniu się licznika

Przykłady wywołania¶

Np. 1 - pokazuje wywołanie bez parametrów


 NLicznik()

Formuła kalkulacji zwróci ilość lub wartość (zależne od konfiguracji kartoteki licznika) a numer kartoteki licznika zostanie wczytany z składnika elementu naliczenia na kartotece nieruchomości takiego samego z jakiego została funkcja wywołana na lokalu.

Np. 2 - pokazuje użycie parametru ZakresMc


 NLicznik( 'lg' ,-2)

Funkcja szuka odczytu w dwa miesiące wcześniej niż bieżący. dla kartoteki składnika 'lg' na kartotece nieruchomości.