Power Query Näyttöyhteys tai sertifiointi

  • Artikkeli

Muistiinpano

Tässä artikkelissa kuvataan mukautetun Power Query -liittimen sertifioinnin edellytykset ja lähettämisprosessi. Lue koko artikkeli ennen sertifiointiprosessin aloittamista.

Esittely

Power Query SDK:n avulla kaikilla on valtuudet luoda mukautettu Power Query -liitin tietolähteeseen yhdistämistä varten Power Querysta. Tällä hetkellä mukautettuja liittimiä tuetaan vain Power BI:n semanttisissa malleissa (Power BI Desktop ja Power BI -palvelu), ja paikallista tietoyhdyskäytävää on käytettävä päivittämiseen Power BI -palvelu kautta. Kehittäjän on jaettava mukautetut liittimet erikseen.

Tietolähteen omistajat, jotka kehittävät tietolähteelleen mukautetun liittimen, haluavat ehkä jakaa mukautetun liittimensä laajemmin Power Query -käyttäjille. Kun loppukäyttäjät ovat luoneet, käyttäneet ja vahvistaneet mukautetun liittimen, tietolähteen omistaja voi lähettää sen Microsoftin sertifiointiin.

Power Queryn mukautetun liittimen sertifiointi tuo liittimen käytettäväksi julkisesti valmiina Power BI:n semanttisissa malleissa (Power BI Desktop ja Power BI -palvelu), Power BI -tietovoissa ja Power BI -tietomarsseissa. Sertifioituja liittimiä tuetaan PowerBI.com ja kaikissa Power BI Premiumin versioissa.

Sertifioidut liittimet ovat seuraavat:

  • Kumppanikehittäjän ylläpitämä

  • Kumppanikehittäjän tukema

  • Microsoftin sertifioima

  • Microsoftin jakelema

Pyrimme yhdessä kumppaneiden kanssa varmistamaan, että niillä on tuki ylläpidossa, mutta itse liittimeen liittyvät asiakasongelmat ohjataan kumppanikehittäjälle.

Sertifioidun liittimen ja mukautetun liittimen erot

Sertifioidut liittimet niputetaan valmiina Power BI Desktopissa ja otetaan käyttöön Power BI -palvelussa, Power BI -tietovoissa ja Power BI -tietomarsseissa. Mukautettuja liittimiä tuetaan vain semanttisissa Power BI -malleissa, ja ne on ladattava Power BI Desktopiin. Ohjeet ovat kohdassa Laajennuksen lataaminen Power BI Desktopissa. Sekä sertifioidut että mukautetut liittimet voidaan päivittää Power BI Desktopin tai Power BI -palvelun kautta paikallisen tietoyhdyskäytävän kautta suorittamalla Testi Näyttöyhteys ion. Mukautettujen liittimien kohdalla tarvitaan paikallinen tietoyhdyskäytävä.

Power BI Desktopin sertifioidut liittimet, joissa on TestConnection toteutus, tukevat myös päästä päähän -päivitystä pilvipalvelun kautta (Power BI -palvelu) ilman paikallista tietoyhdyskäytävää. Power BI -palvelu ympäristö isännöi olennaisesti paikallisen yhdyskäytävän tavoin suoritettavaa pilviyhdyskäytävää. Sertifioinnin jälkeen otamme liittimesi käyttöön tässä ympäristössä, jotta se on kaikkien Power BI -asiakkaiden käytettävissä.

Mukautetut ja sertifioidut liittimet, joissa on lisäkomponentteja (esimerkiksi ODBC-ohjain), tarvitsevat lisäkomponentin asennettavaksi loppukäyttäjäkoneeseen ja edellyttävät paikallista tietoyhdyskäytävää, ellei lisäkomponenttia ole otettu käyttöön Power BI -pilvipalvelussa. Tällä hetkellä emme sertifioi ja ota käyttöön uusia ylimääräisiä osia Power BI -pilvipalvelussa, joten sellaisten liittimien sertifiointi, jotka ovat riippuvaisia lisäosasta, ei poista paikallisen tietoyhdyskäytävän vaatimusta.

Mukautetun liittimen jakelu

Mukautetut liittimet voidaan ja pitäisi jakaa käyttäjille ennen sertifiointia.

