Power Query connectorcertificering

Introductie

Door een Power Query connector te certificeren, wordt de connector openbaar, out-of-box, beschikbaar binnen Power BI Desktop. Gecertificeerde connectors worden ondersteund in PowerBI.com en alle versies van Power BI Premium, met uitzondering van gegevensstromen. Certificering is onderworpen aan het Connector Certification Program van Microsoft, waar Microsoft samen met partnerontwikkelaars de mogelijkheden voor gegevensconnectiviteit van Power BI.

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 hebben in onderhoud, maar klantproblemen met de connector zelf worden doorgestuurd naar de partnerontwikkelaar.

Gecertificeerde connectors worden out-of-box gebundeld in Power BI Desktop. Aangepaste connectors moeten worden geladen in Power BI Desktop, zoals beschreven in Uw extensie laden in Power BI Desktop. Beide kunnen worden vernieuwd via Power BI Desktop of Power BI Service met behulp van een on-premises gegevensgateway door een TestConnection te implementeren.

Gecertificeerde connectors met een implementatie ondersteunen ook end-to-end vernieuwen via de cloud (Power BI Service) zonder dat u een TestConnection on-premises gegevensgateway nodig hebt. De Power BI serviceomgeving host in feite 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. Er zijn aanvullende vereisten voor connectors die aanvullende onderdelen moeten gebruiken, zoals een odbc-stuurprogramma. Neem contact op met uw contactpersoon van Microsoft als voor uw connector het gebruik van aanvullende onderdelen is vereist.

Beveiliging en ondertekening van aangepaste connectors

Omdat M een veelzijdige taal is die, zoals te zien is inVerificatie verwerken, de mogelijkheid 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 de informatie (vingerafdruk) verstrekken 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 dit wordt niet aanbevolen.

Overzicht van certificering

Vereisten

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

• De connector moet voor een openbaar product zijn.

• De connector moet worden beschouwd als code-voltooid voor een eerste versie. Het programma maakt regelmatige iteraties en updates mogelijk. Houd er rekening mee dat Microsoft niet rechtstreeks technisch advies biedt voor de ontwikkeling van aangepaste connectors. Als onderdeel van het programma kan Microsoft echter resources aanbevelen aan ontwikkelaars om verder contact mee te houden. Als u zich hebt geregistreerd bij het onderstaande programma, kunt u contact opnemen met uw contactpersoon van Microsoft voor meer informatie.

• De ontwikkelaar moet een schatting voor het gebruik geven. We raden ontwikkelaars van connectors voor zeer geavanceerde producten aan om de mogelijkheden voor zelf-ondertekening van de connector te gebruiken om ze rechtstreeks aan de klant te leveren.

• De connector moet al rechtstreeks beschikbaar zijn gesteld aan klanten om te voldoen aan de behoeften van een gebruiker of een bedrijfsscenario. Dit kan worden gedaan met behulp van een private preview-programma door de voltooide connector rechtstreeks naar eindgebruikers en organisaties te distribueren via zelf-ondertekening. Elke gebruiker of organisatie moet feedback en validatie kunnen geven dat de connector nodig is voor het bedrijf en dat de connector goed werkt om aan de bedrijfsvereisten te voldoen.

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

• Er moet een thread aanwezig zijn in het forum Power BI Ideas, aangestuurd door klanten om aan te geven dat de vraag is om de connector openbaar beschikbaar te maken in Power BI Desktop. Er is geen ingesteld drempelwaarde voor betrokkenheid. Hoe meer betrokkenheid, hoe sterker de aangetoonde vraag naar de connector.

Deze vereisten bestaan om ervoor te zorgen dat connectors die certificering ondergaan een aanzienlijke klant- en bedrijfswaarde hebben en na certificering moeten worden ondersteund.

Proces en tijdlijnen

Gecertificeerde connectors worden uitgebracht met maandelijkse Power BI Desktop releases, dus de deadlines voor elke release werken vanaf elke Power BI Desktop releasedatum. De verwachte duur van het certificeringsproces van registratie tot release is afhankelijk van de kwaliteit en complexiteit van het indienen van de connector en wordt beschreven in de volgende stappen:

• Registratie: melding van intentie om uw aangepaste connector te certificeren. Dit moet plaatsvinden op de 15e van de maand, twee maanden vóór de doelversie Power BI desktopversie.

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

