certifiering Power Query-anslutningsapp

Introduktion

När du certifierar Power Query anpassade anslutningsappen blir anslutningsappen tillgänglig offentligt, inifrån Power BI Desktop. Certifierade anslutningsappar stöds i PowerBI.com och alla versioner Power BI Premium, utom dataflöden. Certifieringen styrs av Microsofts certifieringsprogram för anslutningsprogram, där Microsoft samarbetar med partnerutvecklare för att utöka dataanslutningsfunktionerna i Power BI.

Certifierade anslutningsappar är:

• Underhålls av partnerutvecklaren

• Stöds av partnerutvecklaren

• Certifierad av Microsoft

• Distribuerad av Microsoft

Vi samarbetar med partner för att försöka se till att de har stöd för underhåll, men kundproblem med själva anslutningsappen dirigeras till partnerutvecklaren.

Certifierade anslutningsappar paketeras in-of-box i Power BI Desktop. Anpassade anslutningsappar måste läsas in i Power BI Desktop enligt beskrivningen i Läsa in tillägget i Power BI Desktop. Båda kan uppdateras via en Power BI Desktop eller Power BI-tjänst med hjälp av en lokal datagateway genom att implementera en TestConnection.

Certifierade anslutningsappar med en implementering har också stöd för uppdatering från dag till slut via molnet (Power BI Service) utan behov av TestConnection en lokal datagateway. Den Power BI är i princip värd för en "molngateway" som körs ungefär som den lokala gatewayen. Efter certifieringen distribuerar vi din anslutningsapp till den här miljön så att den är tillgänglig för alla Power BI kunder. Det finns ytterligare krav för anslutningsappar som behöver använda ytterligare komponenter, till exempel en ODBC-baserad drivrutin. Se till att kontakta din Microsoft-kontakt om din anslutningsapp kräver användning av ytterligare komponenter.

Säkerhet och signering för anpassad anslutningsapp

Eftersom M är ett mångsidigt språk som, som du ser i Hantering av autentisering ,har kapacitet att interagera med lagrade autentiseringsuppgifter, måste vi ge användarna ett sätt att endast tillåta att betrodda anslutningsappar körs.

Från utvecklarens perspektiv måste utvecklare själv signera sin anpassade anslutningsapp och ge användarna informationen (tumavtrycket) för att läsa in den på ett säkert sätt.

Från en användares perspektiv måste användarna använda tumavtrycket från utvecklaren för att på ett säkert sätt lita på och läsa in den anpassade anslutningsappen för användning. Användare kan också välja att sänka sina säkerhetsinställningar för att tillåta inläsning av kod som inte certifierats av Microsoft eller någon annan utvecklare, men detta rekommenderas inte.

Certifieringsöversikt

Förutsättningar

För att säkerställa bästa möjliga upplevelse för våra kunder överväger vi bara anslutningsappar som uppfyller en uppsättning krav för certifiering:

• Anslutningsappen måste vara för en offentlig produkt.

• Anslutningsappen måste betraktas som kod komplett för en första version. Programmet möjliggör frekventa iterationer och uppdateringar. Observera att Microsoft inte direkt erbjuder teknisk rådgivning för utveckling av anpassade anslutningsappar. Men som en del av programmet kan Microsoft rekommendera resurser som utvecklare kan använda för att engagera sig ytterligare. När du har registrerat dig med programmet nedan kontaktar du din Microsoft-kontakt om du vill veta mer.

• Utvecklaren måste ange en uppskattning av användningen. Vi föreslår att utvecklare av anslutningsappar för mycket dyra produkter använder våra funktioner för självsignering av anslutningsappar för att ge dem direkt till kunden.

• Anslutningsappen måste redan vara tillgänglig för kunder direkt för att uppfylla ett användar- eller affärsscenario. Detta kan göras med hjälp av ett privat förhandsversionsprogram genom att distribuera den färdiga anslutningsappen direkt till slutanvändare och organisationer via självsignering. Varje användare eller organisation bör kunna ge feedback och validering av att det finns ett affärsbehov för anslutningstjänsten och att anslutningsappen fungerar för att uppfylla sina affärsbehov.

• Anslutningsappen måste fungera på en förväntad användningsnivå av kunderna.

• Det måste finnas en tråd i Power BI Forum för idéer som drivs av kunder för att ange efterfrågan på att göra anslutningsappen offentligt tillgänglig i Power BI Desktop. Det finns inget fast tröskelvärde för engagemang. Ju mer engagemang, desto starkare bevisade efterfrågan på anslutningsappen.

Dessa förutsättningar finns för att säkerställa att anslutningsappar som genomgår certifiering har betydande kund- och affärskrav som måste användas och stödjas efter certifieringen.

Process och tidslinjer

Certifierade anslutningsappar släpps med månatliga Power BI Desktop versioner, så tidsgränserna för varje version går tillbaka från varje Power BI Desktop lanseringsdatum. Den förväntade varaktigheten för certifieringsprocessen från registrering till lansering varierar beroende på kvaliteten och komplexiteten för att skicka in anslutningsappen och beskrivs i följande steg:

• Registrering: meddelande om avsikt att certifiera din anpassade anslutningsapp. Detta måste inträffa den 15:e i månaden, två månader innan den avsedda versionen Power BI desktop.

  • Till exempel för april Power BI Desktop är tidsgränsen 15 februari.

• Inskickning: överföring av anslutningsfiler för Microsoft-granskning. Detta måste inträffa den 1:a i månaden innan målversionen Power BI skrivbordsversionen.

  • För aprilversionen Power BI Desktop tidsgränsen till exempel den 1 mars.

