Del via

Power Query Koble til or-sertifisering

  • Artikkel

Merk

Denne artikkelen beskriver kravene og prosessen for å sende inn en egendefinert Power Query-kobling for sertifisering. Les hele artikkelen nøye før du starter sertifiseringsprosessen.

Innledning

Med Power Query SDK har alle mulighet til å opprette en egendefinert Power Query-kobling for å koble til en datakilde fra Power Query. Egendefinerte koblinger støttes for øyeblikket bare i Semantiske Power BI-modeller (Power BI Desktop og Power Bi-tjeneste), og krever bruk av en lokal datagateway for å oppdatere gjennom Power Bi-tjeneste. Egendefinerte koblinger må distribueres individuelt av utvikleren.

Datakildeeiere som utvikler en egendefinert kobling for datakilden, vil kanskje distribuere den egendefinerte koblingen bredere til Power Query-brukere. Når en egendefinert kobling er opprettet, brukt og validert av sluttbrukere, kan eieren av datakilden sende den inn for Microsoft-sertifisering.

Sertifisering av en egendefinert Power Query-kobling gjør koblingen tilgjengelig offentlig, tom for boks, i Power BI-semantiske modeller (Power BI Desktop og Power Bi-tjeneste), Power BI-dataflyter og Power BI-datamarts. Sertifiserte koblinger støttes i PowerBI.com og alle versjoner av Power BI Premium.

Sertifiserte koblinger er:

  • Vedlikeholdt av partnerutvikleren

  • Støttes av partnerutvikleren

  • Sertifisert av Microsoft

  • Distribuert av Microsoft

Vi samarbeider med partnere for å prøve å sikre at de har støtte i vedlikehold, men kundeproblemer med selve koblingen sendes til partnerutvikleren.

Sertifiserte koblings- og egendefinerte koblingsforskjeller

Sertifiserte koblinger er buntet ut av boksen i Power BI Desktop, og distribueres til Power BI-tjenesten, Power BI-dataflyter og Power BI-datamarts. Egendefinerte koblinger støttes bare i semantiske Power BI-modeller og må lastes inn i Power BI Desktop, som beskrevet i innlasting av utvidelsen i Power BI Desktop. Både sertifiserte og egendefinerte koblinger kan oppdateres via Power BI Desktop eller Power BI-tjenesten ved hjelp av en lokal datagateway ved å implementere en test Koble til ion. Den lokale datagatewayen kreves for egendefinerte koblinger.

Sertifiserte koblinger i Power BI Desktop med en TestConnection implementering støtter også ende-til-ende-oppdatering gjennom skyen (Power BI-tjenesten) uten behov for en lokal datagateway. Det Power Bi-tjeneste miljøet er i hovedsak vert for en «skygateway» som kjører på samme måte som den lokale gatewayen. Etter sertifisering distribuerer vi koblingen til dette miljøet slik at den er tilgjengelig for alle Power BI-kunder.

Både egendefinerte og sertifiserte koblinger med ekstra komponenter (for eksempel ODBC-driver) trenger den ekstra komponenten som skal installeres på sluttbrukermaskinen og krever lokal datagateway, med mindre den ekstra komponenten distribueres til Power BI-skyen. For øyeblikket sertifiserer og distribuerer vi ikke nye ekstra komponenter til Power BI-skyen, så sertifiseringen av koblinger med en avhengighet av en ekstra komponent fjerner ikke det lokale kravet til datagateway.

Egendefinert koblingsdistribusjon

Egendefinerte koblinger kan og bør distribueres til sluttbrukere før sertifisering.

Siden M er et allsidig språk som, som vist i behandling av godkjenning, har kapasitet til å samhandle med lagret legitimasjon, må vi gi brukerne en måte å bare tillate klarerte koblinger å kjøre.

Fra en utviklers perspektiv må utviklere selv signere sin egendefinerte kobling og gi brukerne informasjon (avtrykk) for å laste den inn på en sikker måte.

Fra en brukers perspektiv må brukerne bruke avtrykket fra utvikleren til å klarere og laste inn den egendefinerte koblingen for bruk på en sikker måte. Brukere kan også velge å senke sikkerhetsinnstillingene for å tillate innlasting av kode som ikke er sertifisert av Microsoft eller en annen utvikler, men dette alternativet anbefales ikke.

Sertifiseringsoversikt

Forutsetning

