Certifiering av Power Query-Anslut eller

  • Artikel

Kommentar

Den här artikeln beskriver kraven och processen för att skicka en anpassad Power Query-anslutningsapp för certifiering. Läs hela artikeln noga innan du påbörjar certifieringsprocessen.

Introduktion

Med Power Query SDK kan alla skapa en anpassad Power Query-anslutningsapp för att ansluta till en datakälla från Power Query. För närvarande stöds anpassade anslutningsappar endast i Power BI-semantiska modeller (Power BI Desktop och Power BI-tjänst) och kräver användning av en lokal datagateway för uppdatering via Power BI-tjänst. Anpassade anslutningsappar måste distribueras individuellt av utvecklaren.

Ägare av datakällor som utvecklar en anpassad anslutningsapp för sin datakälla kanske vill distribuera sin anpassade anslutningsapp bredare till Power Query-användare. När en anpassad anslutningsapp har skapats, använts och verifierats av slutanvändare kan datakällans ägare skicka den för Microsoft-certifiering.

Om du certifierar en anpassad Power Query-anslutningsapp blir anslutningsappen tillgänglig offentligt, out-of-box, i Power BI-semantiska modeller (Power BI Desktop och Power BI-tjänst), Power BI-dataflöden och Power BI-datamarter. Certifierade anslutningsappar stöds i PowerBI.com och alla versioner av Power BI Premium.

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 support för underhåll, men kundproblem med själva anslutningsappen dirigeras till partnerutvecklaren.

Skillnader mellan certifierade anslutningsappar och anpassade anslutningsappar

Certifierade anslutningsappar paketeras i Power BI Desktop och distribueras till Power BI-tjänsten, Power BI-dataflöden och Power BI-datamarter. Anpassade anslutningsappar stöds endast i Power BI-semantiska modeller och måste läsas in i Power BI Desktop, enligt beskrivningen i Läsa in tillägget i Power BI Desktop. Både certifierade och anpassade anslutningsappar kan uppdateras via Power BI Desktop eller Power BI-tjänsten med hjälp av en lokal datagateway genom att implementera ett test Anslut ion. Den lokala datagatewayen krävs för anpassade anslutningsappar.

Certifierade anslutningsappar i Power BI Desktop med en TestConnection implementering stöder även uppdatering från slutpunkt till slutpunkt via molnet (Power BI-tjänsten) utan att en lokal datagateway behövs. Den Power BI-tjänst miljön är i princip värd för en "molngateway" som körs på samma sätt 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.

Både anpassade och certifierade anslutningsappar med extra komponenter (till exempel ODBC-drivrutin) behöver den extra komponenten för att installeras på slutanvändarens dator och kräva den lokala datagatewayen, såvida inte den extra komponenten distribueras till Power BI-molnet. För närvarande certifierar och distribuerar vi inga nya extra komponenter till Power BI-molnet, så certifieringen av anslutningsappar med ett beroende av en extra komponent tar inte bort kravet på lokal datagateway.

Distribution av anpassad anslutningsapp

Anpassade anslutningsappar kan och bör distribueras till slutanvändare före certifiering.

Eftersom M är ett mångsidigt språk som, enligt autentiseringshanteringen, 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 en utvecklares perspektiv måste utvecklare själv signera sin anpassade anslutningsapp och ge sina användare information (tumavtryck) 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. Alternativt kan användarna välja att sänka sina säkerhetsinställningar för att tillåta inläsning av kod som inte har certifierats av Microsoft eller någon annan utvecklare, men det här alternativet 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 endast anslutningsappar som uppfyller en uppsättning krav för certifiering:

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

  • Anslutningsappen måste betraktas som kodad för en första versionsversion. Programmet tillåter frekventa iterationer och uppdateringar. Observera att Microsoft inte erbjuder teknisk hjälp eller utveckling av anpassade anslutningsappar. Vi rekommenderar att du använder offentliga resurser, till exempel vår SDK-dokumentation och exempellagringsplats. Om du behöver ytterligare hjälp kan vi dela en lista över kända utvecklingskonsulter för anpassade anslutningsappar från tredje part som du kanske vill engagera direkt, separat från alla Microsoft-program eller partnerskap. Observera att Microsoft inte är anslutet till någon av dessa konsulter och inte ansvarar för din användning av deras tjänster. Microsoft tillhandahåller listan för din bekvämlighet och utan några garantier, rekommendationer eller garantier. Kontakta din Microsoft-certifieringskontakt om du vill veta mer.

  • Utvecklaren måste ange en uppskattning för användning. Vi föreslår att utvecklare av anslutningsappar för mycket boutiqueprodukter använder våra självsigneringsfunktioner för anslutningsprogram för att tillhandahålla dem direkt till kunden.

  • Anslutningsappen måste redan göras tillgänglig för kunder direkt för att uppfylla ett användarbehov eller ett affärsscenario. Det här villkoret kan uppfyllas 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 om att det finns ett affärsbehov för anslutningsappen och att anslutningsappen fungerar korrekt för att uppfylla sina affärskrav.

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

  • Det måste finnas en tråd i Power BI Ideas-forumet som drivs av kunder för att ange efterfrågan på att göra anslutningsappen offentligt tillgänglig i Power BI Desktop. Det finns ingen angivet tröskelvärde för engagemang. Men ju mer engagemang, desto starkare bevis 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ärsbehov som måste användas och stödjas efter certifiering.

Process och tidslinjer

