Certyfikowane wizualizacje usługi Power BI

Certyfikowane wizualizacje usługi Power BI to wizualizacje usługi Power BI w usłudze AppSource spełniające wymagania dotyczące kodu i testy przeprowadzane przez zespół Microsoft Power BI. Wykonane testy są przeznaczone do sprawdzania, czy element wizualny nie uzyskuje dostępu do zewnętrznych usług ani zasobów. Firma Microsoft nie jest jednak autorem wizualizacji niestandardowych innych firm i zalecamy klientom bezpośredni kontakt z autorem w celu zweryfikowania funkcjonalności tych wizualizacji.

Certyfikowane wizualizacje usługi Power BI mogą być używane jak każda inna wizualizacja usługi Power BI. Oferują one więcej funkcji niż niecertyfikowane wizualizacje. Możesz na przykład wyeksportować je do programu PowerPoint lub wyświetlić wizualizację w odebranych wiadomościach e-mail, gdy użytkownik subskrybuje strony raportu.

Proces certyfikacji jest opcjonalny. Deweloperzy decydują, czy chcą, aby ich wizualizacja była certyfikowana. Wizualizacje usługi Power BI, które nie są certyfikowane, nie muszą być niebezpieczne. Niektóre wizualizacje usługi Power BI nie są certyfikowane, ponieważ nie są zgodne z co najmniej jednym z wymagań dotyczących certyfikacji. Na przykład wizualizacja mapy usługi Power BI łącząca się z usługą zewnętrzną lub wizualizacja usługi Power BI korzystająca z bibliotek komercyjnych nie może być certyfikowana.

Usuwanie certyfikacji

Firma Microsoft zastrzega sobie prawo do usunięcia elementu wizualnego z listy certyfikowanych według własnego uznania.

Wymagania dotyczące certyfikacji

Aby uzyskać certyfikat wizualizacji usługi Power BI, musi spełniać wymagania wymienione w tej sekcji.

Wymagania ogólne

Wizualizacja usługi Power BI musi zostać zatwierdzona przez Centrum partnerskie. Przed zażądaniem certyfikacji zalecamy opublikowanie wizualizacji usługi Power BI w usłudze AppSource. Aby dowiedzieć się, jak opublikować wizualizację usługi Power BI w usłudze AppSource, zobacz Publikowanie wizualizacji usługi Power BI w Centrum partnerskim.

Przed przesłaniem wizualizacji usługi Power BI na potrzeby certyfikacji sprawdź, czy:

• Wizualizacja nie jest wizualizacją języka R
• Wizualizacja jest zgodna z wytycznymi dotyczącymi wizualizacji usługi Power BI
• Wizualizacja przechodzi wszystkie wymagane testy
• Skompilowany pakiet dokładnie pasuje do przesłanego pakietu

Wymagania dotyczące repozytorium kodu

Chociaż nie musisz publicznie udostępniać kodu w usłudze GitHub, repozytorium kodu musi być dostępne do przeglądu przez zespół usługi Power BI. Najlepszym sposobem na to jest podanie kodu źródłowego (JavaScript lub TypeScript) w usłudze GitHub.

Repozytorium musi zawierać:

• Kod tylko dla jednej wizualizacji usługi Power BI. Nie może zawierać kodu dla wielu wizualizacji usługi Power BI ani niepowiązanego kodu.
• Gałąź o nazwie certification (wymagane małe litery). Kod źródłowy w tej gałęzi musi być zgodny z przesłanym pakietem. Ten kod można zaktualizować tylko podczas następnego procesu przesyłania, jeśli ponownie przesyłasz wizualizację usługi Power BI.

Jeśli wizualizacja usługi Power BI używa prywatnych pakietów npm lub modułów podrzędnych git, musisz również zapewnić dostęp do repozytoriów zawierających ten kod.

Aby dowiedzieć się, jak wygląda repozytorium wizualizacji usługi Power BI, zapoznaj się z repozytorium GitHub dla przykładowego wykresu słupkowego wizualizacji usługi Power BI.

Wymagania dotyczące plików

Użyj najnowszej wersji interfejsu API, aby napisać wizualizację usługi Power BI.

