Certyfikacja Połączenie or dodatku Power Query

Artykuł
01/18/2024

Uwaga

W tym artykule opisano wymagania i proces przesyłania łącznika niestandardowego dodatku Power Query do certyfikacji. Przed rozpoczęciem procesu certyfikacji przeczytaj cały artykuł.

Wprowadzenie

Dzięki zestawowi SDK dodatku Power Query wszyscy mają uprawnienia do tworzenia niestandardowego łącznika dodatku Power Query w celu nawiązania połączenia ze źródłem danych z poziomu dodatku Power Query. Obecnie łączniki niestandardowe są obsługiwane tylko w modelach semantycznych usługi Power BI (program Power BI Desktop i usługa Power BI) i wymagają użycia lokalnej bramy danych do odświeżania za pośrednictwem usługa Power BI. Łączniki niestandardowe muszą być dystrybuowane indywidualnie przez dewelopera.

Właściciele źródeł danych, którzy tworzą łącznik niestandardowy dla źródła danych, mogą chcieć rozpowszechnić łącznik niestandardowy w szerszym zakresie dla użytkowników dodatku Power Query. Po utworzeniu, użyciu i zweryfikowaniu przez użytkowników końcowych łącznika niestandardowego właściciel źródła danych może przesłać go do certyfikacji firmy Microsoft.

Certyfikowanie łącznika niestandardowego dodatku Power Query udostępnia łącznik publicznie, gotowe do użycia w ramach semantycznych modeli usługi Power BI (power BI Desktop i usługa Power BI), przepływów danych usługi Power BI i magazynów danych usługi Power BI. Certyfikowane łączniki są obsługiwane w PowerBI.com i we wszystkich wersjach usługi Power BI Premium.

Certyfikowane łączniki to:

Obsługiwane przez dewelopera partnera
Obsługiwane przez dewelopera partnera
Certyfikowane przez firmę Microsoft
Dystrybuowane przez firmę Microsoft

Współpracujemy z partnerami, aby spróbować upewnić się, że mają pomoc techniczną w konserwacji, ale problemy klientów z samym łącznikiem zostaną skierowane do dewelopera partnera.

Różnice między łącznikami certyfikowanymi i łącznikami niestandardowymi

Certyfikowane łączniki są gotowe do użycia w programie Power BI Desktop i wdrażane w usłudze Power BI, przepływach danych usługi Power BI i magazynach danych usługi Power BI. Łączniki niestandardowe są obsługiwane tylko w modelach semantycznych usługi Power BI i muszą być ładowane w programie Power BI Desktop zgodnie z opisem w temacie Ładowanie rozszerzenia w programie Power BI Desktop. Zarówno certyfikowane, jak i niestandardowe łączniki można odświeżać za pomocą programu Power BI Desktop lub usługi Power BI przy użyciu lokalnej bramy danych, implementując test Połączenie ion. Lokalna brama danych jest wymagana dla łączników niestandardowych.

Certyfikowane łączniki w programie Power BI Desktop z implementacją TestConnection obsługują również kompleksowe odświeżanie za pośrednictwem chmury (usługi Power BI) bez potrzeby lokalnej bramy danych. Środowisko usługa Power BI zasadniczo hostuje "bramę w chmurze", która działa podobnie do bramy lokalnej. Po certyfikacji wdrożymy łącznik w tym środowisku, aby był dostępny dla wszystkich klientów usługi Power BI.

Zarówno łączniki niestandardowe, jak i certyfikowane z dodatkowymi składnikami (na przykład sterownik ODBC) wymagają zainstalowania dodatkowego składnika na maszynie użytkownika końcowego i wymagają lokalnej bramy danych, chyba że dodatkowy składnik zostanie wdrożony w chmurze usługi Power BI. Obecnie nie przeprowadzamy certyfikacji ani nie wdrażamy żadnych nowych dodatkowych składników w chmurze usługi Power BI, więc certyfikacja łączników z zależnością od dodatkowego składnika nie spowoduje usunięcia wymagań lokalnej bramy danych.

Dystrybucja łączników niestandardowych

Łączniki niestandardowe mogą i powinny być dystrybuowane do użytkowników końcowych przed certyfikacją.

