Criar o seu primeiro conector: Hello World

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

Exemplo Hello World

Como visão geral, este exemplo mostra:

• Função de exportação (HelloWorld.Contents), que aceita um parâmetro de texto de opção.
• Definindo um tipo de fonte de dados que:
  • Declara que utiliza autenticação implícita (anónima).
  • Utiliza recursos de strings que permitem localização.
  • Declarar metadados da interface para que a extensão possa aparecer no diálogo Obter Dados do Power BI Desktop.

Seguindo as instruções em Instalar o PowerQuery SDK, crie um novo conector chamado "HelloWorld", copie o código M seguinte e cole-o no ficheiro HelloWorld.pq do seu espaço de trabalho do conector, e depois siga o resto das instruções para o poder abrir no Power BI.

Na definição de conector seguinte, encontrará:

• Uma section declaração.
• Uma função 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 registo que declara que implícito (anónimo) é o único tipo de autenticação para esta fonte.
• Um registo de publicação que declara que esta ligação está em Beta, o texto a carregar do ficheiro resx, a imagem de origem e a imagem do tipo de origem.
• Um registo que associa tamanhos de ícones a PNGs específicos na pasta de build.

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 construir o ficheiro e o copiar para a pasta correta, seguindo as instruções do tutorial de Instalação do SDK PowerQuery , abra o Power BI. Pode pesquisar por "olá" para encontrar o seu conector no diálogo Obter Dados.

Este passo abre um diálogo de autenticação. Como não há opções de autenticação e a função não aceita parâmetros, não há mais passos nestes diálogos.

Pressione Connect e a caixa de diálogo informa que é um "Conector de Pré-visualização", dado que Beta está definido como `true` na consulta. Como não há autenticação, o ecrã de autenticação apresenta um separador para autenticação Anónima sem campos. Pressiona no botão Ligar novamente para terminar.

Finalmente, aparece o editor de consultas que mostra o que esperas—uma função que devolve o texto "Hello world".

Para a amostra totalmente implementada, veja o Hello World Sample no repositório de exemplos Data Connectors.