Raporty Definiowane: Różnice pomiędzy wersjami
Utworzono nową stronę "prawo Raporty definiowane są sposobem na szybkie uzyskanie wybranych informacji z bazy danych programu. Raporty podzielono na tematy,..." |
Dodałem opis funkcji z pomocy. |
||
Linia 42: | Linia 42: | ||
Szczególne przypadki zastosowania raportów definiowanych wymagają zastosowania pól wyliczeniowych. Istnieje możliwość wykorzystania w tym celu kolumny "Formuła" specyfikacji raportu. W polu tym trzeba zapisać taką formułę, która umożliwi programowi pobranie i wyliczenie wymaganej wartości. Np. zapisując tabela1->pole1- tabela1->pole2 uzyskamy pole wyliczeniowe równe różnicy pól pole1 i pole2 tabeli1. | Szczególne przypadki zastosowania raportów definiowanych wymagają zastosowania pól wyliczeniowych. Istnieje możliwość wykorzystania w tym celu kolumny "Formuła" specyfikacji raportu. W polu tym trzeba zapisać taką formułę, która umożliwi programowi pobranie i wyliczenie wymaganej wartości. Np. zapisując tabela1->pole1- tabela1->pole2 uzyskamy pole wyliczeniowe równe różnicy pól pole1 i pole2 tabeli1. | ||
Wartość wyliczeniowa może być porównywana z wartością wpisaną zgodnie z zadanym operatorem. | Wartość wyliczeniowa może być porównywana z wartością wpisaną zgodnie z zadanym operatorem. | ||
{{:Funkcje}} | |||
Przykładowe raporty definiowane w programie: | Przykładowe raporty definiowane w programie: |
Aktualna wersja na dzień 14:16, 7 lut 2018
Raporty definiowane są sposobem na szybkie uzyskanie wybranych informacji z bazy danych programu. Raporty podzielono na tematy, którym odpowiada określony zestaw tabel bazy danych. Przechodząc do definiowania nowego raportu należy wybrać interesujący temat, a następnie, dodać nową pozycję i wpisać nazwę raportu. Nazwa pojawi się na wydruku obok tematu. Kolejnym etapem definiowania raportu jest określenie kolumn na podstawie proponowanego zestawu znajdującego się o okienku listy. Kliknięcie na odpowiedni guzik ">" lub też "<" powoduje włącznie pola do raportu lub też wyłączenie. Tabela wykazu kolumn raportu umożliwia zmianę treści nagłówka, blokadę wydruku (wstawiona kolumna może być użyta wyłącznie do filtra), określenie sortowania i zdefiniowanie filtrowania danych.
Filtrowanie. Zagadnienie wyboru danych do raportu należy do najważniejszych i skuteczne ograniczanie decyduje o możliwości wykorzystania raportu. Wprowadzono następujące operatory:
" " - brak operatora - filtr jest wyłączony
Operator | pole tekstowe | pole numeryczne | pole daty |
---|---|---|---|
<< | tekst z pola zawiera się w wartości | liczba mniejsza ponad 1000 razy | data z pola o przynajmniej rok wcześniejsza |
< | tekst jest mniejszy w sensie alfabetu | liczba mniejsza | data z pola wcześniejsza |
\ | tekst jest mniejszy lub równy w sensie alfabetu | liczba mniejsza lub równa | data z pola wcześniejsza lub taka sama |
= | teksty są sobie równe | obie równe | równe daty |
# | teksty różne | obie różne | różne daty |
~ | teksty podobne (zawierają się w sobie) | wartości przybliżone do 10% | przybliżone daty |
/ | tekst większy lub równy w sensie alfabetu | liczba większa lub równa | data pola późniejsza lub taka sama |
> | tekst większy w sensie alfabetu | liczba większa | data pola późniejsza |
>> | wartość zawiera się w tekście pola | liczba większa ponad 1000 razy | data pola późniejsza ponad rok |
Budowanie filtrów złożonych polega na składaniu filtru z warunków dla wielu wybranych pól. Musimy wiedzieć, że domyślnie zakłada się spełnienie wszystkich warunków, czyli zastosowano operator logiczny "i". Jeżeli jednak istnieje potrzeba zdefiniowania filtru z zastosowaniem operator "lub", to wystarczy skorzystać z pola NF (negacja filtru) w nagłówku definicji raportu. Zaznaczenie tego pola spowoduje wybranie danych do raportu, gdy zdefiniowany filtr nie jest spełniony.
Dalej należy skorzystać ze znanej zależności:
!(a i b) = (!a lub !b), gdzie znakiem "!" oznaczono negację wyrażenia.
Przykładowo: Zadanie polega na wygenerowaniu raportu sprzedaży dla dwóch klientów o nazwach skróconych: KLIENT1 i KLIENT2. Do raportu wstawiamy dwie kolumny NAZWA_SKR i jedną z nich zaznaczamy, że ma się nie drukować. Po zdefiniowaniu pozostałych kolumn raportu pozostaje konieczność wstawienia odpowiednich warunków do filtru. Do pól zatytułowanych "Wartość" wpisujemy odpowiednio wymagane nazwy klientów oraz wybieramy operatory "#" (różny). Następnie musimy zaznaczyć pole NF w nagłówku definicji raportu. Jak widać wygląda to wszystko nieco skomplikowanie, ale to tylko pozory.
W programie księgowym powinna być możliwość wykonania raportu zawierającego sumy kwot lub zliczenie liczby pozycji. Raporty Definiowane mają taką możliwość po zaznaczeniu opcji "ZLICZ" w nagłówku raportu. Efektem raportu zliczonego jest tabela zawierająca kolumny określone jako nagłówki wierszy (nie polegają sumowaniu, ani zliczeniu), które grupują dane i kolumny zawierające sumy pól numerycznych oraz zliczone pozostałe pola. Sprawdź działanie opcji zliczania drukując raport w obu jej stanach. Wówczas wszystko stanie się jasne ;)
Szczególne przypadki zastosowania raportów definiowanych wymagają zastosowania pól wyliczeniowych. Istnieje możliwość wykorzystania w tym celu kolumny "Formuła" specyfikacji raportu. W polu tym trzeba zapisać taką formułę, która umożliwi programowi pobranie i wyliczenie wymaganej wartości. Np. zapisując tabela1->pole1- tabela1->pole2 uzyskamy pole wyliczeniowe równe różnicy pól pole1 i pole2 tabeli1. Wartość wyliczeniowa może być porównywana z wartością wpisaną zgodnie z zadanym operatorem.
Funkcje dostępne w formułach.
W formułach można stosować wszystkie podstawowe funkcje języka CLIPPER[1] i VO np.
and(wartość, arg1, arg2,...arg10) | wykonaj operacje z operatorem ".and." wartość=arg1.and.wartość=arg2.and. .and.wartość=arg10 |
Date2Text(,<odstęp>) | analogicznie j.w. tylko jeszcze usuwa separatory, np. Date2Text('2007.06.28',2) -> 2007 06 28 |
dtoc( ) | zamienia datę na tekst |
iif(<warunek>,<prawda>,<fałsz>) | zwraca odpowiednio <prawda> lub <fałsz> w zależności od spełnienia <warunek> |
int(<liczba>) | zaokrągla do liczby całkowitej poprzez odcięcie |
liczba(<nieznany_typ>) | zwraca liczbę |
ltrim(<tekst>) | odcięcie spacji z lewej strony tekstu |
lower(<tekst>) | zwraca wszystkie litery jako małe |
KursWaluty(<Rodzaj>,<Waluta>,) | zwraca kurs, parametr Rodzaj to rodzaj kursu z okna Kursy walut |
<data_tekstowa>|<nr_miesiaca>) | zwraca słownie miesiąc |
Odsetki(<Kwota>,<Termin>,<Zaplata>,<rodzaj>) | chyba jasne :) rodzaj to U lub P |
or(wartość, arg1, arg2,...arg10) | wykonaj operacje z operatorem ".or." wartość=arg1.or.wartość=arg2.or. .or.wartość=arg10
np. or(LSTSKL->TYP,'E','R','W') co jest identyczne z LSTSKL->TYP=='E'.or.LSTSKL->TYP=='R'.or.LSTSKL->TYP=='W' |
OstatniDzien(<okres>) | zwraca ostatni dzień miesiąca |
Pytaj(<treść_pytania>,<domyślna_wartość>) | zapytanie o wartość |
round(<liczba>,<dziesiąte>) | zaokrągla matematycznie do <dziesiąte> miejsc po przecinku (kropce) |
rtrim(<tekst>) | odcięcie spacji z prawej strony tekstu |
str( <liczba>, <długość>, <po kropce> ) | zwraca tekst |
StrTran(<tekst>, <szukany>, [<zamien_na>], [<nr_znaku_poczatku>], [<nr_znaku_konca>]) | zwraca <tekst> z zamienionymi znakami <szukany> na <zamien_na>, można nie stosować pozostałych parametrów |
tekst(<cokolwiek>) | zamienia <cokolwiek> na tekst bez spacji początkowych i końcowych |
Text2Text(<coś>,<odstęp>) | traktuje zwraca <coś> jako tekst ze znakami oddzielonymi spacjami w ilości <odstę>, np. Text2Text(100,5) -> 1 0 0 |
upper(<tekst>) | zwraca wszystkie litery jako duże |
val( <tekst> ) | zwraca liczbę |
Wojewodztwo(<kod_pocztowy>) | zwraca nazwę województwa |
RapSum(<nazwa_raportu>,<kolumna>,<okres>) | wartość podsumowania zapisana po zaznaczeniu "SP", <kolumna> - treść tytułu kolumny lub numer kolumny podsumowywanej (liczymy tylko kolumny z podsumowaniem), <okres> w postaci rok.miesiąc lub data |
RapZm(<nazwa_raportu>,<nazwa_zmiennej>,<wartość>) | zapis/odczyt zmiennej, <nazwa_raportu> jeśli .T., to raport bieżący, <nazwa_zminnej> - dowolny ciąg znaków, a <wartość> to liczba zapisywana do zmiennej, a gdy nie będzie tego parametru, to tylko odczyt zmiennej |
RapZmSum(<nazwa_raportu>,<lista_zmiennych>) | odczyt sumy zmiennych o nazwach z <lista_zmiennych>, np. RapZmSum(.T.,"zmienna1, zmienna3"), gdzie .T. podobnie do RapZm oznacza raport bieżący |
VG(<zmienna>) | czytaj zmienną |
VP(<zmienna>, <wartosc>) | zapisz do zmiennej |
VS(<zmienna>, <wartosc>) | zapisz do zmiennej sumę zmiennej i wartości |
Parametryzacja. W kolumnie "Wartość" można zapisać słowo kluczowe parametr, które spowoduje wywołanie okienka z zapytaniem o wartość parametru. Przewidziano zastosowanie do dziewięciu różnych parametrów oznaczonych kolejnymi cyframi, np. parametr1, parametr8.
Przykładowe raporty definiowane w programie:
Raporty definiowane umożliwiają nie tylko wydruk wybranych danych, ale również ich eksport, tak samo jak wszystkie wydruki. Eksport wykonuje się poprzez wydruk do pliku w wybranym formacie. Często stosuje się pliki z rozszerzeniem „csv” dla danych obrabianych w programie Excel lub „htm” w każdym innym, np. Open Office. Raporty definiowane tylko na początku sprawiają wrażenie trudnych w obsłudze.
Stosując odpowiednią definicję XML można eksportować i importować definicje raportów, a konkretne przykłady znajdują się w katalogu \BR\PROGRAMY\HELP i na stronie: Baza Raportów Definiowanych. Raporty mogą zawierać notatki. Notatka drukowana umieszczana jest pod zestawieniem, a notatkę nie drukowaną można wykorzystać do umieszczenia własnych informacji lub jako treść wiadomości e-mail w funkcji Raport() systemu alertowania.
- ↑ Harbour Reference Guide. [dostęp 2018-02-14].Błąd Lua: Nie można utworzyć procesu: proc_open(/dev/null): Failed to open stream: Operation not permittedkBłąd Lua: Nie można utworzyć procesu: proc_open(/dev/null): Failed to open stream: Operation not permitted spis funkcji w j. ang.