Power Query connectorcertificering

Introduktion

Certificering af Power Query brugerdefinerede connector gør connectoren offentlig tilgængelig og klar til brug i Power BI Desktop. Certificerede connectors understøttes i PowerBI.com og alle versioner af Power BI Premium, undtagen dataflow. Certificering er underlagt Microsofts certificeringsprogram for connectors, hvor Microsoft arbejder sammen med partnerudviklere om at udvide funktionerne til dataforbindelse i Power BI.

Certificerede forbindelser er:

• Vedligeholdes af partnerudvikleren

• Understøttes af partnerudvikleren

• Certificeret af Microsoft

• Distribueret af Microsoft

Vi arbejder sammen med partnere for at forsøge at sikre, at de har support under vedligeholdelse, men kundeproblemer med selve connectoren dirigeres til partnerudvikleren.

Certificerede connectors er samlet klar til brug i Power BI Desktop. Brugerdefinerede connectors skal indlæses i Power BI Desktop som beskrevet i Indlæsning af din udvidelse i Power BI Desktop. Begge kan opdateres via en Power BI Desktop eller Power BI Service ved hjælp af en datagateway i det lokale miljø ved at implementere en TestConnection.

Certificerede connectorer med en implementering understøtter også TestConnection end-to-end-opdatering via cloudmiljøet (Power BI Service) uden behov for en datagateway i det lokale miljø. Det Power BI tjenestemiljø er i bund og grund vært for en "cloudgateway", der kører på samme måde som gatewayen i det lokale miljø. Efter certificeringen udruller vi din connector i dette miljø, så den er tilgængelig for alle Power BI kunder. Der er flere krav til connectorer, der skal bruge flere komponenter, f.eks. en ODBC-baseret driver. Sørg for at kontakte din Microsoft-kontakt, hvis din connector kræver brug af yderligere komponenter.

Sikkerhed og signering af brugerdefineret connector

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