Ponieważ język M jest uniwersalnym językiem, który, jak widać w temacie Obsługa uwierzytelniania, ma możliwość interakcji z przechowywanymi poświadczeniami, musimy dać użytkownikom sposób zezwalania na uruchamianie tylko zaufanych łączników.

Z perspektywy dewelopera deweloperzy muszą samodzielnie podpisać swój łącznik niestandardowy i udostępnić użytkownikom informacje (odcisk palca), aby bezpiecznie go załadować.

Z perspektywy użytkownika użytkownicy muszą używać odcisku palca od dewelopera, aby bezpiecznie ufać i ładować łącznik niestandardowy do użycia. Alternatywnie użytkownicy mogą zdecydować się na obniżenie ustawień zabezpieczeń, aby zezwolić na ładowanie kodu niecertyfikowanego przez firmę Microsoft lub innego dewelopera, ale ta opcja nie jest zalecana.

Omówienie certyfikacji

Wymagania wstępne

Aby zapewnić najlepsze środowisko dla naszych klientów, rozważmy tylko łączniki spełniające zestaw wymagań wstępnych dotyczących certyfikacji:

Łącznik musi być przeznaczony dla produktu publicznego.
Łącznik musi być traktowany jako kod ukończony dla wersji początkowej. Program umożliwia częste iteracji i aktualizacje. Należy pamiętać, że firma Microsoft nie oferuje pomocy technicznej ani niestandardowego doradztwa programistycznego łącznika. Zalecamy korzystanie z zasobów publicznych, takich jak dokumentacja zestawu SDK i repozytorium przykładów. Jeśli potrzebujesz dodatkowej pomocy, możemy udostępnić listę znanych konsultantów rozwoju łączników niestandardowych innych firm, które mogą chcieć współpracować bezpośrednio, niezależnie od dowolnego programu lub partnerstwa firmy Microsoft. Należy pamiętać, że firma Microsoft nie jest powiązana z żadnym z tych konsultantów i nie ponosi odpowiedzialności za korzystanie z ich usług. Firma Microsoft udostępnia listę wygody i bez żadnych gwarancji, zaleceń i gwarancji. Aby dowiedzieć się więcej, skontaktuj się z kontaktem z firmą Microsoft na temat certyfikacji.
Deweloper musi podać oszacowanie użycia. Sugerujemy, aby deweloperzy łączników dla bardzo butikowych produktów używali naszych możliwości samodzielnego podpisywania łącznika, aby udostępnić je bezpośrednio klientowi.
Łącznik musi być już udostępniony klientom bezpośrednio w celu spełnienia potrzeby użytkownika lub scenariusza biznesowego. Te kryteria można spełnić przy użyciu programu prywatnej wersji zapoznawczej, rozpowszechniając ukończony łącznik bezpośrednio do użytkowników końcowych i organizacji za pomocą samodzielnego podpisywania. Każdy użytkownik lub organizacja powinien mieć możliwość przekazywania opinii i weryfikacji, że istnieje potrzeba biznesowa łącznika i że łącznik działa pomyślnie, aby spełnić wymagania biznesowe.
Łącznik musi działać pomyślnie na przewidywanym poziomie użycia przez klientów.
Aby klienci mogli udostępnić łącznik publicznie w programie Power BI Desktop, musi istnieć wątek na forum Pomysły dotyczące usługi Power BI. Nie ma ustawionego progu zakontraktowania. Im większe zaangażowanie, tym silniejszy jest popyt na łącznik.

Te wymagania wstępne istnieją, aby upewnić się, że łączniki poddane certyfikacji mają znaczący klient i firma muszą być używane i obsługiwane po certyfikacji.

Procesy i osie czasu

Certyfikowane łączniki są wydawane z comiesięcznymi wersjami programu Power BI Desktop, dlatego terminy dla każdej wersji działają z powrotem z każdej daty wydania programu Power BI Desktop. Oczekiwany czas trwania procesu certyfikacji od rejestracji do wydania różni się w zależności od jakości i złożoności przesyłania łącznika. Firma Microsoft nie zapewnia żadnych konkretnych gwarancji osi czasu w odniesieniu do przeglądu i zatwierdzania łącznika. Twarde terminy przeglądu łącznika zostały opisane w poniższych krokach, ale firma Microsoft nie gwarantuje przestrzegania tych osi czasu.

