Dotyczy wersji 2020.1.3.x autor: Konrad Wojtycza
Wprowadzenie
Mając na uwadze możliwe regionalne wymagania wobec formatu dat i liczb, WEBCON BPS umożliwia kontrolę formatu wyświetlania atrybutów typu Data i godzina oraz Liczba zmiennoprzecinkowa za pomocą konfiguracji wspomnianych atrybutów. Format ich wyświetlania zależy również od ustawień strefy czasowej przeglądarki oraz wybranego języka witryny WEBCON BPS.
Format daty w zależności od konfiguracji
Na poniższych zrzutach ekranu przedstawione zostały konfiguracje atrybutów typu Data oraz efekt tych konfiguracji widoczny na formularzu.
- Wyświetlanie daty
Konfiguracja z Rys. 1 wyświetla na formularzu jedynie datę (Rys. 2).
Rys. 1 Konfiguracja atrybutu Data – wyświetlenie daty
Rys. 2 Widok pola daty przy konfiguracji z Rys. 1, język portalu: angielski (US)
- Wyświetlanie daty i godziny
Po zaznaczeniu checkboxa „Enable time selection” (Rys. 3, ) na formularzu wyświetlana jest data, a także godzina (Rys. 4). W prezentowanym przypadku, jest to godzina dla strefy czasowej UTC.
Rys. 3 Konfiguracja atrybutu Data – wyświetlenie daty i godziny
Rys. 4 Widok pola daty przy konfiguracji z Rys. 3, język portalu: angielski (US)
- Wyświetlanie daty i godziny z uwzględnieniem strefy czasowej
Po dodatkowym zaznaczeniu checkboxa „Use time zone settings” (Rys. 5), na formularzu wyświetlana jest data i godzina (Rys. 6) dla strefy czasowej UTC+2, wg ustawień przeglądarki.
Rys. 5 Konfiguracja atrybutu Data – wyświetlenie daty i godziny z uwzględnieniem strefy czasowej
Rys. 6 Widok pola daty przy konfiguracji z Rys. 5, język portalu: angielski (US)
- Wpływ języka portalu na format atrybutu Typu Data i godzina
Oprócz wyżej wymienionych ustawień, na format wyświetlanej daty mają wpływ także ustawienia języka witryny WEBCON BPS (Rys. 7).
Rys. 7 Ustawienia języka portalu
Na Rys. 8 widoczny jest format daty w przypadku polskiej wersji językowej witryny dla wszystkich wymienionych wcześniej konfiguracji atrybutu typu Data i czas.
Rys. 8 Widok pola Data i czas, wszystkie wymienione wcześniej konfiguracje, język portalu: polski
Rys. 9 Widok pola Data i czas, wszystkie wymienione wcześniej konfiguracje, język portalu: angielski (GB)
- Wyświetlanie daty i godziny w polu tekstowym
Należy pamiętać, że wpływ ustawień przeglądarki i portalu na format wyświetlanej daty dotyczy jedynie faktycznych pól daty. Jeśli pole będzie jedynie tekstem uzupełnianym przez, np. regułę biznesowa korzystającą z zapytania SQL, to format będzie przekazywany za pośrednictwem konfiguracji tej reguły.
Podczas konfiguracji pola tekstowego, jako wartość domyślna może zostać ustawiona sformatowana wartość pola daty (Rys. 10).
Rys. 10 Konfiguracja domyślnej wartości dla pola tekstowego
Na Rys. 11 przedstawiona została prezentacja pół tekstowych z wartościami ustawionymi domyślnie, na podstawie wartości pola „Date of order”.
- Pole „Set date 1” wyświetla wartość pola daty w formatowaniu browser settings (text).
- Pole „Set date 2” wyświetla wartość pola daty w formatowaniu „[User time zone] acc.browser settings (text)”, uwzględniającym strefę czasowa użytkownika.
- Pole „Set date 3” wyświetla wartość pola daty w formacie „ISO (DateTime)”.
- Pole „Set date 4” w formacie „Year”, wyświetlającym jedynie rok.
Rys. 11 Pola tekstowe wyświetlające wartości pola daty w wybranym formacie, język portalu: angielski (US)
Format pola liczbowego w zależności od konfiguracji
Na poniższych zrzutach ekranu przedstawione zostały konfiguracje atrybutów typu Liczba zmiennoprzecinkowa oraz efekt tych konfiguracji widoczny na formularzu.
- Liczba zmiennoprzecinkowa
Konfiguracja z Rys. 12, na formularzu wyświetla liczbę zmiennoprzecinkową z dokładnością do dwóch miejsc po przecinku, dokładność może zostać ustawiona w konfiguracji – pole „Number of decimal places”.
Rys. 12 Konfiguracja atrybutu typu Liczba zmiennoprzecinkowa
Format liczby zmiennoprzecinkowej wyświetlany na formularzu, podobnie jak w przypadku dat, zależy od aktualnie wybranej wersji językowej portalu WEBCON BPS (Rys. 13, Rys. 19).
Rys. 13 Widok atrybutu typu liczba zmiennoprzecinkowa według konfiguracji, język portalu: angielski (US)
- Liczba zmiennoprzecinkowa jako kwota
Po zaznaczeniu checkboxa „Show as amount” (Rys. 14), na formularzu wyświetlana jest liczba zmiennoprzecinkowa jako kwota (Rys. 15).
Rys. 14 Konfiguracja atrybutu typu Liczba zmiennoprzecinkowa, wyświetlająca liczbę jako kwotę
Jeśli wybrana zostanie opcja „Display format: Auto”, format wyświetlanej liczby będzie zgodny z aktualnie wybraną wersją językową portalu WEBCON BPS (Rys. 14).
Rys. 15 Widok atrybutu typu Liczba zmiennoprzecinkowa przy konfiguracji z Rys. 14, język portalu: angielski
W konfiguracji atrybutu typu liczba zmiennoprzecinkowa możliwe jest także uniezależnienie się od zmiany formatu wyświetlania liczby po zmianie wersji językowej witryny. W tym celu, w polu „Display format” należy wybrać jeden z formatów wyświetlania (Rys. 16).
Rys. 16 Konfiguracja umożliwiajaca ustawienie stałego formatu wyświetlania liczby zmiennoprzecinkowej
- Liczba zmiennoprzecinkowa jako kwota z kodem waluty
Po zaznaczeniu checkboxa „Currency code” (Rys. 17), oraz podaniu kodu waluty, na formularzu wyświetlana jest liczba wraz ze wskazanym kodem waluty (Rys. 18). Kod waluty może zostać ustawiony również poprzez użycie Edytora, przekazując wartości z innych pól formularza.
Rys. 17 Konfiguracja atrybutu typu liczba zmiennoprzecinkowa, wyświetlająca liczbę zmiennoprzecinkowa jako kwotę z kodem waluty
Rys. 18 Widok atrybutu typu liczba zmiennoprzecinkowa przy konfiguracji z Rys. 17, język portalu: angielski (US)
Na Rys. 19 widoczny jest format w przypadku polskiej wersji językowej witryny dla wszystkich wymienionych wcześniej konfiguracji atrybutu typu Liczba zmiennoprzecinkowa.
Rys. 19 Widok pola Liczba zmiennoprzecinkowa, wszystkie wymienione wcześniej konfiguracje, język portalu: polski