Drukuj      Otwórz Pomoc bezpośrednią w wersji PDF


Previous Topic

Next Topic

Określanie filtrów dotyczących osadzonych raportów i pulpitów - informacje

Można osadzać raporty i pulpity w niestandardowych apletach i kartach internetowych. Można również skonfigurować pola łączy internetowych służących do otwierania raportów i pulpitów.

Podczas tworzenia niestandardowego apletu internetowego, karty internetowej lub łącza internetowego o typie "Raport" lub "Pulpit" można określić filtry, które zostaną zastosowane w trybie wykonawczym. W przypadku pulpitu określone filtry mają zastosowanie do wszystkich raportów na pulpicie.

Każda z kolumn określonych w filtrach musi mieć także odpowiednio skonfigurowany filtr w raporcie do osadzenia. W przypadku osadzania pulpitu kolumna musi mieć odpowiednio skonfigurowany filtr w każdym z raportów na pulpicie. Filtr w raporcie można ustawić na wartość "jest monitowane" lub skonfigurować przy użyciu operatora i wartości. Jeśli filtr nie jest skonfigurowany dla kolumny w raporcie, filtr określony przez użytkownika dla tej kolumny w aplecie internetowym, karcie internetowej lub łączu internetowym nie zostanie zastosowany podczas uruchomienia raportu. Informacje o dodawaniu filtrów do kolumn w raportach są dostępne pod hasłem Dodawanie filtrów do kolumn w analizach.

UWAGA: Podczas tworzenia niestandardowego apletu internetowego, karty internetowej lub łącza internetowego typu "Raport" można opcjonalnie określić, by wszelkie monity zdefiniowane dla raportu osadzonego były wyświetlane w czasie uruchomienia, zaznaczając pole wyboru "Wyświetlanie monitów raportów". Wyświetlanie monitów w czasie uruchomienia umożliwia użytkownikom filtrowanie raportu. Ustawienie w polu wyboru "Wyświetlanie monitów raportów" ma pierwszeństwo przed wszystkimi filtrami zdefiniowanymi w polu "Parametry" odnoszącymi się do osadzonego raportu lub pulpitu. Dlatego też, jeżeli zaznaczono pole wyboru "Wyświetlanie monitów raportów" dla niestandardowego apletu internetowego, karty internetowej lub łącza internetowego, wszelkie filtry zdefiniowane w polu "Parametry" w sposób opisany w tym temacie są ignorowane, nawet jeśli w odniesieniu do osadzonego raportu nie zdefiniowano żadnych monitów.

Składnia określania filtrów

Parametry filtrów można określać na następujące sposoby:

  • Korzystając z parametrów Pn określanych jako składnia Pn.
  • Korzystając z grup parametrów opn, coln i valn określanych jako składnia opn.

Nie można mieszać ze sobą tych dwóch typów składni.

Korzystając ze składni Pn, można określić maksymalnie sześć filtrów. W parametrze P0 należy określić liczbę filtrów do skonfigurowania. Prawidłowe wartości parametru P0 to liczby całkowite od 1 do 6. Parametru P0 można użyć tylko raz w ciągu parametrów. Każdy filtr wykorzystuje trzy parametry zawierające operator, kolumnę i wartość. Pierwszy filtr określa się w parametrach P1-P3. P1 musi określać operator, P2 - kolumnę, a P3 - wartość. Kolejne filtry określa się w zestawach trzech parametrów, tj. P4-P6, P7-P9, P10-P12, P13-P15 i P16-P18. Do oddzielania parametrów służy znak ampersandu (&). Każdego parametru można użyć tylko raz w ciągu parametrów.

W przypadku pojedynczego filtra składnia jest następująca, ale parametry w ramach ciągu można ustawić w dowolnej kolejności:

P0=1&P1=operator&P2=tabela.kolumna&P3=wartość

Aby określić dodatkowe filtry, należy dodać parametry P4-P6, P7-P9 itd. i zwiększyć wartość parametru P0, tak aby była zgodna z liczbą dodanych filtrów. W przypadku dwóch filtrów składnia będzie więc następująca:

