Compartir a través de

Creación del primer conector: Hola, mundo

  • Artículo

En este ejemplo se proporciona una extensión de origen de datos sencilla que se puede ejecutar en Visual Studio Code y que se carga en Power BI Desktop.

Ejemplo Hola, mundo

Como información general, este ejemplo muestra lo siguiente:

  • Función de exportación (HelloWorld.Contents), que toma un parámetro de texto de opción.
  • Definición de un tipo de origen de datos que:
    • Declara que usa la autenticación implícita (anónima).
    • Usa recursos de cadena que permiten la localización.
    • Declarar metadatos de la interfaz de usuario para que la extensión pueda aparecer en el cuadro de diálogo Obtener datos de Power BI Desktop.

Siguiendo las instrucciones de Instalación del SDK de PowerQuery, cree un nuevo conector denominado "HelloWorld", cópielo en el código M siguiente y péguelo en el archivo HelloWorld.pq del área de trabajo del conector y, a continuación, siga el resto de las instrucciones para poder abrirlo en Power BI.

En la siguiente definición del conector encontrará:

  • Una instrucción section.
  • Una función de origen de datos con metadatos que lo establecen como definición de origen de datos con la Variante HelloWorld y Publicación HelloWorld.Publish.
  • Un registro Authentication que declara que implícito (anónimo) es el único tipo de autenticación para este origen.
  • Un registro de publicación que declara que esta conexión está en Beta, qué texto se va a cargar desde el archivo resx, la imagen de origen y la imagen de tipo de origen.
  • Un registro que asocia tamaños de icono con archivos PNG específicos en la carpeta de compilación.
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") }
];

Una vez que haya compilado el archivo y lo haya copiado en el directorio correcto, siga las instrucciones del tutorial Instalación del SDK de PowerQuery y abra Power BI. Puede buscar "hello" para buscar el conector en el cuadro de diálogo Obtener datos.

Este paso abre un cuadro de diálogo de autenticación. Dado que no hay ninguna opción de autenticación y la función no toma ningún parámetro, no hay ningún paso adicional en estos cuadros de diálogo.

Pulse Conectar y el cuadro de diálogo le indicará que es un "Conector de versión preliminar", ya que Beta está establecido en true en la consulta. Puesto que no hay autenticación, la pantalla de autenticación presenta una pestaña para la Autenticación anónima sin campos. Pulse Conectar de nuevo para finalizar.

Por último, el editor de consultas muestra lo que espera: una función que devuelve el texto "Hola, mundo".

Para obtener el ejemplo totalmente implementado, consulte Ejemplo de Hola mundo en el repositorio de ejemplo Conectores de datos.