Utworzyć aplikację szablonową w usłudze Power BI

Ten artykuł zawiera instrukcje krok po kroku dotyczące tworzenia aplikacji szablonu Power BI. Aplikacje szablonów usługi Power BI umożliwiają partnerom Power BI tworzenie aplikacji Power BI z niewielką ilością kodowania lub bez kodowania oraz wdrażanie ich u dowolnego klienta usługi Power BI.

Jeśli potrafisz tworzyć raporty i pulpity nawigacyjne w usłudze Power BI, możesz zostać twórcą aplikacji szablonów i tworzyć oraz pakować zawartość analityczną do aplikacji. Następnie możesz wdrożyć aplikację w innych dzierżawach Power BI za pośrednictwem dowolnej dostępnej platformy, takiej jak AppSource lub własna usługa internetowa. Jeśli rozpowszechniasz aplikację szablonu za pomocą własnej usługi internetowej, możesz zautomatyzować część procesu instalacji , aby ułatwić klientom wykonywanie zadań.

Administratorzy usługi Power BI nadzorują i kontrolują to, kto w ich organizacji może tworzyć aplikacje szablonowe i kto może je instalować. Autoryzowani użytkownicy mogą instalować aplikację szablonu, modyfikować ją i rozpowszechniać dla użytkowników Power BI w swoich organizacjach.

Wymagania wstępne

Poniżej przedstawiono wymagania dotyczące tworzenia aplikacji szablonu:

Utwórz obszar roboczy szablonu

Aby utworzyć aplikację szablonową, którą można udostępniać innym dzierżawom usługi Power BI, musisz utworzyć ją w obszarze roboczym.

  1. W usługa Power BI utwórz obszar roboczy zgodnie z opisem w temacie Tworzenie obszaru roboczego w Power BI. W sekcji Zaawansowane wybierz pozycję Opracowywanie aplikacji szablonu.

    Zrzut ekranu przedstawiający tworzenie aplikacji z szablonu.

    Ważna

    Pojemność przypisana do obszaru roboczego konstruktora aplikacji nie określa przypisania pojemności obszarów roboczych, w których instalatory aplikacji instalują aplikację. Oznacza to, że aplikacja utworzona w obszarze roboczym z pojemnością Premium nie musi być zainstalowana w obszarze roboczym z pojemnością Premium. W związku z tym nie zaleca się używania pojemności Premium dla obszaru roboczego konstruktora, ponieważ obszary robocze instalatora mogą nie być pojemnością Premium, a funkcjonalność oparta na pojemności Premium nie będzie działać, chyba że instalator ręcznie ponownie przypisze zainstalowany obszar roboczy do pojemności Premium.

    Ważna

    Opcja Tworzenie aplikacji szablonu można wybrać tylko podczas tworzenia obszaru roboczego konstruktora aplikacji. Po zdefiniowaniu obszaru roboczego jako obszaru roboczego konstruktora aplikacji funkcja konstruktora aplikacji nigdy nie może zostać usunięta z obszaru roboczego.

  2. Po zakończeniu tworzenia obszaru roboczego wybierz pozycję Zapisz.

Note

Aby promować aplikacje szablonowe, musisz mieć uprawnienia od administratora usługi Power BI.

Dodaj zawartość do obszaru roboczego aplikacji szablonowej

Podobnie jak w przypadku zwykłego obszaru roboczego Power BI następnym krokiem jest dodanie zawartości do obszaru roboczego. Jeśli używasz parametrów w Power Query, upewnij się, że mają one dobrze zdefiniowane typy, takie jak Text. Typy Any i Binary nie są obsługiwane.

Aby zapoznać się ze wskazówkami, które warto uwzględnić podczas tworzenia raportów i pulpitów dla aplikacji szablonu, zobacz Wskazówki dotyczące tworzenia aplikacji szablonów w usłudze Power BI.

Definiowanie właściwości aplikacji szablonu

