Создание первого соединителя: Hello World

В этом примере представлено простое расширение источника данных, которое можно запустить в Visual Studio Code и загрузить в Power BI Desktop.

Пример Hello World

В этом примере показано следующее:

• Функция экспорта (HelloWorld.Contents), которая принимает параметр текста параметра.
• Определение типа источника данных:
  • Объявляет, что он использует неявную (анонимную) проверку подлинности.
  • Использует строковые ресурсы, которые позволяют локализации.
  • Объявление метаданных пользовательского интерфейса, чтобы расширение отображалось в диалоговом окне получения данных Power BI Desktop.

Следуя инструкциям по установке пакета SDK PowerQuery, создайте новый соединитель с именем HelloWorld, скопируйте следующий код M и вставьте его в файл HelloWorld.pq рабочей области соединителя, а затем следуйте остальным инструкциям, чтобы открыть его в Power BI.

В следующем определении соединителя вы найдете следующее:

• Оператор section .
• Функция источника данных с метаданными, устанавливающими ее в качестве определения источника данных с типом HelloWorld и публикацией HelloWorld.Publish.
• Запись, объявляющая, что неявное Authentication (анонимное) является единственным типом проверки подлинности для этого источника.
• Запись публикации, объявляющая, что это подключение находится в бета-версии, какой текст загружается из resx-файла, исходного образа и исходного образа типа.
• Запись, связывающая размеры значков с определенными PNG в папке сборки.

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") }
];

После создания файла и его копирования в правильный каталог, следуя инструкциям в руководстве по установке пакета SDK PowerQuery, откройте Power BI. Вы можете найти соединитель в диалоговом окне "Получить данные ".

На этом шаге откроется диалоговое окно проверки подлинности. Так как параметры проверки подлинности отсутствуют, а функция не принимает параметров, дальнейшие действия в этих диалогах отсутствуют.

Нажмите Подключение и диалоговое окно сообщает, что это соединитель предварительного просмотра, так как Beta задано значение true в запросе. Так как проверка подлинности отсутствует, на экране проверки подлинности отображается вкладка для анонимной проверки подлинности без полей. Нажмите Подключение еще раз, чтобы завершить работу.

Наконец, редактор запросов отображает то, что вы ожидаете, — функция, которая возвращает текст Hello world.

Полный пример см. в примере hello World в репозитории data Подключение ors.