Obliczanie ilości usługi

Reguły obliczania ilości usługi służą do wyznaczania lub obliczania ilości usługi, która jest ostatecznie wstawiana do zbioru ilości usługi segmentu faktury. Reguły obliczania ilości usługi umożliwiają zarówno manipulowanie zmierzonym zużyciem, jak i wyznaczanie ilości, których nie można zmierzyć za pomocą licznika.

Nazwa reguły: Obliczanie ilości usługi
Obiekt biznesowy reguły obliczania w pakiecie podstawowym: C1-CalculateServiceQuantity
Typ algorytmu/algorytm zastosowania reguły obliczania: C1-CALC-SQ
Parametry reguły:
- Zmienna skalarna 1 (Zmienna skalarna 2, Zmienna skalarna 3, ... Zmienna skalarna 5): Umożliwia zdefiniowanie zmiennej skalarnej, która zostanie wykorzystana w obliczeniach. W przypadku użycia w formułach zmienne skalarne są oznaczane jako "Vn", gdzie "n" odpowiada numerowi przydzielonemu do zmiennej (tzn. V1 = zmienna skalarna 1, V2 = zmienna skalarna 2, itd.).
  - Typ: Określa typ zmiennej. Istnieją następujące typy zmiennych:
    - Algorytm: Algorytm odpowiada za pobieranie wartości zmiennej skalarnej, np. obliczenie liczby dni okresu fakturowania.
    - Współczynnik fakturowy: Wartość określonego współczynnika fakturowego, obowiązującego w danym okresie.
    - Obliczony wiersz: Wartość wyznaczana jest poprzez zsumowanie uprzednio obliczonych wierszy, zdefiniowanych jako wiersze należące do kategorii docelowej.
    - Wartość charakterystyki: Wartość wyznaczana jest poprzez zsumowanie wartości danego typu charakterystyki.
    - Zakontraktowane zużycie: Wartość danego typu zakontraktowanego zużycia, określonego w umowie.
    - Historyczna ilość usługi: Wartość wyznaczana jest na podstawie historycznych ilości usługi segmentu faktury umowy w odniesieniu do określonej jednostki miary/czasu poboru/identyfikatora ilości usługi. Funkcja agregująca definiuje obliczenia wykonywane w zestawie historycznych ilości usługi, pobranych w celu wyznaczenia pojedynczej wartości Obsługiwane wartości to: średnia, maksymalna, minimalna oraz suma.
    - Ilość usługi: Ilości usługi ze zbioru ilości usługi okresu fakturowania, w oparciu o określoną jednostkę miary/czas poboru/identyfikator ilości usługi. Ten typ zmiennej pozwala regule na wykorzystanie wartości obliczonych przez inne reguły.
    - Poprzednia ilość: Wartość wyznaczana jest na podstawie ostatnich zamrożonych ilości usługi segmentu faktury umowy w odniesieniu do określonej jednostki miary/czasu poboru/identyfikatora ilości usługi.
  - Czynność w przypadku braku wartości: Określa działania możliwe do wykonania w przypadku, gdy system nie może pobrać lub wyznaczyć wartości dla określonej zmiennej skalarnej. Możliwe opcje to:
    - Wybór opcji Błąd w celu utworzenia wyjątku
    - Wybór opcji Pomiń w celu pominięcia danej reguły i rozpoczęcia przetwarzania kolejnej
    - Wybór opcji Użycie wartości domyślnej w celu skonfigurowania domyślnej wartości dla określonej zmiennej skalarnej