Teraz, gdy masz zawartość w obszarze roboczym, możesz spakować ją w aplikacji szablonu. Pierwszym krokiem jest utworzenie aplikacji szablonu testowego dostępnej tylko z poziomu organizacji w dzierżawie.

  1. W obszarze roboczym aplikacji szablonu wybierz pozycję Utwórz aplikację.

    Zrzut ekranu przedstawiający tworzenie aplikacji.

    Następnie uzupełnij dodatkowe opcje aplikacji szablonowej w sześciu kartach.

  2. Na karcie Znakowanie wypełnij następujące pola:

    • Nazwa aplikacji
    • Opis
    • Witryna pomocy technicznej. Link do pomocy technicznej pojawia się w sekcji informacji o aplikacji po ponownym rozpowszechnieniu aplikacji opartej na szablonie jako aplikacji organizacyjnej.
    • Logo aplikacji. Logo może mieć maksymalnie 45 KB, musi mieć proporcje 1:1 i musi być w formacie .png, .jpg lub .jpeg.
    • Kolor motywu aplikacji

    Zrzut ekranu przedstawiający kartę Znakowanie.

  3. Na karcie Nawigacja możesz włączyć pozycję Nowy konstruktor nawigacji , aby zdefiniować okienko nawigacji aplikacji.

    Zrzut ekranu przedstawiający kartę Nawigacja.

    Jeśli nie włączysz opcji Nowy konstruktor nawigacji, możesz wybrać stronę docelową aplikacji. Zdefiniuj raport lub pulpit nawigacyjny jako stronę docelową aplikacji. Użyj strony docelowej, która sprawia takie wrażenie, jakie chcesz.

  4. Na karcie Kontrola ustaw limity i ograniczenia użytkowników aplikacji dotyczące zawartości aplikacji. Za pomocą tej kontrolki możesz chronić własność intelektualną w aplikacji.

    Zrzut ekranu pokazujący kartę Sterowanie.

    Note

    Jeśli chcesz chronić dane, wyłącz opcję Pobierz raport do pliku , a następnie skonfiguruj dwie pozostałe opcje zgodnie z potrzebami.

    Dlaczego:

    Kontrolki widoku, edytowania i eksportowania na tej karcie dotyczą tylko usługa Power BI. Po pobraniu pliku pbix nie będzie on już dostępny w usłudze. Umieszcza kopię danych, niechronionych, w lokalizacji wybranej przez użytkownika. Nie masz już żadnej kontroli nad tym, co użytkownik może z nim zrobić.

    Jeśli chcesz ograniczyć dostęp do zapytań i miar, jednocześnie zezwalając użytkownikom na dodawanie własnych źródeł danych, rozważ sprawdzenie opcji Eksportuj lub na zewnątrz nawiąż połączenie z danymi . Dzięki temu użytkownicy mogą dodawać własne źródła danych bez możliwości edytowania modelu semantycznego. Aby uzyskać więcej informacji, zobacz Używanie modeli złożonych w programie Power BI Desktop.

  5. Parametry są tworzone w oryginalnym pliku pbix (dowiedz się więcej o tworzeniu parametrów zapytania). Możesz użyć możliwości na tej karcie, aby ułatwić instalatorowi aplikacji skonfigurowanie aplikacji po zakończeniu instalacji podczas nawiązywania połączenia z danymi.

    Zrzut ekranu przedstawiający kartę Parametry.

    Każdy parametr ma nazwę, która pochodzi z zapytania i pole Wartość . Podczas instalacji dostępne są trzy opcje pobierania wartości parametru:

    • Możesz wymagać od użytkownika instalującego aplikację podania wartości.

      W takim przypadku podajesz przykład, który użytkownik zastępuje. Aby skonfigurować parametr w ten sposób, zaznacz pole wyboru Wymagane , a następnie podaj przykład w polu tekstowym, który pokazuje użytkownikowi, jakiego rodzaju wartość jest oczekiwana, jak pokazano w poniższym przykładzie.

      Zrzut ekranu przedstawiający wartość parametru wymaganą od użytkownika.

    • Możesz podać wstępnie wypełniną wartość, której użytkownik, który instaluje aplikację, nie może zmienić.

      Parametr skonfigurowany w ten sposób jest ukryty przed użytkownikiem, który instaluje aplikację. Tej metody należy użyć tylko wtedy, gdy masz pewność, że wstępnie wypełniona wartość jest prawidłowa dla wszystkich użytkowników. Jeśli nie, użyj pierwszej metody, która wymaga danych wejściowych użytkownika.

      Aby skonfigurować parametr w ten sposób, wprowadź wartość w polu tekstowym Wartość , a następnie wybierz ikonę blokady, aby nie można było zmienić wartości. W poniższym przykładzie pokazano tę opcję:

      Zrzut ekranu przedstawiający wartość parametru bezwzględnego.

    • Możesz podać wartość domyślną, którą użytkownik może zmienić podczas instalacji.

      Aby skonfigurować parametr w ten sposób, wprowadź żądaną wartość domyślną w polu tekstowym Wartość i pozostaw odblokowaną ikonę blokady, jak w poniższym przykładzie:

      Zrzut ekranu przedstawiający zmienną wartość parametru domyślnego.

    Na tej karcie podasz również link do dokumentacji aplikacji.

  6. Na karcie Uwierzytelnianie wybierz metodę uwierzytelniania do użycia. Dostępne opcje zależą od używanych typów źródeł danych.

    Zrzut ekranu pokazujący kartę „Uwierzytelnianie”.

    Poziom prywatności jest konfigurowany automatycznie:

    • Pojedyncze źródło danych jest automatycznie konfigurowane jako prywatne.
    • Wiele anonimowych źródeł danych jest automatycznie konfigurowane jako publiczne.
  7. W fazie testowania na karcie Dostęp zdecyduj, kto inny w organizacji może zainstalować i przetestować aplikację. Wrócisz i zmienisz te ustawienia później. To ustawienie nie ma wpływu na dostęp do aplikacji szablonu rozproszonego.

    Zrzut ekranu przedstawiający kartę Dostęp.

  8. Wybierz pozycję Utwórz aplikację.

    Zostanie wyświetlony komunikat z linkiem umożliwiającym skopiowanie i udostępnienie aplikacji testerom aplikacji.

    Zrzut ekranu przedstawiający komunikat, że aplikacja testowa jest gotowa.

    Wykonano również pierwszy krok następującego procesu zarządzania wydaniami.

