Power Query Verbinding maken or-certificering

  • Artikel

Notitie

In dit artikel worden de vereisten en het proces beschreven voor het indienen van een aangepaste Power Query-connector voor certificering. Lees het hele artikel nauw voordat u het certificeringsproces start.

Inleiding

Met de Power Query SDK kan iedereen een aangepaste Power Query-connector maken om vanuit Power Query verbinding te maken met een gegevensbron. Op dit moment worden aangepaste connectors alleen ondersteund in semantische Power BI-modellen (Power BI Desktop en Power BI-service) en is het gebruik van een on-premises gegevensgateway vereist om te vernieuwen via Power BI-service. Aangepaste connectors moeten afzonderlijk worden gedistribueerd door de ontwikkelaar.

Eigenaren van gegevensbronnen die een aangepaste connector voor hun gegevensbron ontwikkelen, willen mogelijk hun aangepaste connector breder distribueren naar Power Query-gebruikers. Zodra een aangepaste connector is gemaakt, gebruikt en gevalideerd door eindgebruikers, kan de eigenaar van de gegevensbron deze indienen voor Microsoft-certificering.

Door een aangepaste Power Query-connector te certificeren, wordt de connector openbaar, out-of-box, beschikbaar in semantische Power BI-modellen (Power BI Desktop en Power BI-service), Power BI-gegevensstromen en Power BI-gegevensmarts. Gecertificeerde connectors worden ondersteund in PowerBI.com en alle versies van Power BI Premium.

Gecertificeerde connectors zijn:

  • Onderhouden door de partnerontwikkelaar

  • Ondersteund door de partnerontwikkelaar

  • Gecertificeerd door Microsoft

  • Gedistribueerd door Microsoft

We werken samen met partners om ervoor te zorgen dat ze ondersteuning in onderhoud hebben, maar klantproblemen met de connector zelf worden doorgestuurd naar de partnerontwikkelaar.

Gecertificeerde connector- en aangepaste connectorverschillen

Gecertificeerde connectors worden standaard gebundeld in Power BI Desktop en geïmplementeerd in power BI-service, Power BI-gegevensstromen en Power BI-datamarts. Aangepaste connectors worden alleen ondersteund in semantische Power BI-modellen en moeten worden geladen in Power BI Desktop, zoals beschreven in het laden van uw extensie in Power BI Desktop. Zowel gecertificeerde als aangepaste connectors kunnen worden vernieuwd via Power BI Desktop of Power BI-service met behulp van een on-premises gegevensgateway door een test Verbinding maken ion te implementeren. De on-premises gegevensgateway is vereist voor aangepaste connectors.

Gecertificeerde connectors in Power BI Desktop met een TestConnection implementatie ondersteunen ook end-to-end vernieuwing via de cloud (Power BI-service) zonder dat er een on-premises gegevensgateway nodig is. De Power BI-service-omgeving fungeert in feite als host voor een 'cloudgateway' die vergelijkbaar is met de on-premises gateway. Na certificering implementeren we uw connector in deze omgeving, zodat deze beschikbaar is voor alle Power BI-klanten.

Zowel aangepaste als gecertificeerde connectors met extra onderdelen (bijvoorbeeld ODBC-stuurprogramma) moeten het extra onderdeel op de computer van de eindgebruiker worden geïnstalleerd en de on-premises gegevensgateway vereisen, tenzij het extra onderdeel wordt geïmplementeerd in de Power BI-cloud. Op dit moment certificeren en implementeren we geen nieuwe extra onderdelen in de Power BI-cloud, zodat de certificering van connectors met een afhankelijkheid van een extra onderdeel de vereiste voor de on-premises gegevensgateway niet verwijdert.

Distributie van aangepaste connectors

Aangepaste connectors kunnen en moeten vóór certificering worden gedistribueerd naar eindgebruikers.