Fra en udviklers perspektiv skal udviklere selv signere deres brugerdefinerede connector og give deres brugere oplysninger (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 reducere deres sikkerhedsindstillinger for at tillade indlæsning af kode, der ikke er certificeret af Microsoft eller en anden udvikler, men dette anbefales ikke.

Oversigt over certificering

Forudsætninger

For at sikre den bedste oplevelse for vores kunder bør vi kun overveje connectorer, der opfylder en række forudsætninger for certificering:

• Connectoren skal være til et offentligt produkt.

• Connectoren skal anses for at være kode fuldført i forbindelse med en indledende version. Programmet giver mulighed for hyppige gentagelser og opdateringer. Bemærk, at Microsoft ikke direkte tilbyder teknisk rådgivning i forbindelse med udvikling af brugerdefinerede connectors. Men som en del af programmet kan Microsoft anbefale ressourcer, som udviklere kan engagere sig mere i. Når du er registreret i programmet nedenfor, kan du kontakte din Microsoft-kontakt for at få mere at vide.

• Udvikleren skal angive et estimat for forbrug. Vi foreslår, at udviklere af connectors til produkterne, som bruger vores connectorfunktioner til selvsignering, til at levere dem direkte til kunden.

• Connectoren skal allerede være tilgængelig for kunder direkte for at opfylde et bruger behov eller forretningsscenarie. Dette kan gøres ved hjælp af et privat prøveversionsprogram ved at distribuere den færdige connector direkte til slutbrugerne og organisationer via selvsignering. Hver bruger eller organisation bør kunne give feedback og validering om, at der er et forretningsmæssig behov for connectoren, og at connectoren fungerer med stor succes for at opfylde deres forretningsmæssige krav.

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

• Der skal være en tråd i det Power BI Ideas-forum, der er drevet af kunder, for at indikere en efterspørgsel efter at gøre connectoren offentlig tilgængelig Power BI Desktop. Der er ingen angivet grænse for engagement. Men jo mere engagement, jo stærkere er den dokumenterede efterspørgsel efter connectoren.

Disse forudsætninger er nødvendige for at sikre, at der er et stort antal kunder og virksomheder, der skal bruges og understøttes efter certificeringen.

Proces og tidslinjer

Certificerede connectors udgives med månedlige Power BI Desktop udgivelser, så deadlinesne for hver udgivelse fungerer tilbage fra Power BI Desktop udgivelsesdato. Den forventede varighed af certificeringsprocessen fra registrering til udgivelse afhænger af kvaliteten og kompleksiteten af indsendelsen af connectoren, og den beskrives i følgende trin:

• Registrering: meddelelse om hensigten med at certificere din brugerdefinerede connector. Dette skal ske den 15. i måneden, to måneder før den målrettede Power BI desktopversion.

  • For udgivelsen i april Power BI Desktop er tidsfristen f.eks. den 15. februar.

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

  • For udgivelsen i april Power BI Desktop er tidsfristen f.eks. den 1. marts.

• Teknisk gennemgang: Færdiggørelse af connectorfilerne, der videregiver Microsofts gennemgang og certificering. Dette skal ske den 15. i måneden før den målrettede Power BI Desktop udgivelse.

  • For udgivelsen i april Power BI Desktop er tidsfristen f.eks. den 15. marts.

På grund af kompleksiteten af de tekniske gennemgange og potentielle forsinkelser, arkitektur og testproblemer anbefaler vi på det kraftigste, at du indsender test tidligt med en lang kundeemnetid i forbindelse med den første udgivelse og certificering. Hvis din connector er vigtig for at levere til nogle få kunder med minimal belastning, anbefaler vi, at du selv signerer den og leverer den på den måde.

Certificeringskrav

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

Indsendelsesfiler (artefakter)

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

• Connectorfil (.mez)

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

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

  • Vi kræver et eksempel på Power BI rapport (.pbix) for at teste din connector med.
  • Rapporten skal indeholde mindst én forespørgsel for at teste hvert element i din navigationstabel.
  • 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.

• Testkonto til din datakilde

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

• Testinstruktioner

  • Angiv dokumentation for, hvordan du bruger connectoren og tester dens funktionalitet.

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

Funktioner og stil

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 Afsnit.
  • Have versionsydelse på afsnittet.
  • Angiv dokumentation til funktionsdokumentation for.
  • Få TestConnection-handleren.
  • Følg navngivningskonventioner (f.eks. DataSourceKind.FunctionName ). Den må ikke indeholde ord som "Power BI", "Connector" eller "API".

• bør FunctionName give mening for domænet (f.eks. "Indhold", "Tabeller", "Dokument", "Databaser" mm.).

• Connectoren SKAL:

  • Har ikoner.
  • Angiv en navigationstabel.
  • Placer strenge i en resources.resx fil. URL-adresser og værdier skal kodes 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 det nødvendigt at bruge forbruget? Hvor sendes legitimationsoplysningerne så til?
  • Garanteres det, at anmodningerne foretages via HTTPS?
    • Du kan bruge helper-funktionen for HTTPS-håndhævelse.
  • Hvis legitimationsoplysningerne sendes ved hjælp Web.Contents() af GET:
    • Kan det omdannes til en POST?
    • Hvis GET er påkrævet, skal connectoren bruge CredentialQueryString posten i Web.Contents() indstillingsposten til at angive følsomme legitimationsoplysninger.

• Hvis diagnosticering.* anvendes:

  • Valider, hvad der spores; -data må ikke indeholde piI eller store mængder unødvendige data.
  • Hvis du har implementeret betydelig sporing i udviklingen, skal du implementere en variabel eller funktionsflag, der bestemmer, om sporing skal være på. Denne skal være slået fra inden indsendelse til certificering.

• Hvis Expression.Evaluate() bruges:

  • Valider, hvor udtrykket kommer fra, og hvad det er (det vil sige, kan dynamisk oprette kald Extension.CurrentCredentials() til og så videre).
  • skal Expression ikke være angivet af brugeren eller tage brugerinput.
  • Expressionmå ikke være dynamisk (det vil sige hentet fra et webkald).

Registrering til certificering

Hvis du er interesseret i at forfølger certificering af din brugerdefinerede connector, skal du sørge for, at dit scenarie og din connector opfylder de forudsætninger og krav, der er beskrevet i denne artikel. Hvis du ikke gør det, vil det medføre 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 connectoren er fuldstændig kode og er blevet testet i både oprettelse i Power BI Desktop og opdatering og forbrug i Power BI service. Sørg for, at du har testet fuld opdatering fra ende til anden i Power BI Service ved hjælp af en datagateway i det lokale miljø.

Du kommer i gang ved at udfylde registreringsformularen,så kontakter Microsoft dig for at starte processen.

Skabelonapps (anbefales)

Når du har udviklet en connector til en datakilde, kan du overveje at hjælpe kunderne med at komme i gang hurtigt ved at oprette et skabelonapp. Med en skabelonapp kan kunderne få en færdigindstillet rapport med forbindelse til deres data, som de kan bruge direkte eller tilpasse efter behov.