Referens för Power Query SDK-testramverk

Den här referensen i flera delar beskriver konfigurationen och körningen av en standardserie med tester för Power Query-anslutningsutvecklare. Referensen är avsedd att följas sekventiellt för att säkerställa att din miljö har konfigurerats för testning av tilläggsanslutningen.

Den här referensen använder Power Query SDK-testramverket, en standardiserad testsvit och en modifierad version av TLC-data (NewYork City Taxi & Limousine Commission). De efterföljande avsnitten går igenom stegen för att få miljökonfigurationen att verifiera tilläggsanslutningen.

Testramverket gör det möjligt för Power Query SDK-utvecklare att ha åtkomst till standardtester och en testsel för att verifiera DirectQuery-funktionerna (DQ) i en tilläggsanslutning. Med den här nya funktionen har utvecklare ett standardsätt för att verifiera anslutningsappar och en plattform för att lägga till anpassade tester. Vi ser detta som det första steget för att förbättra produktiviteten i testarbetsflödet som tillhandahålls av Power Query SDK.

Vad är Power Query SDK-testramverket?

Power Query SDK-testramverket är ett färdigt testverktyg med fördefinierade tester för att standardisera testningen av nya och befintliga tilläggsanslutningar. Den har möjlighet att utföra funktions-, efterlevnads- och regressionstestning i stor skala. Det hjälper till att åtgärda behovet av ett omfattande testramverk för att uppfylla behoven hos tilläggsanslutningsappar.

Arbetsflöde för en utvecklare

Följande lista är det typiska Power Query SDK-utvecklararbetsflödet med testramverket:

1. Installera Power Query SDK Visual Studio Code-tillägget: En anslutningsutvecklare måste installera PowerQuery SDK Visual Studio Code-tillägget för att utveckla en tilläggsanslutning. Visual Studio Code-tillägget omsluter NuGet-paketet Microsoft.PowerQuery.SdkTools, som också innehåller testselar PQTest.exe. PQTest-testselen innehåller det nya jämförelsekommandot för att köra testerna som finns i testramverket.
2. Klona GitHub-lagringsplatsen Data Anslut ors: Klona GitHub-lagringsplatsen Data Anslut ors för att få åtkomst till testdata och tester i testramverket. Mer information om dessa tester finns i PowerQuery SDK-testramverket del 3 – Testsvit.
3. Läs in testdata till datakällan: Anslutningsutvecklaren måste läsa in testdata, som består av två CSV-filer, som tabeller till deras datakälla, vilket säkerställer att schemat matchar den SQL-schemafil som tillhandahålls. Mer information finns i Power Query SDK-testramverket del 2 – Testa data.
4. Konfigurera och kör testerna: Anslutningsutvecklaren måste sedan köra testerna med hjälp av det angivna PowerShell-verktyget RunPQSDKTestSuites, som använder kommandot PQTest compare för att köra testerna. Mer information finns i Power Query SDK-testramverket del 5 – Testa tilläggsanslutningen.
5. Rapportering och CI/CD: Standardtestrapporten genereras i konsolen och det finns även alternativ för att generera rapporten i sammanfattnings-, detaljerad-, TRX- och JSON-format. TRX-formatet (Visual Studio-testresultatfilen) är användbart för att visa resultaten när de körs som en del av en pipeline. Mer information finns i Power Query SDK-testramverket del 7 – Pipelineguide.

Mål för testramverket

Det långsiktiga målet med Power Query SDK-testramverket är att tillhandahålla en robust testlösning som är integrerad med Visual Studio Code SDK för att testa tilläggsanslutningar. Det bör avsevärt förbättra utvecklarupplevelsen för utveckling av anslutningsappar. Det bör också ge standardisering till ganska fragmenterade testmetoder, så småningom öka kvalitetsfältet och minska underhållsarbetet för anslutningsprogrammen. Vi föreställer oss även testramverket för att ansluta till anslutningsprocessen och förbättra upplevelsen för partnerna.

Målet med den första versionen av testramverket är att tillhandahålla:

• Enkelt att använda kommandoradsverktyget för användare för att enkelt testa sina tilläggsanslutningar: Testramverket introducerar kommandot PQTest compare med intuitiva alternativ för att köra testerna. Det innehåller även PowerShell-verktyget RunPQSDKTestSuites, som också hjälper till med batchtestning. Enkla och automatiska konfigurationer tillhandahålls för att konfigurera och köra testerna.
• Färdig startuppsättning med standardtester som ska köras för att verifiera en anslutningsapp: Testramverket tillhandahåller en uppsättning sanitetstester för att verifiera schemat, radantalet och data i testtabellerna. Den innehåller också en standardtestsvit för att verifiera datatyper, matematik, datum, tid, textfunktioner, operatorer och kopplingar.
• Enkelt sätt att lägga till tester manuellt för att utöka testningen: Testerna i testramverket använder det nya PQ/PQOut-testformatet, vilket förenklar testskapandeprocessen genom att minimera de konfigurationer som behövs. Anslut eller utvecklare kan sedan fokusera på att skapa M-frågan för testning. Varje test är modulärt och indelat i enskilda filer för att förenkla underhållet. Förväntade utdata genereras också i den första körningen.
• Möjlighet att testa frågedelegeringstester: Testramverket kan också generera diagnostik för en anslutningsapp. För närvarande är diagnostikfunktionen begränsad till SQL-frågegenerering under frågedelegering för en ODBC-baserad anslutningsapp. Den här funktionen kommer att utökas till annan diagnostik i framtiden.

Översikt över referensguiden

I den här guiden:

• Få en förståelse för Power Query SDK-testramverket.
• Lär dig hur du konfigurerar utvecklingsmiljön genom att installera testramverket.
• Hämta den datauppsättning som används i testpaketet och ladda upp den till en datakälla baserat på tilläggsanslutningen.
• Förstå specifikationerna för testformatet, filformaten och deras funktioner i Test Framework.
• Hämta och kör testpaketet som innehåller testerna för validering av tilläggsanslutningen.
• Kör enskilda tester med olika konfigurationer.
• Lägg till dina egna tester för att verifiera dina anslutningsspecifika funktioner.
• Automatisera testkörningar genom att konfigurera en pipeline för testerna.

Delar

Delvis	avsnitt	Details
1	Installation	Konfigurera din miljö.
2	Förbereda data	Förbereda testdata.
3	Testsvit	Hämtar och förstår testsviten.
4	Testformatspecifikation	Förstå olika filformat som används i testramverket.
5	Anslut eller testning	Testa tilläggsanslutningen.
6	Lägga till tester	Lägga till egna tester och förstå olika alternativ och konfigurationer i testramverket.
7	Installationsguide för pipeline	Köra testerna i en pipeline.