Rejestracja: powiadomienie o zamiarze certyfikacji łącznika niestandardowego. Ta rejestracja musi nastąpić do 15. dnia miesiąca, dwa miesiące przed docelową wersją programu Power BI Desktop.
- Na przykład w kwietniowej wersji programu Power BI Desktop ostateczny termin to 15 lutego.
Przesyłanie: przesyłanie plików łączników do przeglądu przez firmę Microsoft. To przesłanie musi nastąpić do 1. dnia miesiąca przed docelową wersją programu Power BI Desktop.
- Na przykład w kwietniowej wersji programu Power BI Desktop ostateczny termin to 1 marca.
Przegląd techniczny: finalizacja plików łącznika, przekazywanie przeglądu i certyfikacji firmy Microsoft. Ta recenzja musi nastąpić do 15. dnia miesiąca przed docelową wersją programu Power BI Desktop.
- Na przykład w kwietniowej wersji programu Power BI Desktop ostateczny termin to 15 marca.

Ze względu na złożoność przeglądów technicznych i potencjalnych opóźnień, architektury i problemów z testowaniem zdecydowanie zalecamy wcześniejsze przesyłanie z długim czasem realizacji dla początkowej wersji i certyfikacji. Jeśli uważasz, że łącznik jest ważny, aby dostarczyć do kilku klientów z minimalnym obciążeniem, zalecamy samodzielne podpisywanie i zapewnienie go w ten sposób.

Wymagania dotyczące certyfikacji

Mamy pewien zestaw wymagań dotyczących certyfikacji. Zdajemy sobie sprawę, że nie każdy deweloper może spełnić te wymagania i mamy nadzieję wprowadzić zestaw funkcji, który będzie obsługiwać potrzeby deweloperów w krótkim czasie.

Pliki przesyłania (artefakty)

Upewnij się, że przesyłane pliki łącznika zawierają wszystkie następujące elementy:

plik Połączenie or (mez)
- Plik mez powinien być zgodny ze standardami stylu i mieć nazwę podobną do nazwy produktu lub usługi. Nie powinien zawierać wyrazów takich jak "Power BI", "Połączenie or" lub "API".
- Nadaj nazwę plikowi mez: ProductName.mez
Plik programu Power BI Desktop (pbix) na potrzeby testowania
- Do przetestowania łącznika jest wymagany przykładowy raport usługi Power BI (pbix).
- Raport powinien zawierać co najmniej jedno zapytanie, aby przetestować każdy element w tabeli nawigacji.
- Jeśli nie ma ustawionego schematu (na przykład baz danych), raport musi zawierać zapytanie dla każdego "typu" tabeli, którą może obsłużyć łącznik.
Testowanie konta w źródle danych
- Używamy konta testowego do testowania łącznika i rozwiązywania problemów z tym łącznikiem.
- Podaj konto testowe, które jest trwałe, dzięki czemu możemy użyć tego samego konta do certyfikowania wszelkich przyszłych aktualizacji.
Instrukcje dotyczące testowania
- Podaj dowolną dokumentację dotyczącą używania łącznika i testowania jego funkcjonalności.
Linki do zależności zewnętrznych (na przykład sterowniki ODBC)

Funkcje i styl

Łącznik musi przestrzegać zestawu reguł funkcji i stylu, aby spełnić standardy użyteczności zgodne z innymi certyfikowanymi łącznikami.

Łącznik MUSI:
- Użyj formatu dokumentu sekcji.
- Zawiera nagłówek/ozdobioną wersję nad dokumentem sekcji.
- Podaj metadane dokumentacji funkcji.
- Przetestuj program obsługi Połączenie ion.
- Postępuj zgodnie z konwencjami nazewnictwa (na przykład DataSourceKind.FunctionName). Nie powinien zawierać wyrazów takich jak "Power BI", "Połączenie or" lub "API".
- Flaga beta ma ustawioną wartość True w początkowej wersji.
Powinna FunctionName mieć sens dla domeny (na przykład "Zawartość", "Tabele", "Dokument", "Bazy danych" itd.).
Łącznik POWINIEN:
- Ikony.
- Podaj tabelę nawigacji.
- Umieść ciągi w resources.resx pliku. Adresy URL i wartości powinny być zakodowane w kodzie łącznika resources.resx i nie powinny być umieszczane w pliku.

