TripPin, parte 9: TestConnection

En este tutorial de varias partes se describe la creación de una nueva extensión de origen de datos para Power Query. El tutorial está diseñado para realizarse secuencialmente: cada lección se basa en el conector creado en las lecciones anteriores, agregando incrementalmente nuevas funcionalidades al conector.

En esta lección:

El soporte de conectores personalizados se agregó al lanzamiento de abril de 2018 del gateway de datos local personal. Esta nueva funcionalidad (versión preliminar) permite la actualización programada de informes que usan el conector personalizado.

En este tutorial se describe el proceso de habilitación del conector para la actualización y se proporciona un tutorial rápido de los pasos para configurar la puerta de enlace. En concreto, usted:

1. Agregue un controlador TestConnection al conector.
2. Instale la Puerta de Enlace de Datos local en Modo Personal.
3. Habilite la compatibilidad del conector personalizado en la puerta de enlace.
4. Publique un libro de trabajo que use su conector en PowerBI.com.
5. Configure la actualización programada para probar el conector.

Vaya a Manejo del soporte de puerta de enlace para obtener más información sobre el controlador TestConnection.

Contexto

Hay tres requisitos previos para configurar un origen de datos para la actualización programada mediante PowerBI.com:

• Se admite el origen de datos: El entorno de gateway de destino tiene conocimiento de todas las funciones contenidas en la consulta que desea refrescar.
• Se proporcionan credenciales: Para presentar el cuadro de diálogo de entrada de credenciales correcto, Power BI debe conocer el mecanismo de autenticación de compatibilidad para un origen de datos determinado.
• Las credenciales son válidas: Después de que el usuario proporcione las credenciales, se validan llamando al controlador del origen de TestConnection datos.

Los dos primeros elementos se controlan registrando el conector en la puerta de enlace. Cuando el usuario intenta configurar la actualización programada en PowerBI.com, la información de la consulta se envía a su puerta de enlace personal para determinar si hay fuentes de datos en el servicio Power BI que no se reconozcan, es decir, las personalizadas que usted haya creado, y están disponibles allí. El tercer elemento se controla invocando el controlador TestConnection definido para el origen de datos.

Adición de un controlador TestConnection

El controlador TestConnection se agrega al registro de declaración Tipo de origen de datos (el mismo lugar en el que se declaran sus tipos de autenticación admitidos). El controlador es un function con un único parámetro de tipo any, que devuelve un list. El primer valor de la lista es la función a la que se llama para probar realmente la conexión. Esta función suele ser la misma que la función principal del origen de datos. En algunos casos, es posible que tenga que exponer una función independiente shared para proporcionar una prueba de conexión eficaz; sin embargo, esto suele evitarse.

Dado que la función de origen de datos TripPin no tiene argumentos necesarios, la implementación de TestConnection es bastante sencilla:

// Data Source Kind description
TripPin = [
    // TestConnection is required to enable the connector through the Gateway
    TestConnection = (dataSourcePath) => { "TripPin.Contents" },
    Authentication = [
        Anonymous = []
    ],
    Label = "TripPin Part 9 - TestConnection"
];

Habilitación de conectores personalizados en la puerta de enlace personal

Descargue e instale la puerta de enlace de datos local. Al ejecutar el instalador, seleccione el modo personal.

Una vez completada la instalación, inicie la puerta de enlace e inicie sesión en Power BI. El proceso de inicio de sesión registra automáticamente la puerta de enlace con los servicios de Power BI. Una vez que haya iniciado sesión, realice los pasos siguientes:

1. Seleccione la pestaña Conectores .

2. Seleccione el interruptor para habilitar la compatibilidad con conectores de datos personalizados.

3. Seleccione el directorio desde el que desea cargar conectores personalizados. Esta selección suele ser el mismo directorio que se usa para Power BI Desktop, pero el valor es configurable.

4. La página debería mostrar ahora todos los archivos de extensión en el directorio de destino.

   

Vaya a la documentación online para obtener más información sobre el gateway.

Prueba de la actualización programada

Abra Power BI Desktop y cree un informe que importe datos mediante el conector TripPin.

Agregue uno o varios objetos visuales a la página del informe (opcional) y, a continuación, publique el informe en PowerBI.com.

Después de publicar, vaya a PowerBI.com y busque el modelo semántico del informe que publicó. Seleccione el icono de tres puntos y, a continuación, seleccione Programar actualización. Expanda las secciones de Conexión de puerta de enlace y de Credenciales de origen de datos.

Seleccione el vínculo Editar credenciales para abrir el cuadro de diálogo de autenticación y, a continuación, seleccione Iniciar sesión.

Después de una llamada correcta a TestConnection, se aceptan las credenciales. Ahora puede programar la actualización o seleccionar la elipse del modelo semántico y, a continuación, seleccionar Actualizar ahora. Puede seleccionar el vínculo Historial de actualizaciones para ver el estado de la actualización (que normalmente tarda unos minutos en iniciarse).

Conclusión

¡Felicidades! Ahora tiene un conector personalizado listo para producción que admite la actualización automatizada a través del servicio Power BI.

Pasos siguientes

TripPin, parte 10: plegado de consultas