For å sikre den beste opplevelsen for kundene våre, vurderer vi bare koblinger som oppfyller et sett med forutsetninger for sertifisering:

  • Koblingen må være for et offentlig produkt.

  • Koblingen må betraktes som kodefull for en første versjon. Programmet gir mulighet for hyppige gjentakelser og oppdateringer. Vær oppmerksom på at Microsoft ikke tilbyr teknisk assistanse eller tilpasset konsulent for koblingsutvikling. Vi anbefaler at du bruker offentlige ressurser som SDK-dokumentasjon og eksempelrepositorium. Hvis du trenger ytterligere hjelp, kan vi dele en liste over kjente tredjeparts bransjetilpassede koblingsutviklingskonsulenter som du kanskje vil engasjere deg direkte, atskilt fra et hvilket som helst Microsoft-program eller partnerskap. Vær oppmerksom på at Microsoft ikke er tilknyttet noen av disse konsulentene og ikke er ansvarlig for bruken av tjenestene deres. Microsoft leverer listen for enkelhets skyld og uten noen forsikringer, anbefalinger eller garantier. Ta kontakt med Microsoft-sertifiseringskontakten for å finne ut mer.

  • Utvikleren må gi et estimat for bruk. Vi foreslår at utviklere av koblinger for svært boutiqueprodukter bruker koblingens selvsigneringsfunksjoner til å gi dem direkte til kunden.

  • Koblingen må allerede gjøres tilgjengelig for kunder direkte for å oppfylle et brukerbehov eller forretningsscenario. Dette vilkåret kan oppfylles ved hjelp av et privat forhåndsvisningsprogram ved å distribuere den fullførte koblingen direkte til sluttbrukere og organisasjoner gjennom selvsignering. Hver bruker eller organisasjon skal kunne gi tilbakemelding og validering om at det er et forretningsbehov for koblingen, og at koblingen fungerer for å oppfylle forretningskravene.

  • Koblingen må fungere på et forventet bruksnivå av kunder.

  • Det må være en tråd i Power BI Ideas-forumet drevet av kunder for å indikere etterspørsel for å gjøre koblingen offentlig tilgjengelig i Power BI Desktop. Det er ingen angitt terskel for forhandling. Men jo mer engasjement, jo sterkere den dokumenterte etterspørselen etter koblingen.

Disse forutsetningene finnes for å sikre at koblinger som gjennomgår sertifisering, har betydelige kunder og bedrifter som må brukes og støttes etter sertifisering.

Prosess- og tidslinjer

Sertifiserte koblinger utgis med månedlige Power BI Desktop-utgivelser, slik at tidsfristene for hver utgivelse fungerer tilbake fra hver lanseringsdato for Power BI Desktop. Den forventede varigheten av sertifiseringsprosessen fra registrering til utgivelse varierer avhengig av kvaliteten og kompleksiteten til koblingsinnsendingen. Microsoft gir ingen spesifikke tidslinjegarantier med hensyn til koblingsgjennomgang og godkjenning. De vanskelige tidsfristene for hver koblingsgjennomgang er beskrevet i trinnene nedenfor, men Microsoft garanterer ikke overholdelse av disse tidslinjene.

  • Registrering: varsel om hensikt å sertifisere den egendefinerte koblingen. Denne registreringen må skje innen 15. i måneden, to måneder før den målrettede Versjonen av Power BI Desktop.

    • For April Power BI Desktop-utgivelsen vil for eksempel fristen være 15. februar.

  • Innsending: innsending av koblingsfiler for Microsoft-gjennomgang. Denne innsendingen må skje innen 1. i måneden før den målrettede Versjonen av Power BI Desktop.

    • For April Power BI Desktop-utgivelsen vil for eksempel fristen være 1. mars.

  • Teknisk gjennomgang: sluttlegging av koblingsfilene, bestått Microsoft-gjennomgang og sertifisering. Denne gjennomgangen må skje innen den 15. måneden før den målrettede Power BI Desktop-utgivelsen.

    • For April Power BI Desktop-utgivelsen vil for eksempel fristen være 15. mars.

På grunn av kompleksiteten i tekniske vurderinger og potensielle forsinkelser, rearchitecture og testproblemer, anbefaler vi på det sterkeste å sende inn tidlig med lang ledetid for den første utgivelsen og sertifiseringen. Hvis du føler at koblingen er viktig for å levere til noen få kunder med minimal overhead, anbefaler vi selvsignering og gir den på den måten.

Sertifiseringskrav

Vi har et bestemt sett med krav til sertifisering. Vi innser at ikke alle utviklere kan oppfylle disse kravene, og vi håper å introdusere et funksjonssett som vil håndtere utviklerbehov i kort rekkefølge.

Innsendingsfiler (artefakter)

Sørg for at koblingsfilene du sender inn, inkluderer alle følgende:

  • Koble til or(.mez)-fil

    • MEZ-filen bør følge stilstandarder og navngis på samme måte som navnet på produktet eller tjenesten. Det bør ikke inneholde ord som «Power BI», «Koble til or» eller «API».
    • Gi navn til .mez-filen: ProductName.mez

  • Power BI Desktop-fil (PBIX) for testing

    • Vi krever et eksempel på En Power BI-rapport (PBIX) for å teste koblingen med.
    • Rapporten bør inneholde minst én spørring for å teste hvert element i navigasjonstabellen.
    • Hvis det ikke finnes noe angitt skjema (for eksempel databaser), må rapporten inkludere en spørring for hver «type» tabell som koblingen kan håndtere.

  • Test konto til datakilden

    • Vi bruker testkontoen til å teste og feilsøke koblingen.
    • Angi en testkonto som er vedvarende, slik at vi kan bruke samme konto til å sertifisere eventuelle fremtidige oppdateringer.

  • Testinstruksjoner

    • Gi all dokumentasjon om hvordan du bruker koblingen og tester funksjonaliteten.

  • Koblinger til eksterne avhengigheter (for eksempel ODBC-drivere)

