Saltar a contenido

Power BI

Puedes llevar los datos de BotCity Insights a Power BI usando la API de BotCity Insights. Así, los datos de tareas, automatizaciones y Runners reportados a Insights quedan disponibles en los informes y dashboards que ya creas en Power BI.

En esta página, verás cómo:

Ejemplos introductorios

Los ejemplos de esta página cubren un flujo básico de integración con Power BI. Para conocer todas las rutas, parámetros y respuestas disponibles, consulta la referencia de la API de BotCity Insights.

Autenticarse en la API

El primer paso para usar la API de BotCity Insights es la autenticación. La API usa un token de acceso, enviado en el header de todas las solicitudes.

Para obtener el token de acceso desde Power BI:

  1. Abre Power BI Desktop y crea un nuevo informe.
  2. En el menú Obtener datos, selecciona la opción Consulta en blanco.
  3. Abre la consulta creada en el Editor avanzado para ingresar el código en Power Query M.

Animación en Power BI Desktop que muestra la creación de un nuevo informe desde la pantalla inicial, la selección de la opción Consulta en blanco en el menú Obtener datos y la apertura de la consulta en el Editor avanzado.

El código de este paso hace una solicitud POST a la ruta de login de la API, enviando los valores de login y key en el cuerpo de la solicitud.

Dónde encontrar login y key

Los valores de login y key están en la página Entorno de Desarrollo de tu workspace en el Orquestador BotCity.

() =>
    let
        // Login route
        url = "https://su-empresa.botcity.dev/api/v2/workspace/login",
        headers = [#"Content-Type" = "application/json"],

        // Passing the workspace information in the body of the request (Dev. Environment)
        postdata = Json.FromValue(
            [
                login = "<WORKSPACE_LOGIN>",
                key = "<WORKSPACE_KEY>"
            ]
        ),
        // Getting the response
        response = Web.Contents(url, [Headers = headers, Content = postdata]),
        Data = Json.Document(response),

        access_token = Data[accessToken]
    in 
        // Returning the obtained access token
        access_token

Reemplaza la URL de la ruta de login

La URL https://su-empresa.botcity.dev en el código es solo un ejemplo. Reemplázala por la URL del servidor dedicado de tu empresa, la misma que usas para acceder al Orquestador, manteniendo la ruta /api/v2/workspace/login.

Si usas la versión Comunidad, la URL base es https://developers.botcity.dev.

Al ejecutar esta consulta, la API devuelve un token de acceso.

Editor de Power Query en Power BI con las consultas Login e Invoked Function en el panel lateral. La barra de fórmulas muestra = Login() y, debajo, el token de acceso devuelto por la API aparece resaltado en rojo.

Con la función que devuelve el token de acceso, puedes usarlo como parámetro en las demás solicitudes para consumir los datos de los informes.

Consumir los datos de los informes

Usa los endpoints a continuación para consumir los datos de los informes de BotCity Insights:

BASE URL
https://su-empresa.botcity.dev

Reemplaza la URL base

La URL https://su-empresa.botcity.dev es solo un ejemplo. Reemplázala por la URL del servidor dedicado de tu empresa, la misma que usas para acceder al Orquestador.

Si usas la versión Comunidad, la URL base es https://developers.botcity.dev.

Tipo Ruta Descripción
GET /api/v1/insights/tasks Lista los datos de las tareas ejecutadas
GET /api/v1/insights/runners Lista los datos de los Runners del workspace
GET /api/v1/insights/automation Lista los datos de las automatizaciones

En el mismo informe, sigue los pasos a continuación para consumir los datos de la API de BotCity Insights:

  1. En el menú Nueva fuente, selecciona la fuente Web para crear una nueva consulta.

  2. En la ventana que se abre, marca la opción Avanzado e ingresa la URL base de la API de BotCity Insights.

    Animación en el editor de Power Query que muestra la creación de una nueva fuente de tipo Web desde el menú Nueva fuente y la selección de la opción Avanzado en la ventana de configuración.

  3. En el segundo campo de las partes de la URL, ingresa la ruta que deseas usar para consumir los datos.

  4. En el campo Parámetros de encabezado de la solicitud HTTP, ingresa el token obtenido en el paso de autenticación y la organization de tu workspace. Todas las solicitudes de la API de BotCity Insights requieren estos dos valores en el header.

    Al final, la configuración debe quedar similar a esta:

    Ventana From Web de Power BI en la opción Advanced, con las partes de la URL https://developers.botcity.dev y /api/v1/insights/tasks, la vista previa de la URL completa y los parámetros de encabezado token, con el valor <ACCESS_TOKEN>, y organization, con el valor <ORGANIZATION_LABEL>.

Valor de organization

El valor de organization es el mismo del campo login, disponible en la página Entorno de Desarrollo de tu workspace en el Orquestador.

Al ejecutar la solicitud, la respuesta de la API aparece en la ventana de configuración de la fuente de datos. A partir de ella, puedes aplicar los tratamientos necesarios para mostrar los datos como desees.

Editor de Power Query que muestra la consulta tasks con los datos devueltos por la API de BotCity Insights en formato de tabla, con columnas como content.id, content.state, content.finishStatus, content.activityLabel, content.repositoryLabel, content.machineId y fechas de modificación y creación. En el panel Query Settings aparecen los pasos aplicados a la consulta.

Usar la API de forma avanzada

Hacer dinámicas las solicitudes de Power BI

Al crear la consulta en el formato anterior, Power BI genera automáticamente un código en Power Query M con los datos que completaste.

En el ejemplo anterior, el token de acceso se pasó manualmente. Con un pequeño cambio, puedes hacer dinámico el paso de autenticación.

Para ello, edita la consulta en el Editor avanzado y usa la función creada para obtener el token.

Token generado en cada actualización

La función que obtiene el token de acceso, creada en el paso de autenticación, se puede pasar como parámetro en las próximas solicitudes.

De esta forma, se genera un nuevo token cada vez que se actualiza la consulta.

Editor avanzado de Power BI con el código Power Query M de la consulta tasks. El fragmento token = Login(), subrayado en rojo, muestra el parámetro token del encabezado completado por la función Login en lugar de un valor fijo.