Filtry użytkownika

W strefach eksploratora danych możliwe jest zdefiniowanie filtrów użytkownika, za pomocą których użytkownik może wprowadzać dane ograniczające wiersze i/lub kolumny wyświetlane w strefie. Filtry można definiować indywidualnie przy użyciu parametrów filtrów użytkownika 1-25. Alternatywnie można zdefiniować odwzorowanie interfejsu użytkownika w celu pobierania filtrów. W tym przypadku pola wartości wejściowych odwzorowania należy powiązać z filtrami strefy poprzez określenie mnemonika xpath= w odpowiednich parametrach filtra użytkownika.

Parametry stosowane w typach stref:

  • Eksplorator danych dotyczących informacji - wiele instrukcji SQL (F1–DE)

  • Eksplorator danych dotyczących zapytania - wiele instrukcji SQL (F1–DE-QUERY)

  • Eksplorator danych dotyczących informacji - jedna instrukcja SQL (F1–DE-SINGLE)

Filtr użytkownika jest definiowany za pomocą następujących mnemoników:

Mnemonik

Opis

Poprawne wartości

Komentarze

name=

Mnemonik używany, gdy filtr strefy powinien zostać wstępnie wypełniony wartością z kontekstu globalnego, kontekstu portalu lub rozesłany z innej strefy.

Nazwa pola danych licznika

datasource=

Określa źródło wstępnie wypełnionej wartości filtra zdefiniowanej w mnemoniku name.

Jeśli ten mnemonik pozostanie pusty, domyślne działanie jest następujące:

- Jeśli pole zostało rozesłane z innej strefy, zostanie użyta rozesłana wartość.

- Jeśli nie rozesłano żadnej wartości, kontekst portalu jest sprawdzany w celu ustalenia, czy to pole istnieje (jeśli tak, pobierana jest jego wartość).

- Jeśli nadal nie ma wartości, sprawdzany jest kontekst globalny.

- Jeśli nadal nie ma wartości, pokazywana jest wartość domyślna.

G

Wskazuje, że wartości filtra w strefie należy wyszukiwać w kontekście globalnym.

P

Wskazuje, że wartości filtra w strefie należy wyszukiwać w kontekście portalu.

D

Wskazuje, że wartości filtra w strefie należy wyszukiwać w modelu danych strony.

type=

Określa wizualną metaforę używaną do pobierania wartości filtra.

DATE

Filtry tego typu służą do pobierania daty.

DATE/TIME

Filtry tego typu służą do pobierania daty i godziny.

STRING

Filtry tego typu służą do pobierania ciągu.

MONEY

Filtry tego typu służą do pobierania pola danych pieniężnych. Ten typ filtra musi odwoływać się także do mnemonika cur.

NUMBER

Filtry tego typu służą do pobierania pola danych liczbowych. Ten typ filtra może odwoływać się także do mnemonika decimals.

LOOKUP

Filtry tego typu służą do pobierania wartości wyszukiwania. Ten typ filtra musi odwoływać się także do mnemonika lookup.

TABLE

Filtry tego typu służą do pobierania wartości tabeli administracyjnej (kod i opis). Ten typ filtra musi odwoływać się także do mnemonika table.

CHARTYPE

Filtry tego typu służą do pobierania predefiniowanych wartości danego typu charakterystyki (kod i opis). Ten typ filtra musi odwoływać się także do mnemonika chartype.

ASIS

Filtry tego typu służą do pobierania listy wartości, do których odwołuje się warunek "IN" w instrukcji SQL.

label=

Określa etykietę filtra wyświetlaną na pasku opisu w strefie i w obszarze danych wejściowych.

Nazwa pola danych licznika

Należy wprowadzić prawidłową nazwę pola, którego etykieta zostanie użyta jako etykieta filtra. Ta opcja powinna być zawsze stosowana, gdy wymagane jest wiele języków.

'text'

Określa tekst w sposób bezpośredni.

cur=

Określa kod waluty zastosowany w przypadku, gdy mnemonik type=MONEY.

Kod waluty

Należy wprowadzić odwołanie do prawidłowego kodu waluty.

dec=

Określa liczbę miejsc dziesiętnych w przypadku, gdy mnemonik type=NUMBER.

Prawidłowy numer

Wartość opcjonalna. W przypadku jej określenia należy wprowadzić liczbę całkowitą. Jeśli nie podano tej wartości, zostanie ustawiona domyślna liczba miejsc dziesiętnych zdefiniowana dla kodu waluty określonego w rekordzie instalacji.