P0=2&P1=operator&P2=tabela.kolumna&P3=wartość&P4=operator&P5=tabela.kolumna&P6=wartość

Przy wykorzystaniu składni opn nie ma limitu liczby filtrów, które można określić. W każdym filtrze używana jest grupa trzech parametrów: parametr opn służy do określania operatora, parametr coln służy do określania kolumny, a parametr valn służy do określania wartości. Do oddzielania parametrów służy znak ampersandu (&). Każdy parametr w grupie filtrów należy oznaczyć tą samą liczbą całkowitą większą od 0 (zera). Należy również kolejno ponumerować grupy parametrów. W przypadku pojedynczego filtra składnia jest następująca, ale parametry w ramach ciągu można ustawić w dowolnej kolejności:

op1=operator&col1=tabela.kolumna&val1=wartość

Podobnie w przypadku dwóch filtrów składnia będzie następująca:

op1=operator&col1=tabela.kolumna&val1=wartość&op2=operator&col2=tabela.kolumna&val2=wartość

UWAGA: Jeśli w parametrze kolumny nazwa tabeli lub nazwa kolumny zawiera znak spacji, należy ująć ją w cudzysłów. Jeśli nazwa tabeli lub nazwa kolumny nie zawiera znaku spacji, nie trzeba ujmować jej w cudzysłów, ale można to zrobić. Zasady te obowiązują w obydwu typach składni.

Parametr "Page"

Podczas osadzania pulpitu można także opcjonalnie użyć parametru "Page" do określenia, która strona pulpitu będzie otwierana podczas jego renderowania. Składnia parametru strony jest następująca:

Page=nazwa strony

gdzie nazwa strony oznacza nazwę strony wyświetlaną na pulpicie. Nie należy ujmować nazwy strony w cudzysłów, nawet jeśli nazwa zawiera jedną spację lub większą ich liczbę. Można określić sam parametr strony lub razem z innymi parametrami. Parametr strony można umieścić w dowolnym miejscu w ciągu parametrów, ale należy użyć znaku ampersandu (&) do oddzielenia parametru strony od innych parametrów występujących przed nim lub za nim.

Poprawność parametru strony nie jest sprawdzana podczas zapisywania parametrów. Jeśli parametr strony nie zostanie uwzględniony lub jeśli zostanie uwzględniony, ale jego wartość pozostanie pusta, podczas renderowania pulpitu zostanie otwarta pierwsza strona pulpitu. Jeśli zostanie określona wartość inna niż prawidłowa nazwa strony na wybranym pulpicie, w czasie uruchomienia zostanie wyświetlony błąd.

Znaki specjalne w parametrach - informacje

Jeśli nazwa tabeli, nazwa kolumny, wartość lub nazwa strony pulpitu określona przez użytkownika w parametrze zawiera dowolny z poniższych znaków, musi on być zakodowany w następujący sposób:

  • % (znak procentu). Należy zakodować jako %25.
  • & (ampersand). Należy zakodować jako %26.
  • [ (lewy nawias). Należy zakodować jako %5B.
  • ] (prawy nawias). Należy zakodować jako %5D.
  • + (znak plus). Należy zakodować jako %2B.

Jeśli znaki te nie zostaną zakodowane, może zostać zwrócony błąd podczas próby zapisania tych parametrów lub wyniki mogą być niepoprawne w czasie uruchomienia.

Sprawdzanie poprawności parametrów

Z wyjątkiem parametru strony poprawność parametrów określanych przez użytkownika jest sprawdzana podczas próby zapisania wprowadzonych zmian. W przypadku wykrycia błędów należy je naprawić przed zapisaniem zmian.