Zabezpieczenia

Istnieją konkretne zagadnienia dotyczące zabezpieczeń, które łącznik musi obsługiwać.

Jeśli Extension.CurrentCredentials() jest używany:
- Czy jest wymagane użycie? Jeśli tak, gdzie są wysyłane poświadczenia?
- Czy żądania są gwarantowane za pośrednictwem protokołu HTTPS?
  - Możesz użyć funkcji pomocnika wymuszania HTTPS.
- Jeśli poświadczenia są wysyłane przy użyciu polecenia Web.Contents() GET:
  - Czy można przekształcić go w post?
  - Jeśli polecenie GET jest wymagane, łącznik MUSI użyć rekordu CredentialQueryString w rekordzie Web.Contents() opcji w celu przekazania poufnych poświadczeń.
Jeśli są używane funkcje Diagnostics.*:
- Sprawdź, co jest śledzone; dane nie mogą zawierać danych pii ani dużych ilości niepotrzebnych danych.
- W przypadku zaimplementowania znaczącego śledzenia w programowania należy zaimplementować zmienną lub flagę funkcji, która określa, czy śledzenie powinno być włączone. To śledzenie musi zostać wyłączone przed przesłaniem do certyfikacji.
Jeśli Expression.Evaluate() jest używany:
- Zweryfikuj, skąd pochodzi wyrażenie, i co to jest (czyli może dynamicznie tworzyć wywołania itd Extension.CurrentCredentials() .).
- Nie Expression należy podawać użytkownika ani wprowadzać danych wejściowych użytkownika.
- Element Expression nie powinien być dynamiczny (czyli pobierany z wywołania internetowego).

Rejestrowanie się w celu certyfikacji

Jeśli chcesz realizować certyfikację łącznika niestandardowego, upewnij się, że twój scenariusz i łącznik spełniają wymagania wstępne i wymagania opisane w tym artykule. Niepowodzenie w tym celu spowoduje opóźnienia w certyfikacji, ponieważ nasz zespół będzie wymagał rozwiązania wszelkich problemów lub niespójności przed przejściem do przodu z certyfikacją.

Upewnij się, że łącznik jest kompletny i został przetestowany zarówno podczas tworzenia w programie Power BI Desktop, jak i odświeżania i zużycia w usłudze Power BI. Upewnij się, że przetestowano kompleksowe odświeżanie w usłudze Power BI za pomocą lokalnej bramy danych.

Aby rozpocząć, wypełnij formularz rejestracji, a kontakt firmy Microsoft skontaktuje się, aby rozpocząć proces.

Po certyfikacji

Po certyfikowaniu i wydaniu łącznika za pośrednictwem programu Power BI Desktop i usługa Power BI należy wykonać kilka czynności, aby upewnić się, że można prawidłowo używać łącznika certyfikowanego wdrożonego publicznie w środowisku produkcyjnym.

Ty i użytkownicy końcowi powinni używać certyfikowanej wersji łącznika zawartej w programie Power BI Desktop oraz lokalnej bramie danych i usuwać wszystkie istniejące pliki mez lub pqx (łączniki niestandardowe) używane przed certyfikacją. Niepowodzenie tego może spowodować, że testowany łącznik niestandardowy będzie używany przypadkowo przez dodatek Power Query zamiast nowo certyfikowanego łącznika.
Łączniki niestandardowe powinny być używane tylko do testowania nowych wersji łącznika.
Podczas pracy z użytkownikami końcowymi i klientami upewnij się, że rozumieją niestandardową wersję łącznika używaną podczas testowania przed certyfikacją, należy usunąć po zakończeniu testowania, a nowa certyfikowana wersja łącznika jest dostępna.

Aplikacje szablonu (zalecane)

Po utworzeniu łącznika ze źródłem danych rozważ szybkie rozpoczęcie pracy klientów, tworząc aplikację szablonu. Aplikacja szablonu udostępnia klientom wstępnie utworzony raport połączony ze swoimi danymi, których mogą używać gotowego do użycia lub dostosować w razie potrzeby.