Compartir a través de

Control del acceso a datos

Funciones de origen de datos

Un conector de datos ajusta y personaliza el comportamiento de una función de origen de datos en la biblioteca M. Por ejemplo, una extensión para una API REST haría uso de la función Web.Contents para realizar solicitudes HTTP. Actualmente, se ha habilitado un conjunto limitado de funciones de origen de datos para admitir la extensibilidad.

Example:

[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;

Tipo de origen de datos

Las funciones marcadas como shared en la extensión se pueden asociar a un origen de datos específico mediante la inclusión de un DataSource.Kind atributo literal en la función con el nombre de un registro de definición de origen de datos. El registro de origen de datos define los tipos de autenticación admitidos por el origen de datos y la información básica de personalización de marca (como el nombre para mostrar o la etiqueta). El nombre del registro se convierte en su identificador único.

Cada función asociada al mismo origen de datos debe tener los mismos parámetros de función necesarios, incluidos el nombre, el tipo y el orden. (Para fines del tipo de origen de datos, no se considera necesario un parámetro si está marcado optional o si sus metadatos contienen DataSource.Path = false).

Las funciones de un tipo de origen de datos específico solo pueden usar credenciales asociadas a ese tipo. Las credenciales se identifican en tiempo de ejecución mediante la realización de una búsqueda basada en la combinación de los parámetros necesarios de la función. Para obtener más información sobre cómo se identifican las credenciales, consulte Rutas de acceso del origen de datos.

Example:

HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];

Propiedades

En la tabla siguiente se enumeran los campos del registro de definición del origen de datos.

Campo Tipo Detalles
Autenticación registro Especifica uno o varios tipos de autenticación admitidos por el origen de datos. Se requiere al menos un tipo. Cada tipo se mostrará como una opción en el cuadro de diálogo de credenciales de Power Query. Para obtener más información, consulte Tipos de autenticación.
Etiqueta texto (opcional) Nombre descriptivo para mostrar para esta extensión en cuadros de diálogo de credenciales.
SoportaCifrado lógico (opcional) Cuando sea true, la interfaz de usuario presentará la opción de conectarse al origen de datos mediante una conexión cifrada. Normalmente se utiliza para orígenes de datos con un mecanismo de recurrencia no cifrado (generalmente, orígenes basados en ODBC o ADO.NET).

Publicar en la interfaz de usuario

De forma similar al registro de definición del origen de datos , el registro Publish proporciona a la interfaz de usuario de Power Query la información que necesita para exponer esta extensión en el cuadro de diálogo Obtener datos .

Example:

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

Propiedades

En la tabla siguiente se enumeran los campos del registro Publicar.

Campo Tipo Detalles
ButtonText list Lista de elementos de texto. El primer elemento define el nombre que se muestra junto al icono del origen de datos en el cuadro de diálogo Obtener datos de Power BI. El segundo elemento (opcional) define la información sobre herramientas que se mostrará cuando se pase el puntero del ratón por el nombre anterior.
Categoría texto Donde se debe mostrar la extensión en el cuadro de diálogo Obtener datos . Actualmente, los únicos valores de categoría con tratamiento especial son Azure y Database. Todos los demás valores terminarán en la categoría Otros.
Beta lógico (opcional) Cuando se establece en true, la interfaz de usuario mostrará un identificador de versión preliminar o beta junto al nombre del conector y un cuadro de diálogo de advertencia que la implementación del conector está sujeta a cambios importantes.
LearnMoreUrl texto (opcional) Dirección URL al sitio web que contiene más información sobre este origen de datos o conector.
SupportsDirectQuery lógico (opcional) Habilita Direct Query para la extensión.
SourceImage registro (opcional) Un registro que contiene una lista de imágenes binarias (procedentes del archivo de extensión mediante el método Extension.Contents ). El registro contiene dos campos (Icon16, Icon32), cada uno con su propia lista. Cada icono debe tener un tamaño diferente.
SourceTypeImage registro (opcional) Similar a SourceImage, excepto que la convención de muchos conectores predefinidos es mostrar un icono de hoja con el icono específico de origen en la esquina inferior derecha. Tener un conjunto diferente de iconos para SourceTypeImage es opcional: muchas extensiones simplemente reutilizan el mismo conjunto de iconos para ambos campos.
  • Last updated on