Criando seu primeiro conector: Hello World

  • Artigo

Este exemplo fornece uma extensão de fonte de dados simples que pode ser executada no Visual Studio Code e carregada no Power BI Desktop.

Exemplo Hello World

Como uma visão geral, este exemplo mostra:

  • Função de exportação (HelloWorld.Contents), que usa um parâmetro de texto de opção.
  • Definindo um tipo de fonte de dados que:
    • Declara que usa autenticação implícita (anônima).
    • Usa recursos de cadeia de caracteres que permitem a localização.
    • Declarar metadados da interface do usuário para que a extensão possa aparecer na caixa de diálogo Obter Dados do Power BI Desktop.

Seguindo as instruções em Instalando o SDK do PowerQuery, crie um novo conector chamado "HelloWorld", copie o seguinte código M e cole-o no arquivo HelloWorld.pq do espaço de trabalho do conector e siga o restante das instruções para poder abri-lo no Power BI.

Na seguinte definição de conector você encontra:

  • Uma section declaração.
  • Uma função de fonte de dados com metadados que a estabelecem como uma definição de fonte de dados com o Kind HelloWorld and Publish HelloWorld.Publish.
  • Um Authentication registro declarando que implícito (anônimo) é o único tipo de autenticação para essa fonte.
  • Um registro de publicação declarando que essa conexão está em Beta, qual texto carregar do arquivo resx, a imagem de origem e a imagem de tipo de fonte.
  • Um registro associando tamanhos de ícones a PNGs específicos na pasta de compilação.
section HelloWorld;
 
[DataSource.Kind="HelloWorld", Publish="HelloWorld.Publish"]
shared HelloWorld.Contents = (optional message as text) =>
    let
        message = if (message <> null) then message else "Hello world"
    in
        message;
 
HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];
 
HelloWorld.Publish = [
    Beta = true,
    ButtonText = { Extension.LoadString("FormulaTitle"), Extension.LoadString("FormulaHelp") },
    SourceImage = HelloWorld.Icons,
    SourceTypeImage = HelloWorld.Icons
];
 
HelloWorld.Icons = [
    Icon16 = { Extension.Contents("HelloWorld16.png"), Extension.Contents("HelloWorld20.png"), Extension.Contents("HelloWorld24.png"), Extension.Contents("HelloWorld32.png") },
    Icon32 = { Extension.Contents("HelloWorld32.png"), Extension.Contents("HelloWorld40.png"), Extension.Contents("HelloWorld48.png"), Extension.Contents("HelloWorld64.png") }
];

Depois de criar o arquivo e copiá-lo para o diretório correto, siga as instruções no tutorial Instalando o SDK do PowerQuery, abra o Power BI. Você pode procurar por "olá" para encontrar seu conector na caixa de diálogo Obter dados .

Esta etapa exibe uma caixa de diálogo de autenticação. Como não há opções de autenticação e a função não usa parâmetros, não há mais etapas nessas caixas de diálogo.

Pressione Connect e a caixa de diálogo informa que é um "Conector de visualização", já Beta que está definido como true na consulta. Como não há autenticação, a tela de autenticação apresenta uma guia para Autenticação anônima sem campos. Pressione Connect novamente para concluir.

Finalmente, o editor de consultas aparece mostrando o que você espera — uma função que retorna o texto "Olá mundo".

Para obter o exemplo totalmente implementado, consulte o Hello World Sample no repositório de exemplo Data Connectors.