- Szczegóły obliczeń: Szczegółowe informacje dotyczące sposobu wykonywania obliczeń przy użyciu reguły:
  - Przetwarzanie reguły obliczania: Służy do wskazywania, czy reguła jest zawsze wykonywana przez aplikację cennika, nawet jeśli podczas ponownego obliczania przez system segmentu faktury mają zostać zastosowane szczegóły zużycia zawarte w pierwotnym segmencie faktury. Jeśli reguła nie powinna być wykonywana, gdy w pierwotnym segmencie faktury są używane szczegóły dotyczące zużycia, wówczas należy wskazać, że reguła obliczania powinna być stosowana jedynie w opcji Obliczanie początkowej ilości usługi.
  - Czynność w przypadku niepowodzenia: Służy do wskazywania czynności do wykonania, jeśli podczas stosowania formuły zawartej w regule wystąpił błąd. Dostępne opcje to utworzenie błędu segmentu faktury lub pominięcie reguły obliczania.
  - Wynik reguły obliczania: Służy do określenia, czy reguła obliczania ma powodować dodanie lub aktualizację zapisu ilości usługi w zbiorze ilości usługi okresu fakturowania, utworzenie wiersza obliczania faktury czy też spowodować wystąpienie obu tych czynności.
  - Zachowanie ilości usługi: Służy do wskazywania, czy należy zapisać obliczoną wartość w segmencie faktury. Wartość Nie oznacza, że wartość będzie istniała w zbiorze ilości usługi tylko podczas wykonywania obliczeń przez motor cennika. Tę wartość powinno stosować się w przypadku zapisów ilości usługi, które nie muszą być przechowywane na potrzeby audytów bądź analiz.
  - Źródło formuły: Służy do określania typu formuły, która zostanie zastosowana w regule. Dostępne opcje to "Prosta formuła" i "Formuła warunkowa".
  - Formuła: Służy do określania prostej formuły do zastosowania. Zmienne skalarne stosowane do obliczania oznaczone są jako "Vn", gdzie "n" odpowiada numerowi przydzielonemu do zmiennej (np. V1 = zmienna skalarna 1, V2 = zmienna skalarna 2, itd.). Obsługiwane operacje matematyczne to dodawanie, odejmowanie, mnożenie i dzielenie. Przykład: (V1*V2)/2.
    - Formuła warunkowa: Umożliwia porównanie jednej lub wielu par argumentów w celu określenia, która formuła zostanie użyta. W formule warunkowej stosuje się jeden lub wiele warunków. Każdy warunek składa się z następujących elementów:
      - Argument 1: Pierwszy argument warunku. Może odwoływać się do wyrażenia z jedną lub wieloma zmiennymi skalarnymi (oznaczonymi jako "Vn"), np. [V1+V2] lub [(V1/V2)*V3].
      - Operator: Operator umożliwiający porównanie argumentu 1 z argumentem 2.
      - Argument 2: Drugi argument warunku. Może odwoływać się do wyrażenia z jedną lub wieloma zmiennymi skalarnymi lub do stałej (podobnie jak argument 1).
      - Czynność, jeżeli "Prawda": Służy do wskazania czynności wykonywanej, gdy porównanie między argumentami ma wartość "Prawda". Możliwe czynności to:
        Zastosowanie formuły dla wartości "Prawda": Służy do wskazania, że należy zastosować formułę dla wartości "Prawda".
        
        Sprawdzanie następnego warunku: Służy do wskazania, że należy sprawdzić następny warunek.
      - Formuła dla wartości "Prawda": Formuła stosowana, gdy dla czynności w przypadku wartości "Prawda" skonfigurowano wartość "Zastosowanie formuły dla wartości Prawda". Może odwoływać się do wyrażenia z jedną lub wieloma zmiennymi skalarnymi (oznaczonymi jako "Vn") lub do stałej.
      - Czynność, jeżeli "Fałsz": Służy do wskazania czynności wykonywanej, gdy porównanie między argumentami ma wartość "Fałsz". Możliwe czynności to:
        Zastosowanie formuły dla wartości "Fałsz": Służy do wskazania, że należy zastosować formułę dla wartości "Fałsz".
      - Sprawdzanie następnego warunku: Służy do wskazania, że należy sprawdzić następny warunek.
      - Formuła dla wartości "Fałsz": Formuła stosowana, gdy dla czynności w przypadku wartości "Fałsz" skonfigurowano wartość "Zastosowanie formuły dla wartości Fałsz". Może odwoływać się do wektora (oznaczonego jako "IVn", gdzie "n" to numer wektora), do wyrażenia odwołującego się do jednego lub wielu wektorów lub do zmiennej skalarnej (oznaczonej jako "Vn").
- Wynik: Służy do definiowania jednostki miary, czasu poboru i/lub identyfikatora ilości usługi do użycia, jeśli dana reguła obliczania powoduje wstawienie lub aktualizację ilości usługi w zbiorze ilości usługi okresu fakturowania.
Przykład: Poniższa reguła służy do obliczania sumy kWh na podstawie ilości usługi w szczycie i poza nim.
Grupa obliczeń: Obliczanie KWH

Reguła obliczania: TOTKWH

Sekwencja: 10

Opis: Łączna liczba KWH (w szczycie + poza szczytem)

Zmienna skalarna 1:
- Typ: Ilość usługi
- Czynność w przypadku braku wartości: Błąd
- Jednostka miary: Kilowatogodzina
- Czas poboru: W szczycie
- Ilość usługi do użycia: Możliwe do zafakturowania
  Zmienna skalarna 2:
- Typ: Ilość usługi
- Czynność w przypadku braku wartości: Błąd
- Jednostka miary: Kilowatogodzina
- Czas poboru: Poza szczytem
- Ilość usługi do użycia: Możliwe do zafakturowania
  Szczegóły obliczeń:
- Przetwarzanie reguły obliczania: Zawsze
- Działanie w razie niepowodzenia: Błąd
- Wynik reguły obliczania: Ilość usługi
- Zachowanie ilości usługi: Nie
- Źródło formuły: Prosta formuła
- Formuła: V1 + V2
  Wynik:
- Jednostka miary: Kilowatogodzina