Repozytorium musi zawierać następujące pliki:

• .gitignore — dodaj node_modules, .tmp i dist do tego pliku. Kod nie może zawierać folderów node_modules, .tmp ani dist .
• capabilities.json — jeśli przesyłasz nowszą wersję istniejącej wizualizacji usługi Power BI ze zmianami właściwości w tym pliku, sprawdź, czy nie przerywają raportów dla istniejących użytkowników.
• pbiviz.json
• package.json. Wizualizacja musi mieć zainstalowany następujący pakiet:
  • "typescript"
  • "eslint"
  • "eslint-plugin-powerbi-visuals"
  • Plik musi zawierać polecenie do uruchamiania lintera — "eslint": "npx eslint . --ext .js,.jsx,.ts,.tsx"
• package-lock.json
• tsconfig.json

Wymagania dotyczące poleceń

Upewnij się, że następujące polecenia nie zwracają żadnych błędów.

• npm install
• pbiviz package
• npm audit - Nie może zwracać żadnych ostrzeżeń o wysokim lub umiarkowanym poziomie.
• ESlint z wymaganą konfiguracją. To polecenie nie powinno zwracać żadnych błędów lint.

Kompilowanie wymagań

Użyj najnowszej wersji narzędzi powerbi-visuals-tools , aby napisać wizualizację usługi Power BI.

Skompiluj wizualizację usługi Power BI przy użyciu polecenia pbiviz package. Jeśli używasz własnych skryptów kompilacji, podaj npm run package niestandardowe polecenie kompilacji.

Wymagania dotyczące kodu źródłowego

Upewnij się, że postępuj zgodnie z listą dodatkowych zasad certyfikacji wizualizacji usługi Power BI. Jeśli Twoje zgłoszenie nie jest zgodne z tymi wytycznymi, otrzymasz wiadomość e-mail o odrzuceniu z Partner Center z numerami zasad wymienionymi w tym linku.

Postępuj zgodnie z wymaganiami dotyczącymi kodu wymienionymi tutaj, aby upewnić się, że kod jest zgodny z zasadami certyfikacji usługi Power BI.

Wymagane

• Używaj tylko publicznie przeglądanych składników systemu operacyjnego, takich jak publiczne biblioteki JavaScript lub TypeScript.
• Kod musi obsługiwać Rendering Events API.
• Upewnij się, że manipulowanie DOM jest bezpieczne. Przed dodaniem do DOM użyj oczyszczania danych wejściowych lub danych użytkownika.
• Użyj przykładowego raportu jako testowego zestawu danych.

Niedozwolone

• Uzyskiwanie dostępu do usług zewnętrznych lub zasobów. Na przykład żadne żądania HTTP/S lub WebSocket nie mogą wychodzić z usługi Power BI do dowolnych usług. W związku z tym uprawnienia funkcji WebAccess powinny być puste lub pominięte w ustawieniach funkcji.
• Przy użyciu innerHTML lub D3.html(user data or user input).
• Błędy lub wyjątki języka JavaScript w konsoli przeglądarki dla wszystkich danych wejściowych.
• Dowolny lub dynamiczny kod, taki jak eval(), niebezpieczne użycie settimeout(), requestAnimationFrame(), setinterval(user input function) oraz dane wejściowe lub dane użytkownika.
• Zminimalizowane pliki JavaScript lub projekty.

Przesyłanie wizualizacji usługi Power BI na potrzeby certyfikacji

Teraz możesz przesłać żądanie, aby wizualizacja usługi Power BI została certyfikowana przez zespół usługi Power BI.

Napiwek

Proces certyfikacji usługi Power BI może zająć trochę czasu. Jeśli tworzysz nową wizualizację usługi Power BI, zalecamy opublikowanie wizualizacji usługi Power BI za pośrednictwem Centrum partnerskiego przed zażądaniem certyfikacji usługi Power BI. Dzięki temu publikowanie wizualizacji nie jest opóźnione.

Aby zażądać certyfikacji usługi Power BI:

1. Zaloguj się do Centrum partnerskiego.
2. Na stronie Przegląd wybierz wizualizację usługi Power BI i przejdź do strony Konfiguracja produktu.
3. Zaznacz pole wyboru Zażądaj certyfikacji usługi Power BI.
4. Na stronie Przeglądanie i publikowanie w polu tekstowym Uwagi dotyczące certyfikacji podaj link do kodu źródłowego i poświadczenia wymagane do uzyskania do niego dostępu.

Proces zgłaszania prywatnego repozytorium

Jeśli używasz repozytorium prywatnego, takiego jak GitHub do przesyłania wizualizacji usługi Power BI do certyfikacji, postępuj zgodnie z instrukcjami w tej sekcji.

1. Utwórz nowe konto dla zespołu weryfikacji.
2. Skonfiguruj uwierzytelnianie dwuskładnikowe dla konta.
3. Wygeneruj nowy zestaw kodów odzyskiwania.
4. Podczas przesyłania wizualizacji usługi Power BI upewnij się, że podano następujące szczegóły:
   • Link do repozytorium
   • Poświadczenia logowania (w tym hasło)
   • Kody odzyskiwania
   • Uprawnienia tylko do odczytu do naszego konta (pbicvsupport)

Certyfikowane elementy wizualne usługi Power BI

Po certyfikowaniu wizualizacji usługi Power BI zostanie ona oznaczona znaczkiem wskazującym, że jest to certyfikowana wizualizacja usługi Power BI.

Certyfikowane wizualizacje usługi Power BI w usłudze AppSource

• Gdy ktoś wyszukuje wizualizacje usługi Power BI w usłudze AppSource, mały żółty znaczek na karcie wizualizacji wskazuje, że jest to certyfikowana wizualizacja usługi Power BI.

  

• Po kliknięciu karty wizualizacji usługi Power BI w usłudze AppSource żółty znaczek zatytułowany Certyfikat PBI wskazuje, że ta wizualizacja usługi Power BI jest certyfikowana.

  

Certyfikowane wizualizacje usługi Power BI w interfejsie usługi Power BI

• Po zaimportowaniu wizualizacji usługi Power BI z poziomu programu Power BI (desktop lub usługi) niebieski wskaźnik wskazuje, że wizualizacja usługi Power BI jest certyfikowana.

  

• Możesz wyświetlić tylko certyfikowane wizualizacje usługi Power BI, wybierając opcję Filtr certyfikowany usługi Power BI.

Oś czasu publikacji

Proces wdrażania w usłudze AppSource może zająć trochę czasu. Wizualizacja usługi Power BI będzie dostępna do pobrania z usługi AppSource po zakończeniu tego procesu.

Kiedy użytkownicy będą mogli pobrać moją wizualizację?

• Jeśli przesłano nową wizualizację usługi Power BI, będzie ona dostępna do pobrania z linku usługi AppSource w ciągu kilku godzin. Jednak dotarcie do produkcji zajmuje dodatkowe 10–14 dni i stanie się dostępne w Power BI Desktop/Service.

• Jeśli przesłano aktualizację do istniejącej wizualizacji usługi Power BI, nowa wersja pojawi się również w usłudze AppSource, ale wdrożenie w środowisku produkcyjnym potrwa do dwóch tygodni.

  Uwaga

  Pole wersji w usłudze AppSource zostanie zaktualizowane o dzień zatwierdzenia usługi Power BI przez usługę AppSource— około tydzień po przesłaniu wizualizacji. Użytkownicy będą mogli pobrać zaktualizowaną wizualizację, ale zaktualizowane możliwości nie zostaną zastosowane. Nowe możliwości wizualizacji będą mieć wpływ na raporty użytkownika po około dwóch tygodniach.

Kiedy wizualizacja usługi Power BI wyświetli wskaźnik certyfikacji?

Odznaka certyfikacyjna powinna być widoczna w ciągu trzech tygodni od zatwierdzenia zgłoszenia.

Powiązana zawartość

• Często zadawane pytania dotyczące certyfikowanych wizualizacji.
• Wskazówki dotyczące publikowania wizualizacji usługi Power BI

Masz więcej pytań? Wypróbuj Społeczność usługi Power BI.