Dokumentacja platformy testowej zestawu SDK dodatku Power Query

Ta wieloczęściowa dokumentacja obejmuje konfigurację i uruchamianie standardowego zestawu testów dla deweloperów łącznika Dodatku Power Query. Odwołanie ma być przestrzegane sekwencyjnie, aby upewnić się, że środowisko jest skonfigurowane do testowania łącznika rozszerzeń.

W tej dokumentacji użyto struktury testowej zestawu SDK dodatku Power Query, standardowego zestawu testowego i zmodyfikowanej wersji danych rekordu Green Trip Commission (TLC) NewYork City Taxi & Limousine Commission (TLC). W kolejnych sekcjach opisano kroki umożliwiające skonfigurowanie środowiska w celu zweryfikowania łącznika rozszerzenia.

Platforma testowa umożliwia deweloperom zestawu SDK dodatku Power Query dostęp do standardowych testów i wykorzystania testu w celu zweryfikowania możliwości trybu DirectQuery (DQ) łącznika rozszerzeń. Dzięki tej nowej funkcji deweloperzy mają standardowy sposób weryfikowania łączników i platformy do dodawania testów niestandardowych. Przewidujemy, że jest to pierwszy krok w zwiększaniu produktywności przepływu pracy testowania dostarczonego przez zestaw SDK dodatku Power Query.

Co to jest struktura testowa zestawu SDK dodatku Power Query?

Platforma testowa zestawu SDK dodatku Power Query to gotowy do użycia test z wstępnie utworzonymi testami w celu standaryzacji testowania nowych i istniejących łączników rozszerzeń. Ma możliwość wykonywania testów funkcjonalnych, zgodności i regresji na dużą skalę. Pomaga ona sprostać potrzebom kompleksowych platform testowych, aby zaspokoić potrzeby łączników rozszerzeń.

Przepływ pracy dla dewelopera

Poniższa lista to typowy przepływ pracy dewelopera zestawu POWER Query SDK z platformą testową:

