Raportowanie w aplikacji w przestrzeniach zarządzanych

Możesz skonfigurować raporty w aplikacji dla aplikacji wymagających ścisłego zarządzania danymi. Zgodnie z tymi samymi zasadami, których używasz do tworzenia modeli danych aplikacji do użytku w przestrzeniach zarządzanych, możesz przygotować swoją aplikację do obsługi funkcji raportowania w aplikacji. Osiąga się to za pomocą składni uwzględniającej przestrzeń w skrypcie ładowania.

Podczas tworzenia aplikacji w ramach przygotowań do opublikowania w przestrzeni zarządzanej należy wziąć pod uwagę następujące kwestie:

• Szablony można tworzyć przed opublikowaniem aplikacji lub po nim. Jeśli utworzysz szablon przed opublikowaniem, po opublikowaniu zmień połączoną aplikację.

• Lista dystrybucyjna musi zostać dodana do aplikacji przed opublikowaniem aplikacji. Podczas programowania może ona składać się z próbnych źródeł danych, a nie z rzeczywistych źródeł danych. Źródła na liście dystrybucyjnej są przywoływane w skrypcie ładowania, więc skrypt musi zostać napisany w ramach przygotowań do publikacji, przy użyciu składni uwzględniającej przestrzeń. Ta składnia jest domyślnie używana automatycznie, jeśli prześlesz listę dystrybucyjną jako plik źródłowy.

• Po opublikowaniu zasoby raportowania — szablon, filtry i zadania raportowania — można odtworzyć w dowolny sposób, w zależności od przypadku użycia raportowania dla opublikowanej aplikacji. Rzeczywiste źródła danych używane na liście dystrybucyjnej powinny zostać dodane do przestrzeni zarządzanej.

Istniejące konfiguracje raportów

Jeśli konfiguracja raportowania i lista dystrybucyjna zostały utworzone przed 26 marca 2024 r., musisz mieć świadomość zmian w procesie przesyłania plików dla list dystrybucyjnych.

W przypadku aplikacji utworzonych przed 26 marca 2024 r. plik źródłowy listy dystrybucyjnej przesłany w sekcji Raportowanie był automatycznie zmieniany i dodawany do przestrzeni. Odwołanie do tego pliku o zmienionej nazwie było następnie automatycznie dodawane do skryptu ładowania. Przesłany plik źródłowy nie ma już zmienianej nazwy po dodaniu do przestrzeni.

Aby kontynuować korzystanie z istniejących konfiguracji raportów podczas publikowania tych aplikacji, postępuj zgodnie z odpowiednią sekcją poniżej, w zależności od źródeł listy dystrybucyjnej. Alternatywnie możesz odtworzyć konfigurację raportowania od podstaw, korzystając z przewodników przedstawionych w dalszej części tej strony.

Jeśli przesłano plik źródłowy

Otwórz Edytor ładowania danych i spójrz na odwołania do nazw plików w sekcji skryptu Lista dystrybucyjna. Dostosuj składnię tak, aby używała odwołania uwzględniające przestrzeń, wskazującego na bieżącą przestrzeń, a nie na żadną konkretną przestrzeń. Na przykład odwołanie do pliku może wyglądać następująco:

FROM "lib://DataFiles/reporting_source_your_app_ID.xlsx"

Zmień to na:

FROM "lib://:DataFiles/reporting_source_your_app_ID.xlsx"

Widać, że identyfikator aplikacji źródłowej jest zawarty w nazwie pliku. Jeśli chcesz, aby ten konkretny skrypt został uruchomiony podczas publikowania aplikacji, dodaj rzeczywisty plik listy dystrybucyjnej do przestrzeni zarządzanej pod tą dokładną nazwą.

Alternatywnie możesz zmienić nazwę pliku źródłowego w przestrzeni programistycznej, zaktualizować skrypt ładowania, a następnie opublikować. Na koniec dodaj rzeczywisty plik listy dystrybucyjnej ze zaktualizowaną nazwą.

Jeśli zdalne źródła danych zostały użyte ręcznie w skrypcie

