OBIEE - zmienne
W OBIEE są dwa typy powszechnie używanych zmiennych -
- Zmienne repozytorium
- Zmienne sesji
Oprócz tego możesz także zdefiniować zmienne prezentacji i żądania.
Zmienne repozytorium
Zmienna repozytorium ma w dowolnym momencie jedną wartość. Zmienne repozytorium są definiowane za pomocą narzędzia Oracle BI Administration. Zmiennych repozytorium można używać zamiast stałych w Kreatorze konstruktora wyrażeń.
Istnieją dwa typy zmiennych repozytorium -
- Statyczne zmienne repozytorium
- Dynamiczne zmienne repozytorium
Statyczne zmienne repozytorium są definiowane w oknie dialogowym zmiennych, a ich wartość istnieje do czasu ich zmiany przez administratora.
Statyczne zmienne repozytorium zawierają domyślne inicjatory, które są wartościami liczbowymi lub znakowymi. Ponadto za pomocą Konstruktora wyrażeń można wstawić stałą jako domyślny inicjator, na przykład datę, godzinę itp. Nie można użyć żadnej innej wartości ani wyrażenia jako domyślnego inicjatora dla statycznej zmiennej repozytorium.
W starszych wersjach BI narzędzie Administrator nie ograniczało wartości zmiennych statycznych repozytorium. Możesz otrzymać ostrzeżenie podczas sprawdzania spójności, jeśli twoje repozytorium zostało zaktualizowane ze starszych wersji. W takim przypadku zaktualizuj statyczne zmienne repozytorium, aby domyślne inicjatory miały stałą wartość.
Dynamiczne zmienne repozytorium są takie same jak zmienne statyczne, ale wartości są odświeżane przez dane zwracane z zapytań. Definiując zmienną repozytorium dynamicznego, tworzysz blok inicjalizacji lub używasz istniejącego wcześniej, który zawiera zapytanie SQL. Możesz również ustawić harmonogram, według którego Oracle BI Server będzie wykonywał zapytanie i okresowo odświeżał wartość zmiennej.
Kiedy zmienia się wartość zmiennej dynamicznego repozytorium, wszystkie wpisy pamięci podręcznej powiązane z modelem biznesowym są automatycznie usuwane.
Każde zapytanie może odświeżyć kilka zmiennych: jedną zmienną dla każdej kolumny w zapytaniu. Planujesz wykonanie tych zapytań przez serwer Oracle BI.
Dynamiczne zmienne repozytorium są przydatne do definiowania zawartości logicznych źródeł tabel. Załóżmy na przykład, że masz dwa źródła informacji o zamówieniach. Jedno źródło zawiera aktualne zamówienia, a drugie dane historyczne.
Utwórz zmienne repozytorium
W narzędziu administracyjnym → Idź do Zarządzaj → Wybierz zmienne → Menedżer zmiennych → Idź do akcji → Nowy → Repozytorium> Zmienna.
W oknie Zmienna wpisz nazwę zmiennej (Nazwy wszystkich zmiennych powinny być unikalne) → Wybierz typ zmiennej - Statyczna lub Dynamiczna.
Jeśli wybierzesz zmienną dynamiczną, użyj listy bloków inicjalizacji, aby wybrać istniejący blok inicjalizacji, który będzie używany do odświeżania wartości w sposób ciągły.
Aby utworzyć nowy blok inicjalizacyjny → Kliknij Nowy. Aby dodać domyślną wartość inicjatora, wpisz wartość w polu domyślnego inicjatora lub kliknij przycisk Konstruktora wyrażeń, aby użyć Konstruktora wyrażeń.
W przypadku zmiennych repozytorium statycznego wartość określona w domyślnym oknie inicjatora jest zachowana. Nie zmieni się, dopóki go nie zmienisz. Jeśli zainicjujesz zmienną przy użyciu ciągu znaków, umieść go w pojedynczych cudzysłowach. Statyczne zmienne repozytorium muszą mieć domyślne inicjatory, które są stałymi wartościami. → Kliknij OK, aby zamknąć okno dialogowe.
Zmienne sesji
Zmienne sesyjne są podobne do dynamicznych zmiennych repozytorium i pobierają swoje wartości z bloków inicjalizacyjnych. Gdy użytkownik rozpoczyna sesję, serwer Oracle BI tworzy nowe wystąpienia zmiennych sesji i inicjuje je.
Istnieje tyle wystąpień zmiennej sesji, ile jest aktywnych sesji na serwerze Oracle BI. Każda instancja zmiennej sesji może mieć inną wartość.
Istnieją dwa typy zmiennych sesji -
- Zmienne sesji systemowej
- Niesystemowe zmienne sesji
Zmienne sesji systemowej są używane przez Oracle BI i serwer prezentacji do określonych celów. Mają wstępnie zdefiniowane zarezerwowane nazwy, których nie mogą używać inne zmienne.
USER |
Ta zmienna zawiera wartość, którą użytkownik wprowadza z nazwą logowania. Ta zmienna jest zwykle wypełniana z profilu LDAP użytkownika. |
USERGUID |
Ta zmienna zawiera globalny unikalny identyfikator (GUID) użytkownika i jest zapełniana z profilu LDAP użytkownika. |
GROUP |
Zawiera grupy, do których należy użytkownik. Jeśli użytkownik należy do wielu grup, nazwy grup należy umieścić w tej samej kolumnie, oddzielając je średnikami (przykład - GrupaA; GrupaB; GrupaC). Jeśli średnik musi być częścią nazwy grupy, poprzedź go znakiem ukośnika odwrotnego (\). |
ROLES |
Ta zmienna zawiera role aplikacji, do których należy użytkownik. Jeśli użytkownik należy do wielu ról, umieść nazwy ról w tej samej kolumnie, oddzielając je średnikami (przykład - Rola A; RolaB; RolaC). Jeśli średnik musi być dołączony jako część nazwy roli, poprzedź go znakiem ukośnika odwrotnego (\). |
ROLEGUIDS |
Zawiera identyfikatory GUID dla ról aplikacji, do których należy użytkownik. Identyfikatory GUID dla ról aplikacji są takie same, jak nazwy ról aplikacji. |
PERMISSIONS |
Zawiera uprawnienia posiadane przez użytkownika. Przykład - oracle.bi.server.manageRepositories. |
Niesystemowe zmienne sesji służą do ustawiania filtrów użytkownika. Na przykład można zdefiniować zmienną niesystemową o nazwie Sale_Region, która zostanie zainicjowana nazwą regionu sale_sprzedaż użytkownika.
Utwórz zmienne sesji
W narzędziu administracyjnym → Idź do Zarządzaj → Wybierz zmienne.
W oknie dialogowym Menedżer zmiennych kliknij opcję Akcja → Nowa → Sesja → Zmienna.
W oknie dialogowym Zmienna sesji wprowadź nazwę zmiennej (nazwy wszystkich zmiennych powinny być unikalne, a nazwy zmiennych sesji systemowych są zarezerwowane i nie mogą być używane dla innych typów zmiennych).
W przypadku zmiennych sesji można wybrać następujące opcje -
Enable any user to set the value- Ta opcja służy do ustawiania zmiennych sesji po zapełnieniu wartości przez blok inicjalizacji. Przykład - ta opcja pozwala osobom niebędącym administratorami ustawić tę zmienną do próbkowania.
Security sensitive - Służy do identyfikowania zmiennej jako wrażliwej na bezpieczeństwo podczas korzystania ze strategii bezpieczeństwa bazy danych na poziomie wiersza, takiej jak wirtualna prywatna baza danych (VPD).
Możesz użyć opcji listy bloków inicjalizacji, aby wybrać blok inicjalizacji, który będzie używany do regularnego odświeżania wartości. Możesz także utworzyć nowy blok inicjalizacyjny.
Aby dodać domyślną wartość inicjatora, wprowadź wartość w polu domyślnego inicjatora lub kliknij przycisk Konstruktora wyrażeń, aby użyć Konstruktora wyrażeń. Kliknij OK, aby zamknąć okno dialogowe.
Administrator może tworzyć niesystemowe zmienne sesyjne za pomocą narzędzia Oracle BI Administration.
Zmienne prezentacji
Zmienne prezentacji są tworzone podczas tworzenia podpowiedzi Dashboardu. Istnieją dwa typy monitów na pulpicie nawigacyjnym, których można użyć -
Monit kolumny
Zmienna prezentacji utworzona za pomocą monitu o kolumnę jest skojarzona z kolumną, a wartości, które może przyjąć, pochodzą z wartości kolumny.
Aby utworzyć zmienną prezentacji, przejdź do okna dialogowego Nowy monit lub Edytuj monit → Wybierz zmienną prezentacyjną w polu Zestaw zmiennej → Wprowadź nazwę zmiennej.
Variable Prompt
Zmienna prezentacyjna utworzona jako podpowiedź zmiennej nie jest powiązana z żadną kolumną i należy zdefiniować jej wartości.
Aby utworzyć zmienną prezentacyjną jako część zachęty do zmiennej, w oknie dialogowym Nowa podpowiedź lub w oknie dialogowym Edytuj podpowiedź → Wybierz zmienną prezentacji w polu Monituj → Wprowadź nazwę zmiennej.
Wartość zmiennej prezentacji jest zapełniana przez kolumnę lub podpowiedź zmiennej, za pomocą której została utworzona. Za każdym razem, gdy użytkownik wybierze wartość w kolumnie lub monicie o zmienną, wartość zmiennej prezentacji jest ustawiana na wartość wybraną przez użytkownika.
Bloki inicjalizacyjne
Bloki inicjalizacyjne służą do inicjalizacji zmiennych OBIEE: zmiennych repozytorium dynamicznego, zmiennych sesji systemowych i zmiennych sesji niesystemowych.
Zawiera instrukcję SQL, która jest wykonywana w celu zainicjowania lub odświeżenia zmiennych powiązanych z tym blokiem. Wykonywana instrukcja SQL wskazuje na fizyczne tabele, do których można uzyskać dostęp za pomocą puli połączeń. Pula połączeń jest definiowana w oknie dialogowym bloku inicjalizacji.
Jeśli chcesz, aby zapytanie dotyczące bloku inicjalizacji zawierało SQL specyficzny dla bazy danych, możesz wybrać typ bazy danych dla tego zapytania.
Zainicjuj zmienne dynamicznego repozytorium przy użyciu bloku inicjalizacji
Domyślne pole łańcucha inicjującego bloku inicjalizacji służy do ustawienia wartości zmiennych dynamicznych repozytorium. Definiujesz również harmonogram, po którym serwer Oracle BI wykonuje zapytanie i odświeża wartość zmiennej. Jeśli ustawisz poziom rejestrowania na 2 lub wyższy, informacje dziennika dla wszystkich zapytań SQL wykonanych w celu pobrania wartości zmiennej są zapisywane w pliku nqquery.log.
Lokalizacja tego pliku na serwerze BI -
ORACLE_INSTANCE \ diagnostics \ logs \ OracleBIServerComponent \ coreapplication_obisn
Zainicjuj zmienne sesji za pomocą bloku inicjalizacji
Zmienne sesyjne również pobierają swoje wartości z bloku inicjalizacji, ale ich wartość nigdy nie zmienia się w odstępach czasu. Gdy użytkownik rozpoczyna nową sesję, serwer Oracle BI tworzy nową instancję zmiennych sesji.
Wszystkie zapytania SQL wykonywane w celu pobrania informacji o zmiennej sesji przez serwer BI, jeśli poziom rejestrowania jest ustawiony na 2 lub wyższy w obiekcie użytkownika programu Identity Manager lub zmienna sesji systemowej LOGLEVEL jest ustawiona na 2 lub wyższą w Variable Manager, są zapisywane w pliku nqquery.log plik.
Lokalizacja tego pliku na serwerze BI -
ORACLE_INSTANCE \ diagnostics \ logs \ OracleBIServerComponent \ coreapplication_obisn
Utwórz bloki inicjalizacyjne w Narzędziu administratora
Idź do Menedżera → Zmienne → Pojawi się okno dialogowe Menedżer zmiennych. Przejdź do menu Akcja → Kliknij Nowy → Repozytorium → Blok inicjalizacyjny → Wprowadź nazwę bloku inicjalizacyjnego.
Przejdź do zakładki Harmonogram → Wybierz datę i godzinę rozpoczęcia oraz interwał odświeżania.
Możesz wybrać następujące opcje bloków inicjalizacyjnych -
Disable- Jeśli wybierzesz tę opcję, blok inicjalizacji zostanie wyłączony. Aby włączyć blok inicjalizacji, kliknij prawym przyciskiem myszy istniejący blok inicjalizacji w Menedżerze zmiennych i wybierz opcję Włącz. Ta opcja umożliwia zmianę tej właściwości bez otwierania okna dialogowego bloku inicjalizacji.
Allow deferred execution - Pozwala to na odroczenie wykonania bloku inicjalizacji do momentu uzyskania dostępu do skojarzonej zmiennej sesji po raz pierwszy podczas sesji.
Required for authentication - Jeśli wybierzesz tę opcję, blok inicjalizacji musi zostać wykonany, aby użytkownicy mogli się zalogować. Użytkownikom odmawia się dostępu do Oracle BI, jeśli blok inicjalizacji nie zostanie wykonany.