Certyfikowane wizualizacje usługi Power BI

Artykuł
02/20/2024

Certyfikowane wizualizacje usługi Power BI to wizualizacje usługi Power BI w usłudze AppSource spełniające wymagania i testowanie kodu zespołu usługi Microsoft Power BI. Wykonane testy są przeznaczone do sprawdzania, czy wizualizacja nie uzyskuje dostępu do usług zewnętrznych 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 wizualizacji 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 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_moduleselement i .tmp do dist 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.
ESlintz wymaganą konfiguracją. To polecenie nie może zwracać żadnych błędów lint.

Uwaga

Trwa migracja z TSlint do programu ESLint. Wizualizacje korzystające z TSlint zostaną zaakceptowane do certyfikacji do marca 2023 r. Następnie usługa ESlint będzie wymagana.

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 przesyłanie nie jest zgodne z tymi wytycznymi, otrzymasz wiadomość e-mail o odrzuceniu z Centrum partnerskiego 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.

Wymagania

Używaj tylko publicznie przeglądanych składników systemu operacyjnego, takich jak publiczne biblioteki JavaScript lub TypeScript.
Kod musi obsługiwać interfejs API zdarzeń renderowania.
Upewnij się, że dom jest bezpiecznie manipulowany. Przed dodaniem ich do modelu DOM użyj oczyszczania danych wejściowych użytkownika 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 polecenia 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 , requestAnimationFrame(), setinterval(user input function)i danych wejściowych settimeout()użytkownika lub danych użytkownika.
Zmieryfikowane pliki lub projekty JavaScript.

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:

Zaloguj się do Centrum partnerskiego.
Na stronie Przegląd wybierz wizualizację usługi Power BI i przejdź do strony Konfiguracja produktu.
Zaznacz pole wyboru Zażądaj certyfikacji usługi Power BI.
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 przesyłania repozytorium prywatnego

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.

Utwórz nowe konto dla zespołu weryfikacji.
Skonfiguruj uwierzytelnianie dwuskładnikowe dla konta.
Wygeneruj nowy zestaw kodów odzyskiwania.
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, użytkownicy będą mogli pobrać ją kilka godzin po otrzymaniu wiadomości e-mail z usługi AppSource.
Jeśli przesłano aktualizację do istniejącej wizualizacji usługi Power BI, użytkownicy będą mogli pobrać ją w ciągu dwóch tygodni od przesłania.

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?

Wskaźnik certyfikacji powinien być widoczny w ciągu trzech tygodni od zatwierdzenia przesyłania.

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

Certyfikowane wizualizacje usługi Power BI

Usuwanie certyfikacji