TripPin del 9 - Test Koble til ion

Denne flerdelte opplæringen dekker opprettelsen av en ny datakildeutvidelse for Power Query. Opplæringen er ment å gjøres sekvensielt – hver leksjon bygger på koblingen som er opprettet i tidligere leksjoner, og legger trinnvis til nye funksjoner i koblingen.

I denne leksjonen gjør du følgende:

• Legg til en test Koble til ionbehandling
• Konfigurer lokal datagateway (personlig modus)
• Test planlagt oppdatering gjennom Power Bi-tjeneste

Egendefinert koblingsstøtte ble lagt til i april 2018-utgivelsen av den personlige lokale datagatewayen. Denne nye (forhåndsversjonsfunksjonaliteten) gjør det mulig for planlagt oppdatering av rapporter som bruker den egendefinerte koblingen.

Denne opplæringen dekker prosessen med å aktivere koblingen for oppdatering, og gir en rask gjennomgang av trinnene for å konfigurere gatewayen. Spesielt vil du:

1. Legg til en test Koble til ionbehandling i koblingen.
2. Installer den lokale datagatewayen i personlig modus.
3. Aktiver egendefinert støtte for Koble til or i gatewayen.
4. Publiser en arbeidsbok som bruker koblingen til å PowerBI.com.
5. Konfigurer planlagt oppdatering for å teste koblingen.

Gå til Behandling av gateway-støtte for mer informasjon om testbehandlingen Koble til ion.

Bakgrunn

Det finnes tre forutsetninger for å konfigurere en datakilde for planlagt oppdatering ved hjelp av PowerBI.com:

• Datakilden støttes: Dette betyr at målgatewaymiljøet er klar over alle funksjonene i spørringen du vil oppdatere.
• Legitimasjon er angitt: Hvis du vil presentere den riktige dialogboksen for legitimasjonsregistrering, må Power BI kjenne til støttegodkjenningsmekanismen for en gitt datakilde.
• Legitimasjonen er gyldig: Når brukeren har angitt legitimasjon, valideres de ved å kalle datakildens TestConnection behandling.

De to første elementene håndteres ved å registrere koblingen med gatewayen. Når brukeren prøver å konfigurere planlagt oppdatering i PowerBI.com, sendes spørringsinformasjonen til den personlige gatewayen for å finne ut om datakilder som ikke gjenkjennes av Power Bi-tjeneste (det vil si egendefinerte som du opprettet) er tilgjengelige der. Det tredje elementet håndteres ved å aktivere testbehandlingen Koble til ion som er definert for datakilden.

Legge til en test Koble til ionbehandling

Test Koble til ion-behandling legges til i deklarasjonsposten for datakildetypen (samme sted som du deklarerer godkjenningstypene som støttes). Behandleren er en function med én enkelt parameter av typen any, som returnerer en list. Den første verdien i listen er funksjonen som kalles for å teste tilkoblingen. Dette er vanligvis det samme som hoveddatakildefunksjonen. I noen tilfeller må du kanskje eksponere en egen shared funksjon for å gi en effektiv tilkoblingstest, men dette bør generelt unngås.

Siden TripPin-datakildefunksjonen ikke har noen nødvendige argumenter, er implementeringen for test Koble til ion ganske enkel:

// 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"
];

Merk

Du kan validere implementeringen av Test Koble til ion i Power Query SDK ved hjelp av kommandoen for Kjør test Koble til ion-funksjonen.

Aktivere egendefinerte koblinger i den personlige gatewayen

Last ned og installer den lokale datagatewayen. Når du kjører installasjonsprogrammet, velger du den personlige modusen.

Når installasjonen er fullført, starter du gatewayen og logger på Power BI. Påloggingsprosessen registrerer automatisk gatewayen med Power Bi-tjeneste. Når du er logget på, utfører du følgende trinn:

1. Velg fanen Koble til orer.
2. Velg bryteren for å aktivere støtte for egendefinerte datakoblinger.
3. Velg katalogen du vil laste inn egendefinerte koblinger fra. Dette vil vanligvis være den samme katalogen som du ville brukt for Power BI Desktop, men verdien kan konfigureres.
4. Siden skal nå vise alle filtypefilene i målkatalogen.

Gå til den elektroniske dokumentasjonen for mer informasjon om gatewayen.

Testing av planlagt oppdatering

Åpne Power BI Desktop, og opprett en rapport som importerer data ved hjelp av TripPin-koblingen.

Legg til ett eller flere visualobjekter på rapportsiden (valgfritt), og publiser deretter rapporten i PowerBI.com.

Når du har publisert, kan du gå til PowerBI.com og finne den semantiske modellen for rapporten du publiserte. Velg ellipsene, og velg deretter Planlegg oppdatering. Utvid inndelingene gatewaytilkobling og legitimasjon for datakilder.

Merk

Hvis konfigurasjonssiden for semantisk modell sier at rapporten inneholder ukjente datakilder, kan det hende at gatewayen/den egendefinerte koblingen ikke er riktig konfigurert. Gå til brukergrensesnittet for konfigurasjon av personlig gateway, og kontroller at det ikke er noen feil ved siden av TripPin-koblingen. Det kan hende du må starte gatewayen på nytt (på Innstillinger-fanen) for å hente den nyeste konfigurasjonen.

Velg koblingen Rediger legitimasjon for å hente frem godkjenningsdialogboksen, og velg deretter pålogging.

Merk

Hvis du får en feilmelding som ligner på den nedenfor ("Kan ikke oppdatere datakildelegitimasjonen"), har du mest sannsynlig et problem med testbehandlingen Koble til ion.

Etter et vellykket kall til Test Koble til ion, godtas legitimasjonen. Nå kan du planlegge oppdatering, eller velge ellipsen for semantisk modell, og deretter velge Oppdater nå. Du kan velge koblingen Oppdateringslogg for å vise statusen for oppdateringen (som vanligvis tar noen minutter å få startet).

Konklusjon

Gratulerer! Du har nå en egendefinert produksjonsklar kobling som støtter automatisert oppdatering gjennom Power Bi-tjeneste.

Neste trinn

TripPin Del 10 – Spørringsdelegering