Certifierade anslutningsappar släpps med månatliga Power BI Desktop-versioner, så tidsgränserna för varje version fungerar tillbaka från varje Utgivningsdatum för Power BI Desktop. Den förväntade varaktigheten för certifieringsprocessen från registrering till lansering varierar beroende på kvaliteten och komplexiteten i anslutningens insändning. Microsoft tillhandahåller inga specifika tidslinjegarantier för granskning och godkännande av anslutningsappar. De hårda tidsgränserna för varje granskning av anslutningsappen beskrivs i följande steg, men Microsoft garanterar inte efterlevnad av dessa tidslinjer.

  • Registrering: meddelande om avsikt att certifiera din anpassade anslutningsapp. Den här registreringen måste ske den 15:e i månaden, två månader före den riktade Power BI Desktop-versionen.

    • För power BI Desktop-versionen i april skulle tidsgränsen till exempel vara den 15 februari.

  • Inlämning: överföring av anslutningsfiler för Microsoft-granskning. Den här insändningen måste ske den 1:a i månaden innan den riktade Power BI Desktop-versionen.

    • För power BI Desktop-versionen i april skulle tidsgränsen till exempel vara 1 mars.

  • Teknisk granskning: slutförande av anslutningsfilerna, godkännande av Microsoft-granskning och certifiering. Den här granskningen måste ske den 15:e i månaden innan den riktade Power BI Desktop-versionen.

    • För power BI Desktop-versionen i april skulle tidsgränsen till exempel vara den 15 mars.

På grund av komplexiteten i tekniska granskningar och potentiella fördröjningar, problem med omarkitektur och testning rekommenderar vi starkt att du skickar tidigt med lång ledtid för den första versionen och certifieringen. Om du känner att din anslutningsapp är viktig för att leverera till några få kunder med minimala omkostnader rekommenderar vi självsignering och tillhandahålla det på det sättet.

Certifieringskraven

Vi har en viss uppsättning krav för certifiering. Vi inser att inte alla utvecklare kan uppfylla dessa krav, och vi hoppas kunna introducera en funktionsuppsättning som hanterar utvecklarbehov i kort ordning.

Överföringsfiler (artefakter)

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

  • Anslut ellerfil (.mez)

    • .mez-filen bör följa formatmallsstandarder och namnges på samma sätt som produkt- eller tjänstnamnet. Den får inte innehålla ord som "Power BI", "Anslut or" eller "API".
    • Ge .mez-filen namnet: ProductName.mez

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

    • Vi behöver en Power BI-exempelrapport (.pbix) för att testa din anslutningsapp med.
    • Rapporten bör innehålla minst en fråga för att testa varje objekt i navigeringstabellen.
    • Om det inte finns något angivet 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 din anslutningsapp.
    • Ange ett testkonto som är beständigt, så att vi kan använda samma konto för att certifiera eventuella framtida uppdateringar.

  • Testinstruktioner

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

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

Funktioner och formatmallar

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

  • Anslutningsappen MÅSTE:

    • Använd avsnittsdokumentformat.
    • Innehåller ett versionshuvud/utsmyckning ovanför avsnittsdokumentet.
    • Ange metadata för funktionsdokumentation.
    • Ha Test Anslut ion-hanteraren.
    • Följ namngivningskonventionerna (till exempel DataSourceKind.FunctionName). Den får inte innehålla ord som "Power BI", "Anslut or" eller "API".
    • Låt betaflaggan vara inställd på Sant vid den första versionen.

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

  • Anslutningsappen SKA:

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

Säkerhet

Det finns specifika säkerhetsöverväganden som anslutningsappen måste hantera.

  • Om Extension.CurrentCredentials() används:

    • Krävs användningen? I så fall, var skickas autentiseringsuppgifterna till?
    • Garanteras begäranden via HTTPS?
    • Om autentiseringsuppgifterna skickas via Web.Contents() GET:
      • Kan det omvandlas till en POST?
      • Om GET krävs måste anslutningsappen CredentialQueryString använda posten i Web.Contents() alternativposten för att skicka in känsliga autentiseringsuppgifter.

  • Om diagnostik.* 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 på. Den här spårningen måste inaktiveras innan du skickar in för certifiering.

  • Om Expression.Evaluate() används:

    • Kontrollera var uttrycket kommer från och vad det är (det vill vill: kan dynamiskt konstruera anrop till Extension.CurrentCredentials() och så vidare).
    • Ska Expression inte vara användaren tillhandahålls eller ta användarindata.
    • Expression Bör inte vara dynamisk (det vill säga hämtas från ett webbanrop).

Registrera dig för certifiering

Om du är intresserad av att certifiera din anpassade anslutningsapp kontrollerar du att scenariot och anslutningsappen uppfyller de förutsättningar och krav som beskrivs i den här artikeln. Om du inte gör det kommer det att orsaka fördröjningar i certifieringen eftersom vårt team kräver att du åtgärdar eventuella problem eller inkonsekvenser innan du går vidare med certifieringen.

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

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

Efter certifiering

När anslutningsappen har certifierats och släppts via Power BI Desktop och Power BI-tjänst finns det några saker som du bör göra för att säkerställa att du kan använda den offentligt tillgängliga certifierade anslutningsappen för produktion.

  • Du och slutanvändarna bör använda den certifierade anslutningsversionen som ingår i Power BI Desktop och den lokala datagatewayen och ta bort alla befintliga .mez- eller .pqx-filer (anpassade anslutningsappar) som användes före certifieringen. Om du inte gör det kan det leda till att din anpassade anslutningsapp för testning används av Power Query oavsiktligt i stället för den nyligen certifierade anslutningsappen.
  • Anpassade anslutningsappar bör endast användas för att testa nya versioner av anslutningsappen.
  • När du arbetar med slutanvändare och kunder ska du se till att de förstår den anpassade anslutningsversion som används vid testning före certifieringen ska tas bort när testningen är klar och den nya certifierade anslutningsversionen är tillgänglig.

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

Kommentar

Mallappar stöder inte anslutningsappar som kräver en gateway.