TripPin parte 9 - Test Connessione ion

Questa esercitazione in più parti illustra la creazione di una nuova estensione dell'origine dati per Power Query. L'esercitazione è destinata a essere eseguita in sequenza: ogni lezione si basa sul connettore creato nelle lezioni precedenti, aggiungendo in modo incrementale nuove funzionalità al connettore.

In questa lezione:

• Aggiungere un gestore test Connessione ion
• Configurare il gateway dati locale (modalità personale)
• Testare l'aggiornamento pianificato tramite il servizio Power BI

Il supporto del connettore personalizzato è stato aggiunto alla versione di aprile 2018 del gateway dati locale personale. Questa nuova funzionalità (anteprima) consente l'aggiornamento pianificato dei report che usano il connettore personalizzato.

Questa esercitazione illustra il processo di abilitazione del connettore per l'aggiornamento e fornisce una procedura dettagliata rapida per configurare il gateway. In particolare, si:

1. Aggiungere un gestore test Connessione ion al connettore.
2. Installare il gateway dati locale in modalità personale.
3. Abilitare il supporto di Connessione or personalizzato nel gateway.
4. Pubblicare una cartella di lavoro che usa il connettore per PowerBI.com.
5. Configurare l'aggiornamento pianificato per testare il connettore.

Per altre informazioni sul gestore test Connessione ion, vedere Gestione del supporto del gateway.

Background

Esistono tre prerequisiti per la configurazione di un'origine dati per l'aggiornamento pianificato tramite PowerBI.com:

• L'origine dati è supportata: ciò significa che l'ambiente del gateway di destinazione riconosce tutte le funzioni contenute nella query che si vuole aggiornare.
• Vengono fornite le credenziali: per presentare la finestra di dialogo di immissione delle credenziali corretta, Power BI deve conoscere il meccanismo di autenticazione di supporto per una determinata origine dati.
• Le credenziali sono valide: dopo che l'utente fornisce le credenziali, vengono convalidate chiamando il gestore dell'origine TestConnection dati.

I primi due elementi vengono gestiti registrando il connettore con il gateway. Quando l'utente tenta di configurare l'aggiornamento pianificato in PowerBI.com, le informazioni sulla query vengono inviate al gateway personale per determinare se sono disponibili origini dati non riconosciute dal servizio Power BI (ovvero quelle personalizzate create). Il terzo elemento viene gestito richiamando il gestore Test Connessione ion definito per l'origine dati.

Aggiunta di un gestore test Connessione ion

Il gestore Test Connessione ion viene aggiunto al record di dichiarazione Tipo origine dati (la stessa posizione in cui si dichiarano i tipi di autenticazione supportati). Il gestore è un function oggetto con un singolo parametro di tipo any, che restituisce un oggetto list. Il primo valore nell'elenco è la funzione che verrà chiamata per testare effettivamente la connessione. Si tratta in genere della funzione principale dell'origine dati. In alcuni casi potrebbe essere necessario esporre una funzione separata shared per fornire un test di connessione efficiente, tuttavia questo dovrebbe essere generalmente evitato.

Poiché la funzione origine dati TripPin non ha argomenti obbligatori, l'implementazione per Test Connessione ion è piuttosto semplice:

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

Nota

È possibile convalidare l'implementazione di Test Connessione ion all'interno di Power Query SDK usando il comando per la funzione Esegui test Connessione ion.

Abilitazione di connettori personalizzati nel gateway personale

Scaricare e installare il gateway dati locale. Quando si esegue il programma di installazione, selezionare la modalità personale.

Al termine dell'installazione, avviare il gateway e accedere a Power BI. Il processo di accesso registrerà automaticamente il gateway con le servizio Power BI. Dopo l'accesso, seguire questa procedura:

1. Selezionare la scheda Connettori.
2. Selezionare l'opzione per abilitare il supporto per i connettori dati personalizzati.
3. Selezionare la directory da cui caricare connettori personalizzati. In genere si tratta della stessa directory usata per Power BI Desktop, ma il valore è configurabile.
4. La pagina dovrebbe ora elencare tutti i file di estensione nella directory di destinazione.

Per altre informazioni sul gateway, vedere la documentazione online.

Test dell'aggiornamento pianificato

Aprire Power BI Desktop e creare un report che importa i dati usando il connettore TripPin.

Aggiungere uno o più oggetti visivi alla pagina del report (facoltativo) e quindi pubblicare il report in PowerBI.com.

Dopo la pubblicazione, passare a PowerBI.com e trovare il modello semantico per il report pubblicato. Selezionare i puntini di sospensione e quindi selezionare Pianifica aggiornamento. Espandere le sezioni Connessione gateway e Credenziali origine dati.

Nota

Se la pagina di configurazione del modello semantico indica che il report contiene origini dati sconosciute, il gateway o il connettore personalizzato potrebbe non essere configurato correttamente. Passare all'interfaccia utente di configurazione del gateway personale e assicurarsi che non siano presenti errori accanto al connettore TripPin. Potrebbe essere necessario riavviare il gateway (nella scheda Service Impostazioni) per selezionare la configurazione più recente.

Selezionare il collegamento Modifica credenziali per visualizzare la finestra di dialogo di autenticazione e quindi selezionare Accedi.

Nota

Se viene visualizzato un errore simile a quello riportato di seguito ("Non è stato possibile aggiornare le credenziali dell'origine dati"), è probabile che si verifichi un problema con il gestore Test Connessione ion.

Dopo una chiamata riuscita a Test Connessione ion, le credenziali verranno accettate. È ora possibile pianificare l'aggiornamento oppure selezionare l'ellisse del modello semantico e quindi selezionare Aggiorna ora. È possibile selezionare il collegamento Cronologia aggiornamenti per visualizzare lo stato dell'aggiornamento (che in genere richiede alcuni minuti per iniziare).

Conclusione

Complimenti. È ora disponibile un connettore personalizzato pronto per la produzione che supporta l'aggiornamento automatico tramite il servizio Power BI.

Passaggi successivi

TripPin - Parte 10 - Riduzione delle query