Power Query Forbind eller certificering

  • Artikel

Bemærk

I denne artikel beskrives kravene og processen til afsendelse af en brugerdefineret Power Query-connector til certificering. Læs hele artiklen nøje, før du starter certificeringsprocessen.

Introduktion

Med Power Query SDK kan alle oprette en brugerdefineret Power Query-connector for at oprette forbindelse til en datakilde fra Power Query. I øjeblikket understøttes brugerdefinerede connectors kun i semantiske Power BI-modeller (Power BI Desktop og Power BI-tjeneste) og kræver brug af en datagateway i det lokale miljø til at opdatere via Power BI-tjeneste. Brugerdefinerede connectors skal distribueres individuelt af udvikleren.

Ejere af datakilder, der udvikler en brugerdefineret connector til deres datakilde, vil måske distribuere deres brugerdefinerede connector mere bredt til Brugere af Power Query. Når en brugerdefineret connector er oprettet, brugt og valideret af slutbrugerne, kan ejeren af datakilden sende den til Microsoft-certificering.

Certificering af en brugerdefineret Power Query-connector gør connectoren offentligt tilgængelig i semantiske Power BI-modeller (Power BI Desktop og Power BI-tjeneste), Power BI-dataflow og Power BI-datamarts. Certificerede connectors understøttes i PowerBI.com og alle versioner af Power BI Premium.

Certificerede connectors er:

  • Vedligeholdes af partnerudvikleren

  • Understøttes af partnerudvikleren

  • Certificeret af Microsoft

  • Distribueret af Microsoft

Vi arbejder sammen med partnere for at sikre, at de har support i forbindelse med vedligeholdelse, men kundeproblemer med selve connectoren sendes til partnerudvikleren.

Forskelle i certificerede connectors og brugerdefinerede connectors

Certificerede connectors er pakket klar til brug i Power BI Desktop og udrullet i Power BI-tjenesten, Power BI-dataflow og Power BI-datamarts. Brugerdefinerede connectors understøttes kun i semantiske Power BI-modeller og skal indlæses i Power BI Desktop, som beskrevet under Indlæsning af din udvidelse i Power BI Desktop. Både certificerede og brugerdefinerede connectors kan opdateres via Power BI Desktop eller Power BI-tjenesten ved hjælp af en datagateway i det lokale miljø ved at implementere en test Forbind ion. Datagatewayen i det lokale miljø er påkrævet for brugerdefinerede connectors.

Certificerede connectors i Power BI Desktop med en TestConnection implementering understøtter også komplette opdateringer via cloudmiljøet (Power BI-tjenesten) uden behov for en datagateway i det lokale miljø. Det Power BI-tjeneste miljø er i bund og grund vært for en "cloudgateway", der kører på samme måde som gatewayen i det lokale miljø. Efter certificering udruller vi din connector til dette miljø, så den er tilgængelig for alle Power BI-kunder.

Både brugerdefinerede og certificerede connectors med ekstra komponenter (f.eks. ODBC-driver) skal have den ekstra komponent installeret på slutbrugercomputeren og kræve datagatewayen i det lokale miljø, medmindre den ekstra komponent installeres i Power BI-cloudmiljøet. I øjeblikket certificerer og udruller vi ikke nye ekstra komponenter i Power BI-cloudmiljøet, så certificeringen af connectors med en afhængighed af en ekstra komponent fjerner ikke kravet om datagateway i det lokale miljø.

Distribution af brugerdefineret connector

Brugerdefinerede connectors kan og bør distribueres til slutbrugere før certificering.

Da M er et alsidigt sprog, der, som det ses i Håndtering af godkendelse, har kapacitet til at interagere med gemte legitimationsoplysninger, skal vi give brugerne mulighed for kun at tillade kørsel af connectors, der er tillid til.

Fra en udviklers synspunkt skal udviklere selv signere deres brugerdefinerede connector og give deres brugere oplysningerne (aftryk) for at indlæse dem sikkert.

Fra en brugers synspunkt skal brugerne bruge aftrykket fra udvikleren til sikkert at have tillid til og indlæse den brugerdefinerede connector til brug. Alternativt kan brugerne vælge at sænke deres sikkerhedsindstillinger for at tillade indlæsning af kode, der ikke er certificeret af Microsoft eller en anden udvikler, men denne indstilling anbefales ikke.

Certificeringsoversigt

Forudsætninger