Koska M on monipuolinen kieli, jolla todennuksen käsittelyssä on kapasiteettia käsitellä tallennettuja tunnistetietoja, meidän on annettava käyttäjille tapa sallia vain luotettavien liittimien suorittaminen.

Kehittäjän näkökulmasta kehittäjien on allekirjoitettava mukautettu liittimensä itse ja annettava käyttäjilleen tietoja (allekirjoitus), jotta ne voidaan ladata turvallisesti.

Käyttäjän näkökulmasta käyttäjien on käytettävä kehittäjän allekirjoitusta mukautetun liittimen turvalliseen luottamiseen ja lataamiseen käyttöä varten. Vaihtoehtoisesti käyttäjät voivat pienentää suojausasetuksiaan sallimaan koodin lataamisen, jota Microsoft tai toinen kehittäjä ei ole sertifioinut, mutta tätä vaihtoehtoa ei suositella.

Sertifioinnin yleiskatsaus

Edellytykset

Jotta voimme varmistaa asiakkaillemme parhaan mahdollisen käyttökokemuksen, harkitsemme vain liittimiä, jotka täyttävät sertifioinnin edellytykset:

  • Liittimen on oltava julkista tuotetta varten.

  • Liittimen on katsottava olevan koodin valmis ensijulkaisuversiota varten. Ohjelma mahdollistaa usein toistuvat iteraatiot ja päivitykset. Huomaa, että Microsoft ei tarjoa teknistä apua tai mukautettujen liittimien kehityskonsultointia. Suosittelemme julkisten resurssien, kuten SDK-dokumentaation ja mallisäilön, hyödyntämistä. Jos tarvitset lisäapua, voimme jakaa luettelon tunnetuista kolmannen osapuolen toimialan mukautetun liittimen kehityskonsulteista, joiden haluat ehkä haluta ryhtyä suoraan mukaan mistä tahansa Microsoft-ohjelmasta tai kumppanuudesta riippumatta. Huomaa, että Microsoft ei ole sidoksissa mihinkään näihin konsultteihin eikä vastaa heidän palveluidensa käytöstäsi. Microsoft tarjoaa luettelon avuksesi ja ilman takeita, suosituksia tai takeita. Saat lisätietoja ottamalla yhteyttä Microsoft-sertifiointikontaktiin.

  • Kehittäjän on annettava käyttöarvio. Suosittelemme, että erittäin boutique-tuotteiden liittimien kehittäjät käyttävät liittimen itseallekirjoitusominaisuuksiamme niiden tarjoamiseksi suoraan asiakkaalle.

  • Liittimen on oltava suoraan asiakkaiden käytettävissä, jotta käyttäjä tarvitsee tai toteuttaa liiketoimintaskenaarion. Nämä ehdot voidaan täyttää yksityisellä esikatseluohjelmalla jakamalla valmis liitin suoraan käyttäjille ja organisaatioille itseallekirjoituksen kautta. Kunkin käyttäjän tai organisaation pitäisi pystyä antamaan palautetta ja vahvistusta siitä, että liittimen liiketoimintatarve on olemassa ja että liitin toimii onnistuneesti liiketoimintavaatimusten täyttämiseksi.

  • Liittimen on toimittava onnistuneesti odotetulla asiakkaiden käyttötasolla.

  • Power BI Ideas -keskustelupalstalla on oltava keskusteluketju, jonka vetäjänä ovat asiakkaat, jotta liitin olisi julkisesti käytettävissä Power BI Desktopissa. Osallistumisen kynnystä ei ole määritetty. Mitä enemmän sitoutumista kuitenkin on, sitä vahvempi todistettu kysyntä liittimelle.

Nämä edellytykset ovat olemassa sen varmistamiseksi, että sertifioitavien liittimien käyttö ja liiketoiminta ovat merkittäviä ja että niitä on käytettävä ja että niitä on tuettava sertifioinnin jälkeen.

Prosessi ja aikajanat