• Indiening: verzending van connectorbestanden voor beoordeling door Microsoft. Dit moet de eerste van de maand vóór de doelversie Power BI desktopversie.

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

• Technische controle: de connectorbestanden zijn gefinificeert en door Microsoft zijn beoordeeld en gecertificeerd. Dit moet op de 15e van de maand plaatsvinden voordat de beoogde Power BI Desktop uitgebracht.

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

Vanwege de complexiteit van de technische beoordelingen en mogelijke vertragingen, opnieuw ontwikkelen en testen, raden we u ten zeerste aan om vroegtijdig in te dienen met een lange doorlooptijd voor de eerste release en certificering. Als u denkt dat uw connector belangrijk is om aan een aantal klanten te leveren met minimale overhead, raden we u aan zelf-ondertekening te gebruiken en deze op die manier te leveren.

Certificeringsvereisten

We hebben een bepaalde set vereisten voor certificering. We erkennen dat niet elke ontwikkelaar aan deze vereisten kan voldoen en we willen graag een functieset introduceren waarmee ontwikkelaarsbehoeften in korte volgorde kunnen worden verwerkt.

Indieningsbestanden (artefacten)

Zorg ervoor dat de connectorbestanden die u indient, het volgende bevatten:

• Connectorbestand (.mez)

  • Het .mez-bestand moet stijlstandaarden volgen en op dezelfde manier een naam krijgen als de product- of servicenaam. Het mag geen woorden bevatten zoals 'Power BI', 'Connector' of 'API'.
  • Noem het MEZ-bestand: ProductName.mez

• Power BI Desktop (.pbix) voor testen

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

• Testaccount voor 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 het testen van de functionaliteit.

• 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:

  • Gebruik de documentindeling Sectie.
  • Versie-versie-versie in de sectie hebben.
  • Geef metagegevens van de functiedocumentatie op.
  • TestConnection-handler hebben.
  • Volg de naamconventen (bijvoorbeeld DataSourceKind.FunctionName ). Het mag geen woorden bevatten zoals 'Power BI', 'Connector' of 'API'.

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

• De connector MOET:

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

Beveiliging

Er zijn specifieke beveiligingsoverwegingen die uw connector moet afhandelen.

• Als Extension.CurrentCredentials() wordt gebruikt:

  • Is het gebruik vereist? Zo ja, waar worden de referenties dan naar verzonden?
  • Worden de aanvragen gegarandeerd gemaakt via HTTPS?
    • U kunt de helperfunctie voor HTTPS-afdwinging gebruiken.
  • Als de referenties worden verzonden met Web.Contents() behulp van via GET:
    • Kan deze 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:

  • Valideer 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 worden uitgevoerd. Dit moet worden uitgeschakeld voordat u zich indient voor certificering.

• Als Expression.Evaluate() wordt gebruikt:

  • Valideer waar de expressie vandaan komt en wat deze is (dat wil zeggen, kan dynamisch aanroepen naar, Extension.CurrentCredentials() etc.) maken.
  • De Expression mag niet door de gebruiker worden opgegeven en mag geen invoer van de gebruiker hebben.
  • De Expression mag niet dynamisch zijn (dat wil zeggen, opgehaald uit een webaanroep).

Registreren voor certificering

Als u de certificering van uw aangepaste connector wilt behouden, 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, kan dit leiden tot vertragingen in de certificering, omdat ons team u verplicht om eventuele problemen of inconsistenties op te lossen voordat u verder gaat met certificering.

Zorg ervoor dat uw connector code voltooid is en is getest in zowel ontwerp in Power BI Desktop als vernieuwen en verbruik in Power BI Service. Zorg ervoor dat u een volledige end-to-end vernieuwing hebt getest in Power BI Service door gebruik te maken van een on-premises gegevensgateway.

Vul ons registratieformulier in om aan de slag tegaan. Een contactpersoon van Microsoft neemt contact op met de contactpersoon om het proces te starten.

Sjabloon-apps (aanbevolen)

Nadat u een connector voor een gegevensbron hebt ontwikkeld, kunt u klanten helpen om snel aan de hand van een sjabloon-app aan dewerk te gaan. Een sjabloon-app biedt klanten een vooraf gemaakt rapport dat is verbonden met hun gegevens, dat ze direct kunnen gebruiken of indien nodig kunnen aanpassen.