Tematy zaawansowane

Można używać parametrów przyrostu daty i dynamicznie definiować nazwę pliku docelowego.

Parametry przyrostu daty

W polach parametrów daty w raporcie można używać wyrażeń.

Jeśli zaplanowany raport zawiera parametry daty, to - jeśli zostały wprowadzone wartości dat w harmonogramie - nie można tych wartości zmienić. Przy każdym zaplanowanym uruchomieniu raportu są używane te same parametry daty. Jeśli dla każdego uruchomienia jest wymagana zmiana parametrów daty, można w polu parametru daty harmonogramu wprowadzić wyrażenie, obliczające datę przy każdym uruchomieniu raportu.

Na przykład, jeśli raport, zaplanowany do uruchomienia w każdy poniedziałek, pobiera dane z poprzedniego tygodnia, trzeba aktualizować parametry daty tak, aby odpowiadały pierwszemu i ostatniemu dniowi poprzedniego tygodnia.

Do obliczania odpowiednich dat przy zaplanowanym uruchomieniu raportu można użyć poniższych funkcji, stosując podaną składnię:

  • {$SYSDATE()$} - Bieżąca data, tj. systemowa data serwera, na którym działa BI Publisher.

  • {$FIRST_DAY_OF_MONTH()$} - Pierwszy dzień bieżącego miesiąca.

  • {$LAST_DAY_OF_MONTH()$} - Ostatni dzień bieżącego miesiąca.

  • {$FIRST_DAY_OF_YEAR()$} - Pierwszy dzień bieżącego roku.

  • {$LAST_DAY_OF_YEAR()$} - Ostatni dzień bieżącego roku.

Funkcje występujące w wartościach parametrów są obliczane dopiero wtedy, gdy zlecenie raportu jest przetwarzane przez harmonogram.

Można także wprowadzać wyrażenia z użyciem operatorów (+) i (-), umożliwiających dodawanie i odejmowanie dni:

  • {$SYSDATE()+1$}

  • {$SYSDATE()-7$}

Na przykład, aby przy każdym uruchomieniu raportu były pobierane dane z poprzedniego tygodnia, należy w polach parametrów daty raportu wpisać:

  • Od daty: {$SYSDATE()-7$}

  • Do daty: {$SYSDATE()-1$}

Funkcje daty można skonfigurować w modelu danych jako wartości domyślne parametrów. W takim przypadku, przy każdym wyświetleniu raportu przy użyciu przeglądarki raportów, parametry dat będą obliczane na podstawie wyrażeń stanowiących wartości domyślne.

Dynamiczne definiowanie nazwy pliku docelowego przy użyciu wyrażenia daty

Wprowadzając nazwę zdalnego pliku dla folderu internetowego lub miejsca docelowego FTP, można wprowadzić wyrażenie daty, aby dynamicznie dołączać datę do nazwy pliku. Data jest ustawiana w trybie wykonawczym przy użyciu strefy czasowej serwera.

W poniższej tabeli są opisane wyrażenia daty.

Wyrażenie Opis

%y

Wyświetla rok w postaci czterech cyfr; przykład: 2011

%m

Wyświetla miesiąc w postaci dwóch cyfr: 01-12 (gdzie 01 = styczeń)

%d

Wyświetla dzień w postaci dwóch cyfr: 01-31

%H

Wyświetla godzinę w postaci dwóch cyfr w formacie 24-godzinnym: 00 - 24

%M

Wyświetla minutę w postaci dwóch cyfr: 00 - 59

%S

Wyświetla liczbę sekund w postaci dwóch cyfr: 00 - 59

%l

Wyświetla milisekundy w postaci trzech cyfr: 000 - 999

Przykłady

Używając tych przykładów, można utworzyć nazwę pliku, do której jest dołączana data, oraz nazwę pliku zaczynającą się od daty i kończącą się godziną.

Aby utworzyć nazwę pliku, do której są dołączane dzień, miesiąc i rok, taką jak:

myfile_01_11_2010.pdf

wpisać:

myfile_%d_%m_%y.pdf

Aby utworzyć nazwę pliku zaczynającą się od daty i kończącą się godziną, na przykład:

01_01_2010_myfile_22_57.pdf

wpisać:

%d_%m_%y_myfile_%H_%M.pdf

Jeśli nazwa pliku zostanie określona przy użyciu niezdefiniowanych zmiennych, na przykład my_file_%a%b%c.pdf, utworzony plik będzie miał nazwę my_file_%a%b%c.pdf.