Jeśli zamiast tego ręcznie skonfigurowano skrypt ładowania, aby opierał się na innych źródłach danych dla listy dystrybucyjnej, wystarczy dostosować skrypt ładowania, aby zawierał względne, uwzględniające przestrzeń odwołania do źródeł danych (jeśli jeszcze tego nie zrobiono).

Aby uzyskać więcej informacji i konkretne przykłady, zobacz Źródła danych dla aplikacji w przestrzeniach zarządzanych.

Przepływ pracy

Postępuj zgodnie z poniższą sekwencją, aby pracować z raportowaniem w aplikacji w przestrzeni zarządzanej.

Tworzenie aplikacji

Opracuj aplikację w swojej przestrzeni programistycznej (przestrzeni osobistej lub udostępnionej), tak jak zwykle, w ramach przygotowań do opublikowania jej w przestrzeni zarządzanej.

Tworzenie szablonów i filtrów

W razie potrzeby możesz utworzyć szablony raportów i filtry przed opublikowaniem aplikacji. Może to być pomocne jako etap tworzenia aplikacji, ale szablony i filtry dodane do aplikacji źródłowej nie są zachowywane w opublikowanej kopii.

Jeśli utworzysz szablony przed opublikowaniem i chcesz ich użyć w opublikowanej aplikacji, zmień połączoną aplikację Qlik Sense dla szablonów. W przypadku szablonów Excel, PowerPoint i Word możesz wykonać tę czynność w dodatku. Alternatywnie wykonaj tę czynność w aplikacji Qlik Sense podczas przesyłania szablonów do opublikowanej aplikacji. Zobacz Zmiana połączonej aplikacji Qlik Sense.

Przygotowanie odwołania do listy dystrybucyjnej

Po dodaniu listy dystrybucyjnej do aplikacji skrypt ładowania aplikacji ulega zmianie. Skrypt ładowania aplikacji nie jest dostępny w opublikowanej aplikacji. Dlatego przed opublikowaniem aplikacji należy dodać do niej listę dystrybucyjną.

Na tym etapie lista dystrybucyjna musi być po prostu symbolem zastępczym dla rzeczywistego pliku lub innych źródeł, których użyjesz dla listy dystrybucyjnej w przestrzeni zarządzanej.

Procedura jest nieco inna w zależności od tego, czy lista dystrybucyjna jest plikiem źródłowym, czy zdalnym źródłem danych dodanym ręcznie w skrypcie. Jednak podstawowe koncepcje są takie same. Pełny przewodnik opisujący sposób używania składni uwzględniającej przestrzeń w skrypcie ładowania można znaleźć w sekcji Źródła danych dla aplikacji w przestrzeniach zarządzanych.

Opcja 1: Bezpośrednie przesłanie pliku źródłowego

Postępuj zgodnie ze standardową procedurą przesyłania pliku źródłowego jako listy dystrybucyjnej: Dodawanie listy dystrybucyjnej poprzez przesłanie pliku źródłowego.

Zamiast dodawać ostateczne dane odbiorcy, możesz wstawić dowolne symbole zastępcze. Ważne jest tutaj to, aby przesłać plik, a plik ten zostanie następnie automatycznie dodany do przestrzeni programistycznej i przywołany w skrypcie.

Możesz sprawdzić, czy sekcja Distribution List w skrypcie ładowania zawiera odwołanie do pliku uwzględniające przestrzeń i nie odwołuje się bezpośrednio do żadnej konkretnej przestrzeni. Odbywa się to automatycznie po przesłaniu pliku źródłowego jako listy dystrybucyjnej w sekcji Raportowanie aplikacji. Powinno to wyglądać mniej więcej tak:

FROM "lib://:DataFiles/My_App_Distribution_List.xlsx"

Ten przykład to odwołanie uwzględniające przestrzeń, które wskazuje na bieżącą przestrzeń, w której znajduje się aplikacja. Dodatkowy dwukropek przed DataFiles zapewnia wymagane odwołanie względne.

Później, podczas publikowania aplikacji w przestrzeni zarządzanej, prześlij rzeczywisty plik listy dystrybucyjnej do przestrzeni zarządzanej. Rzeczywista lista dystrybucyjna musi mieć taką samą nazwę pliku jak plik, do którego odwołuje się skrypt.

Opcja 2: Ręczne odwołanie do źródeł danych w skrypcie