Sertifioidut liittimet julkaistaan Power BI Desktopin kuukausittaisten julkaisujen myötä, joten kunkin julkaisuversion määräajat ovat peräisin kustakin Power BI Desktop -julkaisupäivämäärästä. Sertifiointiprosessin odotettu kesto rekisteröinnistä julkaisuun vaihtelee liittimen lähetyksen laadun ja monimutkaisuuden mukaan. Microsoft ei tarjoa mitään erityisiä aikajanatakuita liittimen tarkistamisesta ja hyväksynnästä. Kunkin liittimen tarkistuksen kiinteät määräajat esitellään seuraavissa vaiheissa, mutta Microsoft ei takaa näiden aikajanan noudattamista.

  • Rekisteröinti: ilmoitus aikomuksesta sertifioida mukautettu liitin. Tämän rekisteröinnin on tapahduttava kuukauden 15. päivä, kaksi kuukautta ennen kohdennettua Power BI Desktop -julkaisua.

    • Esimerkiksi huhtikuun Power BI Desktop -julkaisun määräaika on 15. helmikuuta.

  • Lähetys: liitintiedostojen lähettäminen Microsoft review'ta varten. Tämän lähetyksen on tapahduttava 1. kuukausi ennen kohdennettua Power BI Desktop -julkaisua.

    • Esimerkiksi huhtikuun Power BI Desktop -julkaisun määräaika on 1. maaliskuuta.

  • Tekninen katsaus: liitintiedostojen viimeistely, Microsoftin tarkistuksen ja sertifioinnin välittäminen. Tämä tarkistus on tehtävä 15. kuukauteen mennessä ennen kohdennettua Power BI Desktop -julkaisua.

    • Esimerkiksi huhtikuun Power BI Desktop -julkaisun määräaika on 15. maaliskuuta.

Teknisten tarkistusten ja mahdollisten viiveiden, uudelleenjärjestelyn ja testausongelmien monimutkaisuuden vuoksi suosittelemme, että lähetät aikaisessa vaiheessa ensimmäistä julkaisua ja sertifiointia varten pitkän toimitusajan. Jos koet, että liittimesi on tärkeä toimittaa muutamalle asiakkaalle mahdollisimman pienellä kuormituksella, suosittelemme sen allekirjoittamista itse ja sen tarjoamista sillä tavalla.

Sertifioinnin edellytykset

Sertifioinnille on tiettyjä vaatimuksia. Ymmärrämme, että kaikki kehittäjät eivät täytä näitä vaatimuksia, ja toivomme, että otamme käyttöön ominaisuusjoukon, joka käsittelee kehittäjän tarpeita lyhyessä järjestyksessä.

Lähetystiedostot (artefaktit)

Varmista, että lähettämäsi liitintiedostot sisältävät kaikki seuraavat:

  • Näyttöyhteys or-tiedosto (.mez)

    • .mez-tiedoston tulee noudattaa tyylistandardeja ja nimetä samalla tavalla kuin tuotteen tai palvelun nimi. Siinä ei pitäisi olla sanoja, kuten "Power BI", "Näyttöyhteys or" tai "API".
    • Anna .mez-tiedoston nimeksi: ProductName.mez

  • Power BI Desktop (.pbix) -tiedosto testausta varten

    • Liittimen testaamiseen tarvitaan Power BI -malliraportti (.pbix).
    • Raportin tulee sisältää vähintään yksi kysely, jotta voit testata jokaista siirtymistaulukon kohdetta.
    • Jos määritettyä rakennetta (esimerkiksi tietokantoja) ei ole, raportissa on oltava kysely kullekin liittimen mahdollisesti käsittelemille taulukkotyypeille.

  • Testaa tili tietolähteeseen

    • Käytämme testitiliä liittimen testaamiseen ja vianmääritykseen.
    • Anna testitili, joka on pysyvä, jotta voimme sertifioida tulevat päivitykset samalla tilillä.

  • Testausohjeet

    • Anna ohjeet liittimen käyttöön ja sen toiminnan testaamiseen.

  • Ulkoisiin riippuvuuksille viittaavat linkit (esimerkiksi ODBC-ohjaimet)

Ominaisuudet ja tyyli

Liittimen on noudatettava joukkoa ominaisuuksia ja tyylisääntöjä, jotta se täyttää käytettävyysstandardin, joka on yhdenmukainen muiden sertifioitujen liittimien kanssa.

  • Liittimen TÄYTYY:

  • - FunctionName kentän tulisi olla toimialueen kannalta järkevä (esimerkiksi "Sisältö", "Taulukot", "Asiakirja", "Tietokannat" ja niin edelleen).

  • Liittimen PITÄISI:

    • Sinulla on kuvakkeita.
    • Anna siirtymistaulukko.
    • Sijoita merkkijonot tiedostoon resources.resx . URL-osoitteet ja arvot on koodata kiinteästi liittimen koodissa, eikä niitä saa sijoittaa tiedostoon resources.resx .

