TripPin deel 9 - TestConnection
Deze meerdelige zelfstudie gaat over het maken van een nieuwe gegevensbronextensie voor Power Query. De zelfstudie is bedoeld om opeenvolgend te worden uitgevoerd elke les is gebaseerd op de connector die in de vorige lessen is gemaakt, en voegt incrementeel nieuwe mogelijkheden toe — aan uw connector.
In deze les gaat u het volgende doen:
- Een TestConnection-handler toevoegen
- De on-premises gegevensgateway configureren (persoonlijke modus)
- Geplande vernieuwing via de Power BI testen
Ondersteuning voor aangepaste connectors is toegevoegd aan de release van april 2018 van de persoonlijke on-premises gegevensgateway. Met deze nieuwe functionaliteit (preview) kunt u rapporten plannen die gebruikmaken van uw aangepaste connector.
In deze zelfstudie wordt het proces voor het inschakelen van uw connector voor vernieuwen be behandelen en vindt u een beknopt overzicht van de stappen voor het configureren van de gateway. U gaat met name het volgende doen:
- Een TestConnection-handler toevoegen aan uw connector
- De on-premises gegevensgateway installeren in de persoonlijke modus
- Ondersteuning voor aangepaste connectors inschakelen in de gateway
- Een werkmap publiceren die gebruikmaakt van uw connector voor PowerBI.com
- Geplande vernieuwing configureren om uw connector te testen
Zie Handling Gateway Support (Gatewayondersteuning verwerken) voor meer informatie over de TestConnection-handler.
Achtergrond
Er zijn drie vereisten voor het configureren van een gegevensbron voor geplande vernieuwing met behulp PowerBI.com:
- De gegevensbron wordt ondersteund: Dit betekent dat de doelgatewayomgeving op de hoogte is van alle functies in de query die u wilt vernieuwen.
- Referenties worden opgegeven: Als u het juiste dialoogvenster voor referentie-invoer wilt weergeven, Power BI het ondersteuningsverificatiemechanisme voor een bepaalde gegevensbron weten.
- De referenties zijn geldig: Nadat de gebruiker referenties heeft verstrekt, wordt deze gevalideerd door de handler van de
TestConnectiongegevensbron aan te roepen.
De eerste twee items worden verwerkt door uw connector bij de gateway te registreren. Wanneer de gebruiker geplande vernieuwing in PowerBI.com probeert te configureren, worden de querygegevens naar uw persoonlijke gateway verzonden om te bepalen of er gegevensbronnen beschikbaar zijn die niet worden herkend door de Power BI-service (dat wil zeggen aangepaste gegevens die u hebt gemaakt). Het derde item wordt verwerkt door het aanroepen van de TestConnection-handler die is gedefinieerd voor uw gegevensbron.
Een TestConnection-handler toevoegen
De Handler TestConnection wordt toegevoegd aan de declaratierecord Soort gegevensbron (dezelfde plaats waar u de ondersteunde verificatietype(s) declareer).
De handler is een function met één parameter van het type , die een any retourneert. list
De eerste waarde in de lijst is de functie die wordt aangeroepen om de verbinding daadwerkelijk te testen. Dit is in het algemeen hetzelfde als uw belangrijkste gegevensbronfunctie.
In sommige gevallen moet u mogelijk een afzonderlijke functie beschikbaar maken om een efficiënte verbindingstest te bieden, maar dit shared moet over het algemeen worden vermeden.
Omdat de gegevensbronfunctie TripPin geen vereiste argumenten heeft, is de implementatie voor TestConnection redelijk eenvoudig:
// Data Source Kind description
TripPin = [
// TestConnection is required to enable the connector through the Gateway
TestConnection = (dataSourcePath) => { "TripPin.Contents" },
Authentication = [
Anonymous = []
],
Label = "TripPin Part 9 - TestConnection"
];
Notitie
Toekomstige versies van de Power Query SDK bieden een manier om de TestConnection-handler te valideren vanuit Visual Studio. Op dit moment is de on-premises gegevensgateway het enige mechanisme dat gebruikmaakt van TestConnection.
Aangepaste connectors inschakelen in de persoonlijke gateway
Download en installeer de on-premises gegevensgateway. Wanneer u het installatieprogramma hebt uitgevoerd, selecteert u de persoonlijke modus.
Nadat de installatie is voltooid, start u de gateway en meld u zich aan bij Power BI. Tijdens het aanmeldingsproces wordt uw gateway automatisch geregistreerd bij de Power BI services. Nadat u bent aangemeld, voert u de volgende stappen uit:
- Selecteer het tabblad Connectors.
- Selecteer de schakelknop om ondersteuning voor aangepaste gegevensconnectoren in te schakelen.
- Selecteer de map waar u aangepaste connectors uit wilt laden. Dit is doorgaans dezelfde map die u gebruikt voor Power BI Desktop, maar de waarde kan worden geconfigureerd.
- Op de pagina worden nu alle extensiebestanden in uw doelmap weergegeven.

Zie de online documentatie voor meer informatie over de gateway.
Geplande vernieuwing testen
Open Power BI Desktop en maak een rapport dat gegevens importeert met behulp van de TripPin-connector.

Voeg een of meer visuals toe aan uw rapportpagina (optioneel) en publiceer het rapport vervolgens naar PowerBI.com.
Ga na het publiceren naar PowerBI.com en zoek de gegevensset voor het rapport dat u zojuist hebt gepubliceerd. Selecteer het beletselletsel en selecteer vervolgens Vernieuwen plannen. Vouw de secties Gatewayverbinding en Gegevensbronreferenties uit.

Notitie
Als op de configuratiepagina van de gegevensset wordt vermeld dat het rapport onbekende gegevensbronnen bevat, is uw gateway/aangepaste connector mogelijk niet goed geconfigureerd. Ga naar de gebruikersinterface van de configuratie van de persoonlijke gateway en zorg ervoor dat er geen fouten naast de TripPin-connector staan. Mogelijk moet u de gateway opnieuw opstarten (op het tabblad Service Instellingen) om de meest recente configuratie op te halen.
Selecteer de koppeling Referenties bewerken om het verificatiedialoogvenster te openen en selecteer vervolgens Aanmelden.
Notitie
Als er een fout wordt weergegeven die vergelijkbaar is met de onderstaande fout ('Kan gegevensbronreferenties niet bijwerken'), is er waarschijnlijk een probleem met uw TestConnection-handler.

Na een geslaagde aanroep van TestConnection worden de referenties geaccepteerd. U kunt nu vernieuwen plannen of het weglatingsellips van de gegevensset selecteren en vervolgens Nu vernieuwen selecteren. U kunt de koppeling Geschiedenis vernieuwen selecteren om de status van de vernieuwing weer te geven (in het algemeen duurt het enkele minuten voordat de vernieuwing is in gebruik).

Conclusie
Gefeliciteerd U hebt nu een aangepaste connector die gereed is voor productie en ondersteuning biedt voor automatisch vernieuwen via de Power BI service.