Omdat M een veelzijdige taal is die, zoals wordt gezien bij het verwerken van verificatie, de capaciteit heeft om te communiceren met opgeslagen referenties, moeten we gebruikers een manier bieden om alleen vertrouwde connectors uit te voeren.

Vanuit het perspectief van een ontwikkelaar moeten ontwikkelaars hun aangepaste connector zelf ondertekenen en hun gebruikers voorzien van de informatie (vingerafdruk) om deze veilig te laden.

Vanuit het perspectief van een gebruiker moeten gebruikers de vingerafdruk van de ontwikkelaar gebruiken om de aangepaste connector veilig te vertrouwen en te laden voor gebruik. Gebruikers kunnen er ook voor kiezen om hun beveiligingsinstellingen te verlagen om het laden van code toe te staan die niet is gecertificeerd door Microsoft of een andere ontwikkelaar, maar deze optie wordt niet aanbevolen.

Certificeringsoverzicht

Vereisten

Om de beste ervaring voor onze klanten te garanderen, houden we alleen rekening met connectors die voldoen aan een set vereisten voor certificering:

  • De connector moet voor een openbaar product zijn.

  • De connector moet worden beschouwd als code-complete voor een eerste releaseversie. Het programma maakt frequente iteraties en updates mogelijk. Microsoft biedt geen technische hulp of advies voor het ontwikkelen van aangepaste connectors. We raden u aan gebruik te maken van openbare resources, zoals onze SDK-documentatie en opslagplaats met voorbeelden. Als u meer hulp nodig hebt, kunnen we een lijst delen met bekende, aangepaste connectorontwikkelingsadviseurs van derden die u rechtstreeks wilt betrekken, gescheiden van elk Microsoft-programma of -partnerschap. Houd er rekening mee dat Microsoft niet is aangesloten bij een van deze consultants en niet verantwoordelijk is voor uw gebruik van hun services. Microsoft biedt de lijst voor uw gemak en zonder enige zekerheid, aanbevelingen of garanties. Neem contact op met uw microsoft-certificeringsmedewerker voor meer informatie.

  • De ontwikkelaar moet een schatting voor het gebruik opgeven. We raden u aan dat ontwikkelaars van connectors voor zeer boetiekproducten gebruikmaken van de mogelijkheden voor zelfondertekening van onze connector om ze rechtstreeks aan de klant te bieden.

  • De connector moet al rechtstreeks beschikbaar worden gesteld aan klanten om te voldoen aan een gebruikersbehoefte of bedrijfsscenario. Aan deze criteria kan worden voldaan met behulp van een private preview-programma door de voltooide connector rechtstreeks te distribueren naar eindgebruikers en organisaties via zelfondertekening. Elke gebruiker of organisatie moet feedback en validatie kunnen geven dat er een zakelijke behoefte is aan de connector en dat de connector werkt om aan hun zakelijke vereisten te voldoen.

  • De connector moet goed werken op een verwacht gebruiksniveau van klanten.

  • Er moet een thread zijn in het Power BI Ideas-forum dat door klanten wordt aangestuurd om aan te geven dat de connector openbaar beschikbaar moet worden gemaakt in Power BI Desktop. Er is geen drempelwaarde voor betrokkenheid ingesteld. Hoe meer betrokkenheid, hoe sterker de bewijsvraag voor de connector.

Deze vereisten bestaan om ervoor te zorgen dat connectors die worden gecertificeerd een aanzienlijke klant en bedrijf hebben, moeten worden gebruikt en ondersteund na certificering.

Proces en tijdlijnen