UWAGA: W wydaniach wcześniejszych niż wydanie 40 poprawność parametrów filtrów nie była sprawdzana przed ich zapisaniem. Z tego względu parametr filtra określony dla osadzonego raportu lub pulpitu w wydaniu wcześniejszym niż wydanie 40 może zawierać błąd. Jeśli podczas renderowania osadzonego raportu lub pulpitu zostaną wykryte błędy w składni filtra, pojawi się komunikat o błędzie. Ponadto, jeśli użytkownik dokona edycji istniejącego pola apletu internetowego, karty internetowej lub łącza internetowego typu "Raport" lub "Pulpit" i jeśli wprowadzi zmianę w dowolnym polu, podczas próby zapisania zmian wszystkie pola, łącznie z polem "Parametry", zostaną poddane sprawdzaniu poprawności. W przypadku wykrycia błędów należy je naprawić.

W poniższych sekcjach opisano parametry składające się na filtr.

Operator

Poniższa tabela zawiera listę operatorów dostępnych do użytku w filtrze.

Operator

Opis

eq

Równe lub zawiera się w

neq

Nie jest równe ani nie zawiera się w

lt

Mniejsze niż

gt

Większe niż

ge

Większe niż lub równe

le

Mniejsze niż lub równe

bwith

Zaczyna się od

ewith

Kończy się na

cany

Zawiera którekolwiek. Parametr wartości może mieć wiele wartości rozdzielonych znakiem plus (+). Korzystając ze składni Pn, należy określić liczbę wartości na początku listy wartości. Korzystając ze składni opn, nie należy określać liczby wartości. W przeciwnym razie w aplikacji Oracle CRM On Demand zostanie przyjęte, że podana liczba jest jedną z wartości.

Na przykład, aby wyszukać regiony podmiotów "Wschód", "Zachód" i "Centralny" (czyli trzy regiony):

P0=1&P1=cany&P2="Podmiot"."Region podmiotu"&P3=3+Wschód+Zachód+Centralny

lub:

op1=cany&col1="Podmiot"."Region podmiotu"&val1=Wschód+Zachód+Centralny

call

Zawiera wszystkie. Parametr wartości może mieć wiele wartości rozdzielonych znakiem plus (+). Korzystając ze składni Pn, należy określić liczbę wartości na początku listy wartości. Korzystając ze składni opn, nie należy określać liczby wartości. W przeciwnym razie w aplikacji Oracle CRM On Demand zostanie przyjęte, że podana liczba jest jedną z wartości.

like

Podobne do. Parametr wartości musi zawierać wartość. Ciąg wartości musi kończyć się wieloznacznikiem % (znakiem procentu). W przeciwnym razie operator "like" zwróci tylko dokładne dopasowania dla ciągu znaków. Znak procentu należy zakodować jako %25.

Przykładowo, aby znaleźć nazwy podmiotów podobne do Acme:

P0=1&P1=like&P2="Podmiot"."Nazwa podmiotu"&P3=Acme%25

lub:

op1=like&col1="Podmiot"."Nazwa podmiotu"&val1=Acme%25

top

Pierwsze n pozycji. Przykładowo, aby znaleźć pierwsze 6 pozycji przychodów ze sprzedaży:

P0=1&P1=top&P2="Podmiot"."Przychód z podmiotu"&P3=6

lub:

op1=top&col1="Podmiot"."Przychód z podmiotu"&val1=6

bottom

Ostatnie n pozycji. Przykładowo, aby znaleźć ostatnie 4 pozycje przychodów ze sprzedaży:

P0=1&P1=bottom&P2="Podmiot"."Przychód z podmiotu"&P3=4

lub:

op1=bottom&col1="Podmiot"."Przychód z podmiotu"&val1=4

bet

Pomiędzy. Parametr wartości musi mieć dwie wartości rozdzielone znakiem plus (+). Korzystając ze składni Pn , należy określić liczbę wartości (2) na początku listy wartości. Korzystając ze składni opn, nie należy określać liczby wartości. W przeciwnym razie w aplikacji Oracle CRM On Demand zostanie przyjęte, że podana liczba jest jedną z wartości.

Na przykład, aby odfiltrować przychód z podmiotu o wartości od 100 000 do 500 000:

P0=1&P1=bet&P2="Podmiot"."Przychód z podmiotu"&P3=2+100000+500000

lub:

op1=bet&col1="Podmiot"."Przychód z podmiotu"&val1=100000+500000

null

Ma wartość Null. Parametr wartości musi mieć wartość 0 (zero) i nie może zostać pominięty.