lookup=

Określa znacznik wyszukiwania, którego wartości będą wyświetlane w przypadku, gdy mnemonik type=LOOKUP.

Nazwa pola wyszukiwania

Należy wprowadzić odwołanie do prawidłowej nazwy pola wyszukiwania.

table=

Określa tabelę administracyjną, której wartości będą wyświetlane w przypadku, gdy mnemonik type=TABLE.

Nazwa tabeli

Należy wprowadzić odwołanie do prawidłowej nazwy tabeli kontrolnej.

chartype=

Określa kod typu charakterystyki, którego wartości będą wyświetlane w przypadku, gdy mnemonik type=CHARTYPE.

Kod typu charakterystyki

Należy wprowadzić odwołanie do prawidłowego kodu typu charakterystyki.

xpath=

Mnemonik ten jest używany w połączeniu z odwzorowaniem interfejsu użytkownika obszaru filtra. Dla każdego filtra należy określić ścieżkę xpath do odpowiedniego elementu schematu odwzorowania interfejsu użytkownika.

XPath

Mnemonik type= musi również być dopasowany do pola danych wejściowych odwzorowania. W przeciwnym wypadku zapytanie SQL może zakończyć się niepowodzeniem.

likeable=

Określa sytuację, w której przeprowadzane jest wyszukiwanie wartości zbliżonych do wartości wprowadzonej, gdy mnemonik type=STRING.

S

W zapytaniu zostanie dodany % do sufiksu wartości filtra.

P

W zapytaniu zostanie dodany % do prefiksu wartości filtra.

PS

W zapytaniu zostanie dodany % do prefiksu i sufiksu wartości filtra.

divide=

Od tego mnemonika zależy wyświetlanie linii podziału powyżej i/lub poniżej filtra.

Uwaga: Ten parametr można określić dwukrotnie, jeśli linie podziału mają znajdować się powyżej i poniżej filtra, np. divide=above divide=below.

above

Powoduje umieszczenie linii podziału powyżej filtra.

below

Powoduje umieszczenie linii podziału poniżej filtra.

searchField=

Mnemonik odpowiada za dane wstępnie wstawione do filtra w momencie, gdy strefa jest uruchamiana jako wyszukiwanie z odwzorowania interfejsu użytkownika.

Nazwa pola danych licznika

Należy wprowadzić nazwę pola, która dokładnie odpowiada nazwie pola searchField określonej w elemencie HTML oraSearchField w odwzorowaniu interfejsu użytkownika.

encrypt=

Określa, czy filtr użytkownika jest zaszyfrowany i należy go wyszukiwać na podstawie wartości skróconej.

[TBL_​NAME,FLD_​NAME,WHERE_​FLD,WHERE_​VALUE]

Uwaga: Nazwa pola, do której istnieje odwołanie w tym miejscu, powinna być źródłową wartością pola. Jednak w filtrze instrukcji SQL używana jest wartość skrócona.

Wymagane jest wprowadzenie prawidłowej nazwy tabeli i nazwy pola.

Wartości WHERE_​FLD i WHERE_​VALUE są opcjonalne, ale jeśli wybrano opcję ich wprowadzenia, wymagane jest podanie obydwu z nich. Należy użyć tej opcji tylko do szyfrowania pola, jeśli inne pole ma pewną wartość. Poniżej przedstawiono przykład:

encrypt=[CI_​PERSON,PER_​ID_​NBR,ID_​TYPE_​NBR,'SSN']. Wartość WHERE_​VALUE może też odnosić się do innego filtra. Poniżej przedstawiono przykład:

encrypt=[CI_​PERSON,PER_​ID_​NBR,ID_​TYPE_​NBR,F1].

Przykłady:

  • label=F1_​NBR_​DAYS type=NUMBER

  • label=F1_​SHOW_​ALL_​REQ_​FLG type=LOOKUP lookup=F1_​SHOW_​ALL_​REQ_​FLG

  • Wartość filtra, w której zdefiniowano odwzorowanie interfejsu użytkownika filtra, a pole "Opis" jest jednym z filtrów. type=STRING xpath=description likeable=S

    • type=STRING label=DESCR likeable=S divide=below

    • label=REQ_​TYPE_​CD type=TABLE table=F1_​REQ_​TYPE