Postępuj zgodnie ze standardową procedurą ręcznego łączenia się ze zdalnymi źródłami listy dystrybucyjnej w skrypcie: Ręczne definiowanie listy dystrybucyjnej w skrypcie ładowania.

Pisząc skrypt w celu połączenia z wymaganymi źródłami danych dla listy dystrybucyjnej, możesz w razie potrzeby użyć próbnych odwołań do plików i połączeń. W skrypcie źródła danych muszą po prostu mieć takie same nazwy, jakie będą miały w przestrzeni zarządzanej, a odwołania do tych źródeł muszą używać względnej składni uwzględniającej przestrzeń.

Publikowanie aplikacji

Po przygotowaniu skryptu ładowania i listy dystrybucyjnej aplikacja jest gotowa do opublikowania w przestrzeni zarządzanej. Aby uzyskać więcej informacji na temat publikowania aplikacji, zobacz Publikowanie aplikacji.

Tworzenie filtrów na poziomie obiektu

Jeśli szablon używa filtrów na poszczególnych obiektach raportu (zobacz Używanie filtrów na poziomie obiektu w szablonach raportów), musisz utworzyć odpowiednie filtry raportu w opublikowanej aplikacji przed przesłaniem jakiegokolwiek szablonu, który używa tych filtrów. Tworzone filtry raportu muszą mieć nazwy zgodne z nazwami w aplikacji źródłowej.

Zmiana połączonej aplikacji Qlik Sense

Jeśli utworzono szablon raportu przed opublikowaniem aplikacji, należy zaktualizować szablon, aby odwoływał się do prawidłowego identyfikatora aplikacji. Opublikowana kopia aplikacji będzie miała inny identyfikator aplikacji niż aplikacja źródłowa.

Ten proces można wykonać automatycznie w Qlik Sense podczas przesyłania szablonu. W przypadku formatów szablonów opartych na Microsoft Office — Excel, PowerPoint lub Word — można to również zrobić w odpowiednim dodatku. Przed rozpoczęciem możesz utworzyć oddzielną kopię szablonu, aby odróżnić go od szablonu dla aplikacji źródłowej.

Pełne instrukcje można znaleźć w:

• Z poziomu Qlik Sense: Zmiana połączonej Qlik Sense aplikacji

• Z poziomu dodatków Qlik dla Microsoft Office: Zmiana połączonej aplikacji Qlik Sense

Zawsze można tworzyć i aktualizować szablony bezpośrednio w przestrzeni zarządzanej.

Dodawanie rzeczywistych źródeł listy dystrybucyjnej

W przestrzeni zarządzanej utwórz wymagane pliki i połączenia potrzebne do załadowania listy dystrybucyjnej, zgodnie z odwołaniami w skrypcie ładowania. Ten krok można wykonać w dowolnym momencie.

Źródła danych dostarczające listę dystrybucyjną muszą zawierać te same nazwy parametrów (nazwy połączeń, plików i pól) co źródła listy dystrybucyjnej używane w skrypcie ładowania aplikacji źródłowej.

Po dodaniu połączonych źródeł do przestrzeni powinno być możliwe ponowne załadowanie aplikacji.

Tworzenie nowych zasobów raportowania

Możesz teraz dodać zasoby raportowania do aplikacji. Mogą to być szablony, filtry i zadania raportowania.

Uprawnienia

Aby pracować z raportowaniem w aplikacji dla aplikacji w przestrzeniach zarządzanych, potrzebujesz:

• Uprawnienia przypisane Tobie przez administratora dzierżawy. Aby uzyskać więcej informacji, administrator może zapoznać się z Ustawianie uprawnień dla funkcji raportowania z mierzeniem.

• Jednej z następujących ról przestrzeni w przestrzeni zarządzanej:

  • Właściciel

  • Może zarządzać

  • Może obsługiwać

  InformacjaW przypadku subskrypcji opartych na użytkownikach rola Może obsługiwać wymaga również uprawnienia użytkownika Professional.

Więcej informacji o uprawnieniach w przestrzeniach zarządzanych na potrzeby raportowania zawiera temat Uprawnienia Usługa raportowania Qlik.

Ograniczenia