Suojaus

On tiettyjä suojausnäkökohtia, jotka liittimesi on käsiteltävä.

  • Jos Extension.CurrentCredentials() on käytössä:

    • Onko käyttö tarpeen? Jos näin on, minne tunnistetiedot lähetetään?
    • Tehdäänkö pyyntöjä VARMASTI HTTPS:n kautta?
    • Jos tunnistetiedot lähetetään get-toiminnon kautta Web.Contents() :
      • Voiko siitä tehdä POST-työn?
      • Jos GET-funktio on pakollinen, liittimen on käytettävä CredentialQueryString asetustietueen Web.Contents() tietuetta luottamuksellisten tunnistetietojen välittämiseen.

  • Jos Diagnostics.* -funktioita käytetään:

    • Tarkista, mitä jäljitetään; tiedot eivät saa sisältää PII-tietoja eivätkä suuria määriä tarpeettomia tietoja.
    • Jos olet ottanut käyttöön merkittävän jäljityksen kehityksessä, ota käyttöön muuttuja tai ominaisuusmerkintä, joka määrittää, pitääkö jäljityksen olla käytössä. Tämä jäljitys on poistettava käytöstä ennen sertifiointiin lähettämistä.

  • Jos Expression.Evaluate() on käytössä:

    • Varmista, mistä lauseke on peräisin ja mikä se on (eli voit dynaamisesti muodostaa kutsuja Extension.CurrentCredentials() ja niin edelleen).
    • - Expression arvoa ei saa antaa käyttäjälle eikä antaa käyttäjän syötettä.
    • Expression-kentän ei tulisi olla dynaaminen (eli noudettu verkkokutsusta).

Rekisteröinti sertifiointiin

Jos olet kiinnostunut mukautetun liittimen sertifioinnin jatkamisesta, varmista, että skenaariosi ja liittimesi täyttävät tässä artikkelissa kuvatut edellytykset ja vaatimukset . Jos näin ei tehdä, sertifiointi viivästyy, sillä tiimimme edellyttää, että korjaat mahdolliset ongelmat tai epäyhtenäisyyksien ennen sertifioinnin jatkamista.

Varmista, että liittimesi on koodi valmis ja että se on testattu sekä Power BI Desktopin luomisessa että päivityksessä ja käytössä Power BI -palvelussa. Varmista, että olet testannut täyden, päästä päähän -päivityksen Power BI -palvelussa paikallisen tietoyhdyskäytävän avulla.

Aloita täyttämään rekisteröintilomake, niin Microsoftin yhteyshenkilö ottaa yhteyttä aloittaakseen prosessin.

Sertifioinnin jälkeen

Kun liittimesi on sertifioitu ja julkaistu Power BI Desktopin ja Power BI -palvelu kautta, sinun kannattaa varmistaa, että voit käyttää oikein tuotannon käyttöön otettua julkisesti saatavilla olevaa sertifioitua liitintä.

  • Sinun ja loppukäyttäjien tulee käyttää Power BI Desktopiin ja paikalliseen tietoyhdyskäytävään sisältyvää sertifioitua liitinversiota ja poistaa mahdolliset aiemmin luodut .mez- tai .pqx-tiedostot (mukautetut liittimet), joita käytettiin ennen sertifiointia. Jos näin ei tehdä, Power Query käyttää testin mukautettua liitintä tahattomasti uuden sertifioidun liittimen sijaan.
  • Mukautettuja liittimiä tulee käyttää vain liittimen uusien versioiden testaamiseen.
  • Kun käsittelet loppukäyttäjiä ja asiakkaita, varmista, että he ymmärtävät, miten testauksessa ennen sertifiointia käytetty mukautettu liitinversio tulee poistaa testauksen jälkeen ja uusi sertifioitu liitinversio on saatavilla.

Kun olet kehittänyt tietolähteeseen liittimen, voit auttaa asiakkaita pääsemään nopeasti alkuun luomalla mallisovelluksen. Mallisovellus tarjoaa asiakkaille valmiiksi määritetyn tietoihin yhdistetyn raportin, jota he voivat käyttää valmiina tai mukauttaa tarvittaessa.

Muistiinpano

Mallisovellukset eivät tue liittimiä, jotka edellyttävät yhdyskäytävää.