• Teknisk granskning: slutförande av anslutningsfilerna och godkännande av Microsofts granskning och certifiering. Detta måste inträffa den 15:e i månaden innan den avsedda versionen Power BI Desktop publiceringen.

  • Till exempel för april Power BI Desktop är tidsgränsen 15 mars.

På grund av komplexiteten i de tekniska granskningarna och potentiella fördröjningar, arkitekturomarkitekter och testningsproblem rekommenderar vi starkt att du skickar in tidigt med en lång ledtid för den första versionen och certifieringen. Om du tycker att din anslutningsapp är viktig för att leverera till ett fåtal kunder med minimala kostnader rekommenderar vi självsignering och att tillhandahålla det på det sättet.

Certifieringskraven

Vi har en viss uppsättning certifieringskrav. Vi är medvetna om att inte alla utvecklare kan uppfylla dessa krav och vi hoppas att införa en funktionsuppsättning som hanterar utvecklarbehov i kort ordning.

Skicka filer (artefakter)

Se till att anslutningsfilerna som du skickar innehåller följande:

• Anslutningsappsfil (.mez)

  • MEZ-filen bör följa formatstandarder och namnges på samma sätt som namnet på produkten eller tjänsten. Den bör inte innehålla ord som "Power BI", "Connector" eller "API".
  • Ge .mez-filen namnet: ProductName.mez

• Power BI Desktop (.pbix) för testning

  • Vi behöver en exempelrapport Power BI (.pbix) för att testa anslutningsappen med.
  • Rapporten bör innehålla minst en fråga för att testa varje objekt i navigeringstabellen.
  • Om det inte finns något schema (till exempel databaser) måste rapporten innehålla en fråga för varje "typ" av tabell som anslutningsappen kan hantera.

• Testa kontot till din datakälla

  • Vi använder testkontot för att testa och felsöka anslutningsappen.
  • Ange ett beständigt testkonto så att vi kan använda samma konto för att certifiera eventuella framtida uppdateringar.

• Testinstruktioner

  • Ange dokumentation om hur du använder anslutningsappen och testa dess funktioner.

• Länkar till externa beroenden (till exempel ODBC-drivrutiner)

Funktioner och stil

Anslutningsappen måste följa en uppsättning funktions- och stilregler för att uppfylla en användbarhetsstandard som är konsekvent med andra certifierade anslutningsappar.

• Anslutningsappen MÅSTE:

  • Använd dokumentformat för avsnitt.
  • Ha versionssmyckning i avsnittet .
  • Ange metadata för funktionsdokumentationen.
  • Ha TestConnection-hanteraren.
  • Följ namngivningskonventioner (till exempel DataSourceKind.FunctionName ). Den bör inte innehålla ord som "Power BI", "Connector" eller "API".

• FunctionNamebör vara meningsfullt för domänen (till exempel "Innehåll", "Tabeller", "Dokument", "Databaser" och så vidare).

• Anslutningsappen BÖR:

  • Ha ikoner.
  • Ange en navigeringstabell.
  • Placera strängar i en resources.resx fil. URL:er och värden ska vara hårdkodade i anslutningskoden och inte placeras i resources.resx filen.

Säkerhet

Det finns specifika säkerhetsaspekter som din anslutningsapp måste hantera.

• Om Extension.CurrentCredentials() används:

  • Krävs den här användningen? I så fall, var skickas autentiseringsuppgifterna?
  • Är det garanterat att begärandena görs via HTTPS?
    • Du kan använda hjälpfunktionen HTTPS-tvingande.
  • Om autentiseringsuppgifterna skickas med Web.Contents() via GET:
    • Kan den omvandlas till en POST?
    • Om GET krävs måste anslutningsappen använda posten CredentialQueryString i alternativposten Web.Contents() för att skicka in känsliga autentiseringsuppgifter.

• Om Diagnostics.*-funktioner används:

  • Verifiera vad som spåras. data får inte innehålla PII eller stora mängder onödiga data.
  • Om du har implementerat betydande spårning under utveckling bör du implementera en variabel- eller funktionsflagga som avgör om spårning ska vara aktiverat. Detta måste vara inaktiverat innan du skickar in för certifiering.

• Om Expression.Evaluate() används:

  • Kontrollera var uttrycket kommer från och vad det är (det vill säga kan dynamiskt konstruera anrop Extension.CurrentCredentials() till och så vidare).
  • ska Expression inte anges av användaren eller ta användarindata.
  • Expressionska inte vara dynamisk (det vill säga hämtas från ett webb-anrop).

Registrering för certifiering

Om du är intresserad av att fortsätta att certifiera din anpassade anslutningsapp ska du se till att ditt scenario och din anslutningsapp uppfyller de krav som beskrivs i den här artikeln. Om du inte gör det uppstår fördröjningar i certifieringen eftersom vårt team kräver att du åtgärdar eventuella problem eller inkonsekvenser innan du fortsätter med certifieringen.

Se till att anslutningsappen är kodad och har testats i både redigering i Power BI Desktop och uppdatering och förbrukning i Power BI Service. Se till att du har testat fullständig uppdatering från Power BI Service med hjälp av en lokal datagateway.

Kom igång genom att fylla i vårt registreringsformulärså kontaktar en Microsoft-kontakt dig för att påbörja processen.

Mallappar (rekommenderas)

När du har utvecklat en anslutning till en datakälla kan du hjälpa kunderna att komma igång snabbt genom att skapa en mallapp. En mallapp ger kunderna en förbyggd rapport som är ansluten till deras data och som de kan använda direkt eller anpassa efter behov.