Conecte Power BI a la API REST

Actualizado

Nota: Este artículo es técnico, por lo que recomendamos involucrar a alguien con la experiencia técnica adecuada. Si tiene alguna pregunta, póngase en contacto con nosotros en support@azumuta.com.

Power BI puede cargar datos de Azumuta a través de la REST API. Puede crear una consulta usted mismo, o empezar desde una plantilla de ejemplo que ya incluye varias consultas.

Si su espacio de trabajo utiliza la base de datos de informes, Power BI también puede conectarse a ella directamente con el conector PostgreSQL. Vea Conectarse a la base de datos de informes.

Antes de comenzar

  1. Cree un dispositivo API y copie su clave API. Vea Crear y gestionar claves API.
  2. Encuentre el endpoint que desea leer en la documentación de la API dentro de la aplicación. En la app de Azumuta, haga clic en el signo de interrogación en la parte superior derecha de la pantalla y luego en API docs.

Las claves API están limitadas por entorno, así que utilice la URL del mismo entorno de Azumuta al que pertenece la clave.

Crear una consulta en Power BI

  1. Abra un nuevo proyecto en Power BI.
  2. Haga clic en Obtener datos → Consulta en blanco.
  3. Abra el Editor avanzado y pegue el siguiente código:
let
  Source =
    Json.Document(
      Web.Contents(
        "https://YOUR_AZUMUTA_URL",
        [
          RelativePath = "api/YOUR_ENDPOINT",
          Headers = [
            #"x-api-key" = "YOUR_API_KEY",
            #"Accept" = "application/json"
          ]
        ]
      )
    )
in
  Source
  1. Reemplace los marcadores:
    • YOUR_AZUMUTA_URL: la URL de su entorno de Azumuta.
    • YOUR_ENDPOINT: la ruta del endpoint, por ejemplo v2/products.
    • YOUR_API_KEY: la clave API que copió.
  2. Cuando Power BI solicite credenciales, elija Anónimo y establezca el nivel de privacidad en Organizacional. Power BI no necesita sus propias credenciales aquí, porque Azumuta lee la clave API desde la cabecera de la petición.
  3. Convierta el resultado en una tabla. Haga clic en el valor Lista, luego haga clic en A tabla.
  4. Haga clic en el icono de expansión (⤢) y seleccione las columnas que necesite.
  5. Si necesita datos de varios endpoints, repita estos pasos para crear una consulta por cada uno.
  6. Cree tablas y visualizaciones con los datos.

Importante: La clave API se almacena en la consulta. Cualquier persona que pueda abrir el archivo de Power BI, o editar el informe publicado, puede leerla. Trate el archivo como una credencial y no lo comparta fuera de su empresa.

Empezar desde la plantilla de ejemplo

Azumuta ofrece una plantilla de Power BI de ejemplo que carga datos a través de la REST API y gestiona resultados paginados. Para obtenerla, contacte con support@azumuta.com.

  1. Cree un dispositivo API y copie su clave API. Vea Crear y gestionar claves API.
  2. Abra la plantilla en Power BI.
  3. Abra el Editor de Power Query y seleccione cada uno de los dos parámetros. Actualice el valor actual del parámetro de la clave API y establezca UrlEnvironment en la URL de su propio entorno.
  4. Elimine las consultas que no necesite. Cada consulta añade tiempo de carga, así que conservar solo lo que use acelera la actualización.
  5. Haga clic en Cerrar y aplicar para cargar sus datos.
  6. Cree relaciones entre las tablas y construya su panel con los visuales de Power BI.

Artículos relacionados

En esta página