Zarządzaj wydaniem aplikacji opartej na szablonie

Zanim opublikujesz aplikację szablonową, chcesz się upewnić, że aplikacja jest gotowa. W okienku zarządzania Power BI wydaniami możesz śledzić i sprawdzać pełną ścieżkę wydania aplikacji. Możesz również uruchomić przejście między etapami. Typowe etapy to:

  • Wygeneruj aplikację testową do testowania tylko w organizacji.
  • Przenieś pakiet testowy na etap przedprodukcyjny i przetestuj go poza swoją organizacją.
  • Podwyższ poziom pakietu przedprodukcyjnego do wersji produkcyjnej w środowisku produkcyjnym.
  • Usuń dowolny pakiet lub rozpocznij od poprzedniego etapu.

Adres URL nie zmienia się w miarę przechodzenia między etapami wydania. Promocja nie wpływa na sam adres URL.

Aby przejść przez etapy wydania:

  1. W obszarze roboczym szablonu wybierz pozycję Zarządzanie wydaniami.

    Zrzut ekranu przedstawiający usługę Release Management w obszarze roboczym szablonu.

  2. Jeśli wykonano kroki opisane w tym artykule w celu utworzenia aplikacji testowej, kropka obok pozycji Testowanie zostanie już wypełniona. Wybierz Uzyskaj link.

    Jeśli aplikacja nie została jeszcze utworzona, wybierz pozycję Utwórz aplikację , aby rozpocząć proces tworzenia aplikacji szablonu.

    Zrzut ekranu przedstawiający okienko Zarządzanie wydaniami z wyróżnionym linkiem Pobierz.

  3. Aby przetestować środowisko instalacji aplikacji, skopiuj link w oknie i wklej go w nowym oknie przeglądarki.

    W tym miejscu wykonasz tę samą procedurę, którą będą wykonywać instalatory aplikacji. Aby uzyskać więcej informacji, zobacz Instalowanie i dystrybuowanie aplikacji szablonów w organizacji.

  4. W oknie dialogowym wybierz pozycję Zainstaluj.

  5. Po pomyślnym zakończeniu instalacji wybierz aplikację na liście Aplikacje , aby ją otworzyć.

  6. Sprawdź, czy aplikacja testowa ma przykładowe dane. Aby wprowadzić zmiany, wróć do aplikacji w oryginalnym obszarze roboczym. Zaktualizuj aplikację testowa, dopóki nie będziesz zadowolony.

  7. Gdy wszystko będzie gotowe do promowania aplikacji do środowiska przedprodukcyjnego do testowania poza dzierżawcą, wróć do panelu Zarządzanie wydaniami i wybierz pozycję Promuj aplikację.

    Zrzut ekranu przedstawiający panel Zarządzanie wydaniami z wyróżnioną pozycją Promowanie aplikacji.

    Note

    Po podwyższeniu poziomu aplikacji staje się ona publicznie dostępna poza organizacją.

    Jeśli nie widzisz opcji Promuj aplikację, skontaktuj się z administratorem Power BI, aby nadał Ci uprawnienia do tworzenia aplikacji szablonów w portalu administracyjnym.

  8. W oknie dialogowym wybierz pozycję Awansuj.

  9. Skopiuj nowy adres URL, aby udostępnić go poza dzierżawą na potrzeby testowania. Ten link jest również tym, który przesyłasz, aby rozpocząć proces dystrybucji aplikacji w usłudze AppSource, tworząc nową ofertę Centrum partnerskiego.

    Prześlij tylko linki przedprodukcyjne do Centrum partnerskiego. Po zatwierdzeniu aplikacji i otrzymaniu powiadomienia, że została opublikowana w usłudze AppSource, możesz promować pakiet do produkcji w Power BI.

  10. Gdy aplikacja jest gotowa do wdrożenia produkcyjnego lub udostępnienia za pośrednictwem AppSource, wróć do okienka Zarządzanie wydaniami i obok pozycji Przedprodukcyjne wybierz Promuj aplikację.

  11. Wybierz opcję , promuj.

    Teraz aplikacja jest w środowisku produkcyjnym i jest gotowa do dystrybucji.

    Zrzut ekranu przedstawiający okienko Zarządzanie wydaniami z aplikacją w środowisku produkcyjnym.

Aby udostępnić aplikację użytkownikom usługi Power BI na całym świecie, prześlij ją do AppSource. Aby uzyskać więcej informacji, zobacz ofertę Tworzenie aplikacji Power BI.

Automatyzowanie konfiguracji parametrów podczas instalacji

Jeśli jesteś niezależnym dostawcą oprogramowania i rozpowszechniasz aplikację szablonu za pośrednictwem usługi internetowej, możesz utworzyć automatyzację, która automatycznie konfiguruje parametry aplikacji szablonu, gdy klienci instalują aplikację w Power BI. Automatyczna konfiguracja ułatwia klientom i zwiększa prawdopodobieństwo pomyślnej instalacji, ponieważ klienci nie muszą podawać szczegółów, które mogą nie wiedzieć. Aby uzyskać więcej informacji, zobacz Automatyczna konfiguracja instalacji aplikacji opartej na szablonie.