For at sikre den bedste oplevelse for vores kunder overvejer vi kun connectors, der opfylder et sæt forudsætninger for certificering:

  • Connectoren skal være til et offentligt produkt.

  • Connectoren skal betragtes som kodefuldfør for en indledende version. Programmet giver mulighed for hyppige gentagelser og opdateringer. Bemærk, at Microsoft ikke tilbyder teknisk bistand eller konsulentbistand til udvikling af brugerdefinerede connectors. Vi anbefaler, at du udnytter offentlige ressourcer, f.eks. vores SDK-dokumentation og lageret med eksempler. Hvis du har brug for yderligere hjælp, kan vi dele en liste over kendte tredjepartskonsulenter inden for udvikling af brugerdefinerede connectors, som du måske ønsker at engagere direkte, adskilt fra et hvilket som helst Microsoft-program eller -partnerskab. Bemærk, at Microsoft ikke er tilknyttet nogen af disse konsulenter og ikke er ansvarlig for din brug af deres tjenester. Microsoft leverer listen til din bekvemmelighed og uden forsikringer, anbefalinger eller garantier. Kontakt din Microsoft-certificeringskontakt for at få mere at vide.

  • Udvikleren skal angive et estimat for brug. Vi foreslår, at udviklere af connectors til meget boutiqueprodukter bruger vores selvsigneringsfunktioner for connectoren til at give dem direkte til kunden.

  • Connectoren skal allerede være tilgængelig for kunder direkte for at opfylde et brugerbehov eller et forretningsscenarie. Disse kriterier kan opfyldes ved hjælp af et privat prøveversionsprogram ved at distribuere den fuldførte connector direkte til slutbrugere og organisationer via selvsignering. Hver bruger eller organisation skal kunne give feedback og validering af, at der er et forretningsmæssigt behov for connectoren, og at connectoren fungerer korrekt for at opfylde deres forretningsmæssige krav.

  • Connectoren skal fungere korrekt på et forventet forbrugsniveau for kunderne.

  • Der skal være en tråd i Power BI Ideas-forummet , der er drevet af kunder, for at angive, at der er behov for at gøre connectoren offentligt tilgængelig i Power BI Desktop. Der er ingen angivet grænseværdi for engagement. Men jo mere engagement, jo stærkere er den evidenserede efterspørgsel efter connectoren.

Disse forudsætninger er til stede for at sikre, at connectorer, der er certificeret, har en betydelig kunde og virksomhed, der skal bruges og understøttes efter certificering.

Proces og tidslinjer

Certificerede connectors udgives med månedlige Power BI Desktop-udgivelser, så fristerne for hver udgivelse fungerer tilbage fra hver udgivelsesdato i Power BI Desktop. Den forventede varighed af certificeringsprocessen fra registrering til udgivelse varierer afhængigt af kvaliteten og kompleksiteten af indsendelsen af connectoren. Microsoft giver ikke nogen specifikke tidslinjegarantier med hensyn til gennemgang og godkendelse af connectorer. De faste deadlines for hver connectorgennemgang er beskrevet i følgende trin, men Microsoft garanterer ikke overholdelse af disse tidslinjer.

  • Registrering: Meddelelse om hensigt om at certificere din brugerdefinerede connector. Denne registrering skal ske den 15. i måneden, to måneder før den målrettede version af Power BI Desktop.

    • For power BI Desktop-udgivelsen i april er deadline f.eks. den 15. februar.

  • Indsendelse: Indsendelse af connectorfiler til Microsoft-gennemgang. Denne indsendelse skal ske den 1. i måneden før den målrettede version af Power BI Desktop.

    • For power BI Desktop-udgivelsen i april er deadline f.eks. 1. marts.

  • Teknisk gennemgang: afslutning af connectorfilerne, overførsel af Microsoft-gennemgang og -certificering. Denne anmeldelse skal finde sted den 15. i måneden før den målrettede version af Power BI Desktop.

    • For power BI Desktop-udgivelsen i april er deadline f.eks. den 15. marts.

På grund af kompleksiteten af de tekniske gennemgange og potentielle forsinkelser, rearchitecture og testproblemer anbefaler vi på det kraftigste, at du indsender tidligt med en lang leveringstid for den første udgivelse og certificering. Hvis du føler, at din connector er vigtig at levere til nogle få kunder med minimale omkostninger, anbefaler vi selvsignering og giver den på den måde.

Certificeringskrav

Vi har en række krav til certificering. Vi anerkender, at det ikke er alle udviklere, der kan opfylde disse krav, og vi håber på at introducere et funktionssæt, der håndterer udviklerbehov i kort rækkefølge.

Afsendelsesfiler (artefakter)

Sørg for, at de connectorfiler, du sender, omfatter alle følgende:

  • filen Forbind or (.mez)

    • .mez-filen skal følge typografistandarderne og navngives på samme måde som navnet på produktet eller tjenesten. Den må ikke indeholde ord som "Power BI", "Forbind or" eller "API".
    • Navngiv .mez-filen: ProductName.mez

  • Power BI Desktop-fil (.pbix) til test

    • Vi kræver et eksempel på en Power BI-rapport (.pbix) for at teste din connector med.
    • Rapporten skal indeholde mindst én forespørgsel for at teste hvert element i navigationstabellen.
    • Hvis der ikke er et angivet skema (f.eks. databaser), skal rapporten indeholde en forespørgsel for hver "type" tabel, som connectoren kan håndtere.

  • Test konto til din datakilde

    • Vi bruger testkontoen til at teste og foretage fejlfinding af din connector.
    • Angiv en testkonto, der er vedvarende, så vi kan bruge den samme konto til at certificere eventuelle fremtidige opdateringer.

  • Testinstruktioner

    • Angiv dokumentation til, hvordan du bruger connectoren, og test dens funktionalitet.

  • Links til eksterne afhængigheder (f.eks. ODBC-drivere)