Gecertificeerde connectors worden uitgebracht met maandelijkse Power BI Desktop-releases, dus de deadlines voor elk releasewerk vanaf elke releasedatum van Power BI Desktop. De verwachte duur van het certificeringsproces van registratie tot release is afhankelijk van de kwaliteit en complexiteit van het indienen van de connector. Microsoft biedt geen specifieke tijdlijngaranties met betrekking tot de beoordeling en goedkeuring van connectors. De vaste deadlines voor elke connectorbeoordeling worden beschreven in de volgende stappen, maar Microsoft biedt geen garantie voor naleving van deze tijdlijnen.

  • Registratie: melding van intentie om uw aangepaste connector te certificeren. Deze registratie moet plaatsvinden op de 15e van de maand, twee maanden vóór de beoogde Versie van Power BI Desktop.

    • Voor de power BI Desktop-release van april is de deadline bijvoorbeeld 15 februari.

  • Inzending: indiening van connectorbestanden voor Microsoft-beoordeling. Deze inzending moet plaatsvinden op de 1e van de maand vóór de beoogde Versie van Power BI Desktop.

    • Voor de power BI Desktop-release van april is de deadline bijvoorbeeld 1 maart.

  • Technische beoordeling: voltooien van de connectorbestanden, het doorgeven van Microsoft-beoordeling en -certificering. Deze beoordeling moet plaatsvinden op de 15e van de maand vóór de beoogde Versie van Power BI Desktop.

    • Voor de power BI Desktop-release van april is de deadline bijvoorbeeld 15 maart.

Vanwege de complexiteit van de technische beoordelingen en mogelijke vertragingen, herarchitecture en testproblemen, raden we u ten zeerste aan om vroeg te verzenden met een lange doorlooptijd voor de eerste release en certificering. Als u denkt dat uw connector belangrijk is voor een paar klanten met minimale overhead, raden we u aan zelfondertekening te geven en op die manier te leveren.

Certificeringsvereisten

We hebben een aantal vereisten voor certificering. We erkennen dat niet elke ontwikkelaar aan deze vereisten kan voldoen en we hopen een functieset te introduceren die de behoeften van ontwikkelaars in korte volgorde afhandelt.

Inzendingsbestanden (artefacten)

