Power Query SDK -testikehyksen viittaus

Tämä moniosainen viittaus kattaa Power Query -liitinkehittäjille tarkoitettujen vakiotestipakettien määrittämisen ja suorittamisen. Viittausta on tarkoitus noudattaa järjestyksessä sen varmistamiseksi, että ympäristösi on määritetty laajennusliittimen testaamista varten.

Tässä viittauksessa käytetään Power Query SDK -testikehystä, standardoitua testiohjelmistoa ja Muokattua versiota NewYork City Taxi & Limousine Commission (TLC) -vihreä matkatietuetiedoista. Seuraavissa osioissa käydään läpi vaiheet ympäristön määrittämiseksi laajennusliittimen vahvistamiseksi.

Testikehyksen avulla Power Query SDK -kehittäjät voivat käyttää vakiotestejä ja testivaljaita laajennusliittimen DirectQuery (DQ) -ominaisuuksien todentamiseksi. Tämän uuden ominaisuuden ansiosta kehittäjillä on vakiotapa tarkistaa liittimet ja käyttöympäristö mukautettujen testien lisäämistä varten. Näemme tämän ensimmäisenä vaiheena Power Query SDK:n tarjoaman testaustyönkulun tuottavuuden parantamisessa.

Mikä on Power Query SDK -testikehys?

Power Query SDK -testikehys on käyttövalmis testivaljastus, joka sisältää valmiita testejä uusien ja olemassa olevien laajennusliittimien testauksen standardoimiseksi. Se pystyy suorittamaan toiminnallisen, yhteensopivuuden ja regressiotestauksen suuressa mittakaavassa. Se auttaa täyttämään kattavan testikehyksen tarpeen laajennusliittimien tarpeiden täyttämiseksi.

Kehittäjän työnkulku

Seuraavassa luettelossa on tyypillinen Power Query SDK -kehittäjän työnkulku testikehyksen kanssa:

1. Asenna Power Query SDK:n Visual Studio Code -laajennus: Liittimen kehittäjän on asennettava PowerQuery SDK Visual Studio Code -laajennus laajennusliittimen kehittämiseksi. Visual Studio Code -laajennus rivittää Microsoft.PowerQuery.SdkTools NuGet -paketin, joka sisältää myös PQTest.exe testivaljaat. PQTest-testivaljaat sisältävät uuden Vertaa-komennon testikehyksessä olevien testien suorittamiseksi.
2. Kloonaa tiedot Näyttöyhteys ors GitHub Repo: Kloonaa tiedot Näyttöyhteys ors GitHub -säilö käyttääksesi testikehyksen sisältämiä testitietoja ja testejä. Jos haluat lisätietoja näistä testeistä, siirry PowerQuery SDK -testikehyksen osaan 3 – Testiohjelmisto.
3. Lataa testitiedot tietolähteeseen: Liittimen kehittäjän on ladattava testitiedot, jotka koostuvat kahdesta CSV-tiedostosta taulukoina tietolähteeseensä, mikä varmistaa, että rakenne vastaa annettua SQL-rakennetiedostoa. Lisätietoja on kohdassa Power Query SDK -testikehyksen osa 2 – Testaa tietoja.
4. Määritä ja suorita testit: Liittimen kehittäjän on sitten suoritettava testit annetulla RunPQSDKTestSuites PowerShell -apuohjelmalla, joka suorittaa testit PQTest Compare -komennolla. Lisätietoja on artikkelissa Power Query SDK -testikehyksen osa 5 – Laajennusliittimen testaaminen.
5. Reporting & CI/CD: Oletustestiraportti luodaan konsolissa, ja käytettävissä on myös vaihtoehtoja raportin luomiseksi yhteenveto-, yksityiskohtainen-, TRX- ja JSON-muodoissa. TRX (Visual Studio -testitulostiedoston) muoto on hyödyllinen tulosten tarkastelemiseksi, kun ne suoritetaan osana jaksoa. Lisätietoja on Power Query SDK -testikehyksen osassa 7 – Putkiopas.

Testauskehyksen tavoitteet