Funksjoner og stil

Koblingen må følge et sett med funksjons- og stilregler for å oppfylle en brukervennlighetsstandard i samsvar med andre sertifiserte koblinger.

  • Koblingen MÅ:

    • Bruk inndelingsdokumentformat.
    • Inneholder en versjonsoverskrift/pryd over inndelingsdokumentet.
    • Angi metadata for funksjonsdokumentasjon.
    • Ha test Koble til ionbehandling.
    • Følg navnekonvensjoner (for eksempel DataSourceKind.FunctionName). Det bør ikke inneholde ord som «Power BI», «Koble til or» eller «API».
    • La Beta-flagget være satt til Sann ved første utgivelse.

  • Det FunctionName bør være fornuftig for domenet (for eksempel «Innhold», «Tabeller», «Dokument», «Databaser» og så videre).

  • Koblingen BØR:

    • Ha ikoner.
    • Angi en navigasjonstabell.
    • Plasser strenger i en resources.resx fil. URL-adresser og verdier bør være hardkodet i koblingskoden og ikke plasseres i resources.resx filen.

Sikkerhet

Det finnes bestemte sikkerhetshensyn som koblingen må håndtere.

  • Hvis Extension.CurrentCredentials() brukes:

    • Kreves bruken? I så fall, hvor sendes legitimasjonen til?
    • Er forespørslene garantert å bli gjort via HTTPS?
    • Hvis legitimasjonen sendes via Web.Contents() GET:
      • Kan det gjøres om til et INNLEGG?
      • Hvis GET er nødvendig, må koblingen bruke CredentialQueryString posten i Web.Contents() alternativposten til å sende inn sensitiv legitimasjon.

  • Hvis diagnosedata.* brukes :

    • Valider det som spores. data kan ikke inneholde PII eller store mengder unødvendige data.
    • Hvis du implementerte betydelig sporing i utvikling, bør du implementere et variabel- eller funksjonsflagg som bestemmer om sporing skal være på. Denne sporingen må deaktiveres før du sender inn for sertifisering.

  • Hvis Expression.Evaluate() brukes:

    • Valider hvor uttrykket kommer fra, og hva det er (det vil være, kan dynamisk konstruere kall til Extension.CurrentCredentials() og så videre).
    • Brukeren Expression må ikke oppgis eller ta inndata fra brukeren.
    • Den Expression skal ikke være dynamisk (det vil eksempel: hentet fra en nettsamtale).

Registrerer for sertifisering

Hvis du er interessert i å forfølge sertifisering av den egendefinerte koblingen, må du sørge for at scenarioet og koblingen oppfyller forutsetningene og kravene som er beskrevet i denne artikkelen. Hvis du ikke gjør dette, vil det føre til forsinkelser i sertifiseringen, da teamet vårt krever at du løser eventuelle problemer eller inkonsekvenser før du går videre med sertifisering.

Kontroller at koblingen er kode fullført og har blitt testet i både redigering i Power BI Desktop, og oppdatering og forbruk i Power BI-tjenesten. Sørg for at du har testet fullstendig ende-til-ende-oppdatering i Power BI-tjenesten ved bruk av en lokal datagateway.

Kom i gang ved å fylle ut registreringsskjemaet, og en Microsoft-kontakt tar kontakt for å starte prosessen.

Etter sertifisering

Når koblingen er sertifisert og utgitt via Power BI Desktop og Power Bi-tjeneste, er det et par ting du bør gjøre for å sikre at du kan bruke den offentlig tilgjengelige produksjonsdistribusjonskoblingen på riktig måte.

  • Du og sluttbrukere bør bruke den sertifiserte koblingsversjonen som er inkludert i Power BI Desktop, og den lokale datagatewayen, og fjerne eventuelle eksisterende .mez- eller .pqx-filer (egendefinerte koblinger) som ble brukt før sertifisering. Hvis du ikke gjør dette, kan det føre til at den egendefinerte testkoblingen brukes av Power Query utilsiktet i stedet for den nylig sertifiserte koblingen.
  • Egendefinerte koblinger bør bare brukes til å teste nye versjoner av koblingen.
  • Når du arbeider med sluttbrukere og kunder, må du sørge for at de forstår den egendefinerte koblingsversjonen som ble brukt i testingen før sertifisering, bør fjernes etter at testingen er fullført, og at den nye sertifiserte koblingsversjonen er tilgjengelig.

Når du har utviklet en kobling til en datakilde, kan du vurdere å hjelpe kunder med å komme raskt i gang ved å opprette en malapp. En malapp gir kundene en forhåndsbygd rapport som er koblet til dataene sine, som de kan bruke utenfor boksen eller tilpasse etter behov.

Merk

Malapper støtter ikke koblinger som krever en gateway.