1. Zainstaluj rozszerzenie zestawu Power Query SDK programu Visual Studio Code: deweloper łącznika musi zainstalować rozszerzenie programu Visual Studio Code zestawu PowerQuery SDK na potrzeby tworzenia łącznika rozszerzeń. Rozszerzenie programu Visual Studio Code opakowuje pakiet NuGet Microsoft.PowerQuery.SdkTools, który zawiera również PQTest.exe testowe. Uprzężenie testu PQTest zawiera nowe polecenie porównania , aby wykonać testy obecne w strukturze testowej.
2. Sklonuj repozytorium GitHub Data Połączenie ors: Clone the Data Połączenie ors GitHub repo (Sklonuj repozytorium GitHub data Połączenie ors, aby uzyskać dostęp do danych testowych i testów zawartych w strukturze testowej. Aby uzyskać więcej informacji na temat tych testów, przejdź do artykułu PowerQuery SDK test framework part 3 — Test suite (Część 3 — zestaw testów).
3. Załaduj dane testowe do źródła danych: deweloper łącznika musi załadować dane testowe składające się z dwóch plików CSV jako tabel do źródła danych, co gwarantuje, że schemat jest zgodny z udostępnionym plikiem schematu SQL. Aby uzyskać więcej informacji, przejdź do tematu Power Query SDK test framework part 2 — Test data (Część 2 — testowanie danych).
4. Skonfiguruj i uruchom testy: deweloper łącznika musi następnie uruchomić testy przy użyciu dostarczonego narzędzia RunPQSDKTestSuites programu PowerShell, które używa polecenia PQTest compare w celu uruchomienia testów. Aby uzyskać więcej informacji, przejdź do sekcji Power Query SDK test framework part 5 — Testing your extension connector (Część 5 — testowanie łącznika rozszerzenia).
5. Raportowanie i ciągłe wdrażanie: domyślny raport testowy jest generowany w konsoli i dostępne są również opcje generowania raportu w formacie podsumowania, szczegółowe, TRX i JSON. Format TRX (plik wyników testów programu Visual Studio) jest przydatny do wyświetlania wyników podczas ich uruchamiania w ramach potoku. Aby uzyskać więcej informacji, przejdź do artykułu Power Query SDK test framework part 7 — Pipeline guide (Przewodnik po potoku).

Cele platformy testowej

Długoterminowym celem platformy testowej zestawu SDK dodatku Power Query jest zapewnienie niezawodnego rozwiązania testowego zintegrowanego z zestawem SDK programu Visual Studio Code w celu testowania łączników rozszerzeń. Powinno to znacznie poprawić środowisko deweloperskie na potrzeby opracowywania łączników. Powinno to również przynieść standaryzację raczej pofragmentowanych praktyk testowych, ostatecznie zwiększając poprzeczkę jakości i zmniejszając wysiłki na rzecz utrzymania łączników. Przewidujemy również platformę testową, aby podłączyć proces certyfikacji łącznika i ulepszyć środowisko dla partnerów.

Celem początkowej wersji platformy testowej jest zapewnienie następujących celów:

• Łatwe w użyciu narzędzie wiersza polecenia dla użytkowników w celu łatwego testowania łączników rozszerzeń: platforma testowa wprowadza polecenie porównania PQTest z intuicyjnymi opcjami uruchamiania testów. Udostępnia również narzędzie RunPQSDKTestSuites programu PowerShell, które pomaga również w testowaniu wsadowym. Dostępne są łatwe i automatyczne konfiguracje do konfigurowania i uruchamiania testów.
• Gotowy do użycia początkowy zestaw testów standardowych do wykonania w celu zweryfikowania łącznika: Platforma testowa udostępnia zestaw testów sanity w celu zweryfikowania schematu, liczby wierszy i danych tabel testowych. Udostępnia również standardowy zestaw testów do weryfikowania typów danych, matematycznych, daty, godziny, funkcji tekstowych, operatorów i sprzężeń.
• Bezproblemowy sposób ręcznego dodawania testów w celu rozszerzenia testowania: testy w strukturze testowej używają nowego formatu testu PQ/PQOut, co upraszcza proces tworzenia testów, minimalizując wymagane konfiguracje. Połączenie or deweloperzy mogą następnie skupić się na tworzeniu zapytania języka M na potrzeby testowania. Każdy test jest modułowy i oddzielony poszczególnymi plikami, aby uprościć konserwację. Oczekiwane dane wyjściowe są również generowane w pierwszym uruchomieniu.
• Możliwość testowania testów składania zapytań: platforma testowa może również wygenerować diagnostykę łącznika. Obecnie możliwość diagnostyki jest ograniczona do generowania zapytań SQL podczas składania zapytań dla łącznika opartego na ODBC. Ta możliwość zostanie rozszerzona do innych diagnostyki w przyszłości.

Omówienie przewodnika referencyjnego

W tym przewodniku wykonasz następujące elementy:

• Uzyskaj wiedzę na temat platformy testowej zestawu POWER Query SDK.
• Dowiedz się, jak skonfigurować środowisko programistyczne, instalując platformę testową.
• Pobierz zestaw danych używany w zestawie testów i przekaż go do źródła danych na podstawie łącznika rozszerzenia.
• Zapoznaj się ze specyfikacjami formatów testów, formatami plików i ich funkcjami w strukturze testowej.
• Pobierz i uruchom zestaw testów zawierający testy sprawdzania poprawności łącznika rozszerzenia.
• Uruchamianie poszczególnych testów z różnymi konfiguracjami.
• Dodaj własne testy, aby zweryfikować funkcjonalność specyficzną dla łącznika.
• Automatyzowanie przebiegów testów przez skonfigurowanie potoku dla testów.

generatora

Element	section	Szczegóły
1	Instalacja	Skonfiguruj środowisko.
2	Przygotowywanie danych	Przygotowywanie danych testowych.
3	Zestaw testów	Pobieranie i interpretacja zestawu testów.
100	Specyfikacja formatu testowego	Opis różnych formatów plików używanych w środowisku testowym.
5	testowanie Połączenie or	Testowanie łącznika rozszerzeń.
6	Dodawanie testów	Dodawanie własnych testów i zrozumienie różnych opcji i konfiguracji w strukturze testów.
7	Przewodnik konfiguracji potoku	Uruchamianie testów w potoku.