Power Query SDK -testikehyksen pitkän aikavälin tavoitteena on tarjota vankka testausratkaisu, joka on integroitu Visual Studio Code SDK:hen laajennusten liittimien testaamista varten. Sen pitäisi parantaa merkittävästi kehittäjäkokemusta liittimien kehittämisessä. Sen pitäisi myös tuoda standardointi melko pirstoutuneiden testikäytäntöjen mukaiseksi, lopulta lisätä laatupalkkia ja vähentää liittimien ylläpitotoimia. Näemme myös testikehyksen, joka liitetään liittimen sertifiointiprosessiin ja parantaa kumppaneiden käyttökokemusta.

Testikehyksen alkujulkaisun tavoitteena on tarjota seuraavat:

• Helppokäyttöinen komentoriviapuohjelma, jonka avulla käyttäjät voivat helposti testata laajennuksen yhdistimiä: Testikehyksessä esitellään PQTest Compare-komento intuitiivisilla asetuksilla testien suorittamiseksi. Se tarjoaa myös RunPQSDKTestSuites PowerShell -apuohjelman, joka auttaa myös erätestauksessa. Testien määrittämiseen ja suorittamiseen on tarjolla helppoja ja automaattisia määrityksiä.
• Valmiin vakiotestien alkujoukko, joka suoritetaan liittimen todentamiseksi: Testikehys tarjoaa joukon saniteettitestejä testitaulukoiden rakenteen, rivimäärän ja tietojen vahvistamiseksi. Se tarjoaa myös vakiotestiohjelmiston tietotyyppien, matemaattisten tietojen, päivämäärän, ajan, tekstifunktioiden, operaattorien ja liitosten todentamiseen.
• Vaivaton tapa lisätä testejä manuaalisesti testauksen laajentamiseksi: Testikehyksen testeissä käytetään uutta PQ/PQOut-testimuotoa, joka yksinkertaistaa testin luontiprosessia minimoimalla tarvittavat määritykset. Näyttöyhteys kehittäjät voivat sitten keskittyä M-kyselyn luomiseen testausta varten. Jokainen testi on modulaarinen ja eroteltu yksittäisiin tiedostoihin ylläpidon helpottamiseksi. Odotettu tulos luodaan myös ensimmäisellä suorituskertolla.
• Mahdollisuus testata kyselyn delegointi lähteeseen -testejä: Testikehyksessä voidaan myös luoda diagnostiikka liittimelle. Tällä hetkellä diagnostiikkaominaisuus on rajoitettu SQL-kyselyn muodostamiseen ODBC-pohjaisen liittimen kyselyn delegoinnin aikana. Tämä ominaisuus laajennetaan tulevaisuudessa muihin diagnostiikkaan.

Viiteoppaan yleiskatsaus

Tässä oppaassa:

• Ymmärrät Power Query SDK -testikehyksen toiminnan.
• Opi määrittämään kehitysympäristö asentamalla testikehys.
• Nouda testiohjelmistossa käytetty tietojoukko ja lataa se tietolähteeseen laajennuksen liittimen perusteella.
• Ymmärrä testimuodon määrityksiä, joita ovat tiedostomuodot ja niiden toiminnot Test Frameworkissa.
• Hae ja suorita testiohjelmisto, joka sisältää laajennuksen liittimen vahvistustestit.
• Suorita yksittäisiä testejä eri kokoonpanoilla.
• Lisää omat testisi liitinkohtaisen toiminnallisuuden varmistamiseksi.
• Automatisoi testin suorittaminen määrittämällä jakso testeille.

Osat

Osittain	Jakso	Tietoja
1	Asetukset	Ympäristön määrittäminen.
2	Tietojen valmisteleminen	Testitietojen valmisteleminen.
3	Testiohjelmisto	Testiohjelmiston noutaminen ja ymmärtäminen.
4	Testimuoto-määritys	Ymmärrät testikehyksessä käytettävät eri tiedostomuodot.
5	Näyttöyhteys orin testaaminen	Laajennuksen liittimen testaaminen.
6	Testien lisääminen	Omien testien lisääminen ja eri vaihtoehtojen ja määritysten ymmärtäminen testikehyksessä.
7	Putken määritysopas	Testien suorittaminen jaksossa.