nnull

Nie ma wartości Null. Parametr wartości musi mieć wartość 0 (zero) i nie może zostać pominięty.

Kolumna

Podczas określania kolumny należy zwrócić uwagę na następujące kwestie:

  • Należy podać nazwę tabeli i nazwę kolumny rozdzielone za pomocą kropki (.).
  • Jeśli nazwa tabeli lub nazwa kolumny zawiera spację, należy ująć tę nazwę w cudzysłów. Jeśli nazwa tabeli lub nazwa kolumny nie zawiera znaku spacji, nie trzeba ujmować jej w cudzysłów, ale można to zrobić. Zasady te obowiązują w obydwu typach składni. Na przykład wszystkie następujące wartości są prawidłowe:

    "Podmiot"."Nazwa podmiotu"

    "Zlecenie SR".Obszar

    Podmiot."Nazwa podmiotu"

  • Należy użyć pierwotnych nazw kolumn, nie wyświetlanych nazw.

Wartość

Podczas określania wartości filtra należy uwzględnić następujące uwagi:

  • Można określić wartość bezpośrednio lub w postaci parametru.
  • Jeśli użytkownik korzysta ze składni opn i bezpośrednio podaje wartość zawierającą spację, wartość ta musi być ujęta w cudzysłów. Jeśli podawana jest więcej niż jedna wartość, a co najmniej jedna z nich zawiera spację, każda z podawanych wartości musi być ujęta w cudzysłów, na przykład:

    val1="Nowy Jork"+"Alabama"+"Kalifornia"

    Jeśli użytkownik korzysta ze składni Pn, nie musi ujmować w cudzysłów wartości zawierającej spację.

  • Aby uwzględnić pole użytkownika lub systemowe w parametrze filtrowania, należy umieścić kursor w polu "Parametry" w miejscu, w którym ma zostać dodany parametr, i wybrać pole, które ma zostać uwzględnione z listy "Pola użytkownika i systemowe".

    Więcej informacji o polach użytkownika i systemowych, których można użyć w parametrach, można znaleźć pod hasłem Pola użytkownika i systemowe.

  • (tylko aplety internetowe dla stron szczegółów typu rekordu i łącza internetowe) Aby uwzględnić pole z typu rekordu w parametrze filtrowania, należy umieścić kursor w polu "Parametry" w miejscu, w którym ma zostać dodane pole, a następnie wybrać pole z listy pól typ rekordu, gdzie typ rekordu to nazwa typu rekordu, dla którego jest tworzony aplet.

    Przykładowo, jeśli na liście pól typu rekordu wybrano pole "ID wiersza", zostanie wstawiona wartość %%%Row_Id%%%. W trybie wykonawczym parametr %%%Row_Id%%% jest zastępowany identyfikatorem wiersza bieżącego rekordu.

UWAGA: Adres URL raportu lub pulpitu jest generowany w trybie wykonawczym. Długość adresu URL raportu lub pulpitu może być różna w zależności od wartości przekazywanych do adresu URL przez filtry w trybie wykonawczym. Każda przeglądarka zezwala na pewną maksymalną długość adresu URL. Jeśli adres URL raportu lub pulpitu przekracza tę długość, użytkownicy mogą doświadczyć nieprzewidywalnego działania przeglądarki.

UWAGA: Parametry raportu, pulpitu lub strony pulpitu w ramach czynności "Wyślij wiadomość e-mail" w zaplanowanym zdarzeniu dotyczącym analiz można określić w ten sam sposób, w jaki określono parametry osadzonego raportu lub pulpitu w aplecie, karcie lub łączu internetowym. Nie można jednak wybrać pól do określenia jako wartości parametrów w ramach czynności "Wyślij wiadomość e-mail". Informacje na temat konfigurowania zaplanowanych zdarzeń dotyczących analiz znajdują się pod hasłem Tworzenie zaplanowanych zdarzeń dotyczących analiz.


Opublikowano: Sierpień 2021 Copyright © 2005, 2021, Oracle i/lub spółki powiązane. Legal Notices.