Funktioner og typografi

Connectoren skal følge et sæt funktions- og typografiregler for at opfylde en standard for anvendelighed, der er i overensstemmelse med andre certificerede connectors.

  • ConnectorEN SKAL:

    • Brug dokumentformatet Sektion.
    • Indeholder en versionsoverskrift/-pryd over sektionsdokumentet.
    • Angiv metadata for funktionsdokumentation.
    • Hav test Forbind ionhandler.
    • Følg navngivningskonventionerne (f.eks. DataSourceKind.FunctionName). Den må ikke indeholde ord som "Power BI", "Forbind or" eller "API".
    • Få betaflaget angivet til Sand ved den indledende version.

  • FunctionName skal give mening for domænet (f.eks. "Indhold", "Tabeller", "Dokument", "Databaser" osv.).

  • Connectoren SKAL:

    • Har ikoner.
    • Angiv en navigationstabel.
    • Placer strenge i en resources.resx fil. URL-adresser og værdier skal hardcodes i connectorkoden og ikke placeres i resources.resx filen.

Sikkerhed

Der er specifikke sikkerhedsovervejelser, som din connector skal håndtere.

  • Hvis Extension.CurrentCredentials() bruges:

    • Er brugen påkrævet? Hvis det er tilfældet, hvor sendes legitimationsoplysningerne så til?
    • Er anmodningerne garanteret at blive foretaget via HTTPS?
    • Hvis legitimationsoplysningerne sendes ved hjælp af Web.Contents() via GET:
      • Kan det omdannes til en POST?
      • Hvis GET er påkrævet, SKAL connectoren bruge posten CredentialQueryString i indstillingsposten Web.Contents() til at overføre følsomme legitimationsoplysninger.

  • Hvis der bruges diagnosticering.* funktioner :

    • Valider, hvad der spores. data må ikke indeholde pii eller store mængder unødvendige data.
    • Hvis du implementerede vigtig sporing under udvikling, skal du implementere en variabel eller et funktionsflag, der bestemmer, om sporing skal være aktiveret. Denne sporing skal være slået fra , før den kan sendes til certificering.

  • Hvis Expression.Evaluate() bruges:

    • Valider, hvor udtrykket kommer fra, og hvad det er (dvs. kan dynamisk konstruere kald til Extension.CurrentCredentials() osv.).
    • Expression skal ikke angives af brugeren eller tage brugerinput.
    • Expression må ikke være dynamisk (dvs. hentes fra et webopkald).

Tilmelding til certificering

Hvis du er interesseret i at fortsætte certificeringen af din brugerdefinerede connector, skal du sikre dig, at dit scenarie og din connector opfylder de forudsætninger og krav , der er beskrevet i denne artikel. Hvis du ikke gør det, medfører det forsinkelser i certificeringen, da vores team kræver, at du løser eventuelle problemer eller uoverensstemmelser, før du går videre med certificeringen.

Sørg for, at din connector er kodefuld og er testet i både oprettelse i Power BI Desktop og opdatering og forbrug i Power BI-tjenesten. Sørg for, at du har testet komplet komplet opdatering i Power BI-tjenesten ved hjælp af en datagateway i det lokale miljø.

For at komme i gang skal du udfylde vores registreringsformular, hvorefter en Microsoft-kontakt kontakter dig for at starte processen.

Efter certificering

Når din connector er certificeret og udgivet via Power BI Desktop og Power BI-tjeneste, er der et par ting, du skal gøre for at sikre, at du kan bruge den offentligt tilgængelige, offentligt tilgængelige connector korrekt.

  • Du og slutbrugerne skal bruge den certificerede connectorversion, der er inkluderet i Power BI Desktop, og datagatewayen i det lokale miljø og fjerne alle eksisterende .mez- eller .pqx-filer (brugerdefinerede connectors), der bruges før certificering. Hvis du ikke gør det, kan det resultere i, at din test af en brugerdefineret connector bruges af Power Query utilsigtet i stedet for den nyligt certificerede connector.
  • Brugerdefinerede connectors bør kun bruges til at teste nye versioner af connectoren.
  • Når du arbejder med slutbrugere og kunder, skal du sikre, at de forstår den brugerdefinerede connectorversion, der bruges til test før certificering, skal fjernes, når testen er fuldført, og den nye certificerede connectorversion er tilgængelig.

Når du har udviklet en connector til en datakilde, kan du overveje at hjælpe kunderne med at komme hurtigt i gang ved at oprette en skabelonapp. En skabelonapp giver kunderne en færdigbygget rapport, der er forbundet til deres data, og som de kan bruge fra bunden eller tilpasse efter behov.

Bemærk

Skabelonapps understøtter ikke connectors, der kræver en gateway.