Referanse for SDK-testrammeverk for Power Query

Denne flerdelte referansen dekker konfigurasjonen og kjøringen av en standard testserie for Power Query-koblingsutviklere. Referansen er ment å følges sekvensielt for å sikre at miljøet er konfigurert for testing av utvidelseskoblingen.

Denne referansen bruker Power Query SDK-testrammeverket, en standardisert testserie og en modifisert versjon av de grønne reisepostdataene for NewYork City Taxi &Limousine Commission (TLC). De påfølgende inndelingene går gjennom trinnene for å få miljøoppsettet til å validere utvidelseskoblingen.

Testrammeverket gjør det mulig for Power Query SDK-utviklere å ha tilgang til standardtester og en testsele for å bekrefte DirectQuery-funksjonene (DQ) for en utvidelseskobling. Med denne nye funksjonen har utviklere en standard måte å verifisere koblinger på og en plattform for å legge til egendefinerte tester. Vi ser for oss dette som det første trinnet for å forbedre produktiviteten til testarbeidsflyten som leveres av Power Query SDK.

Hva er SDK-testrammeverket for Power Query?

Power Query SDK-testrammeverket er en klar testsele med forhåndsbygde tester for å standardisere testingen av nye og eksisterende utvidelseskoblinger. Den har muligheten til å utføre funksjonell, samsvar og regresjonstesting i stor skala. Det bidrar til å løse behovet for et omfattende testrammeverk for å tilfredsstille behovene til utvidelseskoblinger.

Arbeidsflyt for en utvikler

Følgende liste er den typiske Power Query SDK-utviklerarbeidsflyten med testrammeverket:

1. Installer Power Query SDK Visual Studio Code-utvidelsen: En koblingsutvikler må installere PowerQuery SDK Visual Studio Code-utvidelsen for å utvikle en utvidelseskobling. Visual Studio Code-utvidelsen bryter Microsoft.PowerQuery.SdkTools NuGet-pakken, som også inneholder testsele PQTest.exe. PQTest-testselen inneholder den nye sammenligningskommandoen for å utføre testene som finnes i testrammeverket.
2. Klone data Koble til ors GitHub Repo: Klone data Koble til ors GitHub repo for å få tilgang til testdata og tester som finnes i testrammeverket. Hvis du vil ha mer informasjon om disse testene, kan du gå til PowerQuery SDK test framework del 3 – Test suite.
3. Last inn testdataene til datakilden: Koblingsutvikleren må laste inn testdataene, som består av to CSV-filer, som tabeller til datakilden, som sikrer at skjemaet samsvarer med SQL-skjemafilen som er angitt. Hvis du vil ha mer informasjon, kan du gå til Power Query SDK-testrammeverket del 2 – Test data.
4. Konfigurer og kjør testene: Koblingsutvikleren må deretter kjøre testene ved hjelp av det angitte RunPQSDKTestSuites PowerShell-verktøyet, som bruker PQTest-sammenligningskommandoen til å kjøre testene. Hvis du vil ha mer informasjon, kan du gå til Power Query SDK test framework del 5 – Testing av utvidelseskoblingen.
5. Rapportering &CI/CD: Standard testrapport genereres i konsollen, og det finnes også alternativer for å generere rapporten i sammendragsformater, detaljerte, TRX- og JSON-formater. TRX-formatet (Visual Studio-testresultatfil) er nyttig for å vise resultatene når de kjøres som en del av et datasamlebånd. Hvis du vil ha mer informasjon, kan du gå til Power Query SDK test framework part 7 – pipeline guide.

Mål for testrammeverket

Det langsiktige målet med Power Query SDK-testrammeverket er å gi en robust testløsning integrert med Visual Studio Code SDK for å teste utvidelseskoblinger. Det bør i stor grad forbedre utvikleropplevelsen for utviklingen av koblingene. Det bør også bringe standardisering til ganske fragmenterte testpraksiser, til slutt øke kvalitetslinjen og redusere opprettholdelsesinnsatsen til koblingene. Vi ser også for oss at testrammeverket skal kobles til tilkoblingssertifiseringsprosessen og forbedre opplevelsen for partnerne.

Målene for testrammeverkets første utgivelse er å gi:

• Brukervennlig kommandolinjeverktøy for brukere for enkelt å teste utvidelseskoblingene sine: Testrammeverket introduserer PQTest-sammenligningskommandoen med intuitive alternativer for å kjøre testene. Det gir også RunPQSDKTestSuites PowerShell-verktøyet, som også hjelper med batchtesting. Enkle og automatiske konfigurasjoner er angitt for å konfigurere og kjøre testene.
• Klar til bruk første sett med standardtester som skal utføres for å bekrefte en kobling: Testrammeverket gir en rekke sanitetstester for å validere skjemaet, radantallet og dataene i testtabellene. Den inneholder også en standard testserie for å bekrefte datatyper, matematikk, dato, klokkeslett, tekstfunksjoner, operatorer og sammenføyninger.
• Uanstrengt måte å legge til tester manuelt for å utvide testingen: Testene i testrammeverket bruker det nye PQ/PQOut-testformatet, noe som forenkler testopprettingsprosessen ved å minimere konfigurasjonene som trengs. Koble til ellerutviklere kan deretter fokusere på å opprette M-spørringen for testingen. Hver test er modulær og atskilt i individuelle filer for å forenkle vedlikeholdet. Forventet utdata genereres også i første kjøring.
• Mulighet til å teste spørringsdelegeringstester: Testrammeverket kan også generere diagnosen for en kobling. Diagnosefunksjonen er for øyeblikket begrenset til generering av SQL-spørring under spørringsdelegering for en ODBC-basert kobling. Denne funksjonen kommer til å bli utvidet til andre diagnostikker i fremtiden.

Oversikt over referanseveiledningen

I denne veiledningen:

• Få en forståelse av Power Query SDK-testrammeverket.
• Lær hvordan du konfigurerer utviklingsmiljøet ved å installere testrammeverket.
• Hent datasettet som brukes i testserien, og last det opp til en datakilde basert på utvidelseskoblingen.
• Forstå testformatspesifikasjoner som er, filformatene og deres funksjonalitet i testrammeverket.
• Hent og kjør testserien som inneholder testene for validering av utvidelseskoblingen.
• Kjør individuelle tester med ulike konfigurasjoner.
• Legg til dine egne tester for å bekrefte den koblingsspesifikke funksjonaliteten.
• Automatiser testkjøringer ved å konfigurere et datasamlebånd for testene.

Deler

Del	Delen	Detaljer
1	Oppsett	Konfigurer miljøet.
2	Klargjør data	Forbereder testdataene.
3	Testserie	Hente og forstå testserien.
4	Testformatspesifikasjon	Forstå ulike filformater som brukes i testrammeverket.
5	Koble til ortesting	Tester utvidelseskoblingen.
6	Legge til tester	Legge til dine egne tester og forstå ulike alternativer og konfigurasjoner i testrammeverket.
7	Veiledning for konfigurasjon av datasamlebånd	Kjøre testene i et datasamlebånd.