TripPin parte 9 - TestConnection

Este tutorial em várias partes aborda a criação de uma nova extensão de fonte de dados para o Power Query. O tutorial destina-se a ser feito sequencialmente — cada lição baseia-se no conector criado nas aulas anteriores, adicionando gradualmente novas capacidades ao seu conector.

Nesta lição, vocês:

O suporte a conectores personalizados foi adicionado na versão de abril de 2018 do gateway de dados pessoal local. Esta nova funcionalidade (pré-visualização) permite a Atualização Programada de relatórios que utilizam o seu conector personalizado.

Este tutorial aborda o processo de ativação do seu conector para atualização e fornece uma rápida explicação dos passos para configurar o gateway. Especificamente tu:

1. Adiciona um handler TestConnection ao teu conector.
2. Instale o Data Gateway local em modo Pessoal.
3. Ative o suporte ao Conector Personalizado no Gateway.
4. Publica um livro de exercícios que use o teu conector para PowerBI.com.
5. Configura a atualização programada para testar o teu conector.

Vá a Suporte ao Handling gateway para mais informações sobre o handler TestConnection.

Contexto geral

Existem três pré-requisitos para configurar uma fonte de dados para atualização programada usando PowerBI.com:

• A fonte de dados é suportada: O ambiente gateway de destino está ciente de todas as funções contidas na consulta que pretende atualizar.
• As credenciais são fornecidas: Para apresentar o diálogo correto de introdução de credenciais, o Power BI precisa de conhecer o mecanismo de autenticação de suporte para uma dada fonte de dados.
• As credenciais são válidas: Depois de o utilizador fornecer as credenciais, estas são validadas ao chamar o gestor da TestConnection fonte de dados.

Os dois primeiros itens são tratados ao registar o seu conector no gateway. Quando o utilizador tenta configurar a atualização programada no PowerBI.com, a informação da consulta é enviada para o seu gateway pessoal para determinar se alguma fonte de dados no serviço Power BI não está reconhecida (ou seja, as personalizadas que criou) estão disponíveis lá. O terceiro item é tratado invocando o handler TestConnection definido para a sua fonte de dados.

Adição de um manipulador TestConnection

O "handler" TestConnection é adicionado ao registo de declaração do tipo de fonte de dados, no mesmo local onde são declarados os tipos de autenticação suportados. O manipulador é um function com um único parâmetro do tipo any, que devolve um list. O primeiro valor na lista é a função que é chamada para realmente testar a ligação. Esta função é geralmente igual à função principal da sua fonte de dados. Em alguns casos, poderá ser necessário expor uma função separada shared para garantir um teste de ligação eficiente, no entanto, isso deve ser geralmente evitado.

Como a função fonte de dados TripPin não tem argumentos obrigatórios, a implementação do TestConnection é bastante simples:

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

Ativação de conectores personalizados no gateway pessoal

Descarregue e instale o gateway de dados local. Quando executares o instalador, seleciona o modo pessoal.

Depois de concluída a instalação, inicie o gateway e inicie sessão no Power BI. O processo de início de sessão regista automaticamente o seu gateway nos serviços Power BI. Depois de iniciar sessão, execute os seguintes passos:

1. Selecione o separador de Conectores.

2. Selecione o switch para ativar o suporte a conectores de dados personalizados.

3. Seleciona o diretório de onde queres carregar conectores personalizados. Esta seleção é normalmente o mesmo diretório que usas para o Power BI Desktop, mas o valor é configurável.

4. A página deve agora listar todos os ficheiros de extensão no seu diretório de destino.

   

Consulte a documentação online para mais informações sobre o gateway.

Testar a atualização programada

Abra o Power BI Desktop e crie um relatório que importe dados usando o conector TripPin.

Adicione um ou mais elementos visuais à sua página de relatório (opcional) e depois publique o relatório na PowerBI.com.

Depois de publicar, vá a PowerBI.com e encontre o modelo semântico para o relatório que publicou. Selecione as reticências e em seguida selecione Agendar Atualização. Expanda as secções de ligação ao Gateway e credenciais da fonte de dados .

Selecione o link Editar credenciais para abrir o diálogo de autenticação e depois selecione iniciar sessão.

Após uma chamada bem-sucedida para a TestConnection, as credenciais são aceites. Agora pode agendar a atualização, ou selecionar a elipse do modelo semântico e depois selecionar Atualizar Agora. Podes selecionar o link Histórico de Atualização para ver o estado da atualização (que normalmente demora alguns minutos a ser iniciada).

Conclusion

Parabéns! Agora tem um conector personalizado pronto para produção que suporta atualização automática através do serviço Power BI.

Próximos passos

TripPin Parte 10 - Dobragem de Consultas