Criando seu primeiro conector: Olá, Mundo

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 de Olá, Mundo

Como 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 ele usa autenticação implícita (anônima).
  • Usa recursos de cadeia de caracteres que permitem a localização.
  • Declarando metadados de interface para que a extensão possa aparecer na caixa de diálogo Obter Dados do Power BI Desktop.

Seguindo as instruções sobre como instalar o SDK do PowerQuery, crie um novo conector chamado "HelloWorld", copie o código M a seguir e cole-o no arquivo HelloWorld.pq do workspace 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 instrução.
• Uma função de fonte de dados com metadados que a estabelece como uma definição de fonte de dados com o Tipo HelloWorld e Publicar 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 esta conexão está em Beta, qual texto carregar do arquivo resx, a imagem de origem e a imagem do tipo de origem.
• Um registro associando tamanhos de ícone com 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, seguindo as instruções no tutorial Instalar o SDK do PowerQuery , abra o Power BI. Você pode procurar por "hello" para localizar seu conector na caixa de diálogo Obter Dados.

Esta etapa apresenta 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 nesses diálogos.

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

Por fim, 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 exemplo Hello World no repositório de exemplo dos Conectores de Dados.