Zorg ervoor dat de connectorbestanden die u verzendt, alle volgende items bevatten:

  • Verbinding maken orbestand (.mez)

    • Het .mez-bestand moet voldoen aan stijlstandaarden en moet op dezelfde manier worden genoemd als de product- of servicenaam. Het mag geen woorden bevatten zoals 'Power BI', 'Verbinding maken or' of 'API'.
    • Geef het mez-bestand de naam: ProductName.mez

  • Power BI Desktop-bestand (.pbix) voor testen

    • We hebben een Power BI-voorbeeldrapport (.pbix) nodig om uw connector te testen.
    • Het rapport moet ten minste één query bevatten om elk item in de navigatietabel te testen.
    • Als er geen schema is ingesteld (bijvoorbeeld databases), moet het rapport een query bevatten voor elk type tabel dat de connector kan verwerken.

  • Account testen op uw gegevensbron

    • We gebruiken het testaccount om uw connector te testen en problemen op te lossen.
    • Geef een testaccount op dat permanent is, zodat we hetzelfde account kunnen gebruiken om toekomstige updates te certificeren.

  • Testinstructies

    • Geef documentatie over het gebruik van de connector en test de functionaliteit ervan.

  • Koppelingen naar externe afhankelijkheden (bijvoorbeeld ODBC-stuurprogramma's)

Functies en stijl

De connector moet een set functie- en stijlregels volgen om te voldoen aan een bruikbaarheidsstandaard die consistent is met andere gecertificeerde connectors.

  • De connector MOET:

  • Het FunctionName moet zinvol zijn voor het domein (bijvoorbeeld 'Inhoud', 'Tabellen', 'Document', 'Databases', enzovoort).

  • De connector MOET:

    • Pictogrammen hebben.
    • Geef een navigatietabel op.
    • Plaats tekenreeksen in een resources.resx bestand. URL's en waarden moeten worden vastgelegd in de connectorcode en moeten niet in het resources.resx bestand worden geplaatst.

Beveiliging

Er zijn specifieke beveiligingsoverwegingen die uw connector moet verwerken.

  • Als Extension.CurrentCredentials() wordt gebruikt:

    • Is het gebruik vereist? Zo ja, waar worden de referenties naar verzonden?
    • Worden de aanvragen gegarandeerd via HTTPS gedaan?
    • Als de referenties worden verzonden via Web.Contents() GET:
      • Kan het worden omgezet in een POST?
      • Als GET is vereist, moet de connector de CredentialQueryString record in de Web.Contents() optiesrecord gebruiken om gevoelige referenties door te geven.

  • Als diagnostische gegevens.* functies worden gebruikt:

    • Valideren wat er wordt getraceerd; gegevens mogen geen PII of grote hoeveelheden onnodige gegevens bevatten.
    • Als u belangrijke tracering in ontwikkeling hebt geïmplementeerd, moet u een variabele of functievlag implementeren die bepaalt of tracering moet zijn ingeschakeld. Deze tracering moet worden uitgeschakeld voordat u de certificering indient.

  • Als Expression.Evaluate() wordt gebruikt:

    • Valideer waar de expressie vandaan komt en wat deze is (dat wil gezegd, kan dynamisch aanroepen naar Extension.CurrentCredentials() enzovoort maken).
    • De Expression gebruiker mag niet worden opgegeven en mag geen gebruikersinvoer gebruiken.
    • De Expression naam mag niet dynamisch zijn (dat wil gezegd, opgehaald uit een webgesprek).

Registreren voor certificering

Als u geïnteresseerd bent in certificering van uw aangepaste connector, moet u ervoor zorgen dat uw scenario en connector voldoen aan de vereisten en vereisten die in dit artikel worden beschreven. Als u dit niet doet, leidt dit tot vertragingen in certificering, omdat ons team u nodig heeft om eventuele problemen of inconsistenties op te lossen voordat u verdergaat met certificering.

Zorg ervoor dat uw connector is voltooid en dat deze is getest in zowel ontwerpen in Power BI Desktop als vernieuwen en verbruiken in de Power BI-service. Zorg ervoor dat u de volledige end-to-end vernieuwing in de Power BI-service hebt getest via het gebruik van een on-premises gegevensgateway.

Om aan de slag te gaan, vult u ons registratieformulier in en neemt u contact op met een Microsoft-contactpersoon om het proces te starten.

Na certificering

Nadat uw connector is gecertificeerd en uitgebracht via Power BI Desktop en Power BI-service, zijn er enkele dingen die u moet doen om ervoor te zorgen dat u de door productie geïmplementeerde openbaar beschikbare gecertificeerde connector correct kunt gebruiken.

  • U en eindgebruikers moeten de gecertificeerde connectorversie gebruiken die is opgenomen in Power BI Desktop, en de on-premises gegevensgateway, en bestaande .mez- of .pqx-bestanden (aangepaste connectors) verwijderen die vóór certificering worden gebruikt. Als u dit niet doet, kan dit ertoe leiden dat uw aangepaste testconnector per ongeluk door Power Query wordt gebruikt in plaats van de zojuist gecertificeerde connector.
  • Aangepaste connectors mogen alleen worden gebruikt om nieuwe versies van de connector te testen.
  • Wanneer u met eindgebruikers en klanten werkt, moet u ervoor zorgen dat ze weten welke versie van de aangepaste connector wordt gebruikt bij het testen voordat de certificering is voltooid en dat de nieuwe gecertificeerde connectorversie beschikbaar is.

Zodra u een connector voor een gegevensbron hebt ontwikkeld, kunt u klanten helpen snel aan de slag te gaan door een sjabloon-app te maken. Een sjabloon-app biedt klanten een vooraf samengesteld rapport dat is verbonden met hun gegevens die ze standaard kunnen gebruiken of waar nodig kunnen aanpassen.

Notitie

Sjabloon-apps bieden geen ondersteuning voor connectors waarvoor een gateway is vereist.