Compartir a través de

Registro de cambios de la API de objetos visuales de Power BI

  • Artículo

Esta página contiene un breve resumen de las versiones de API existentes y qué esperar en la próxima versión. Las versiones que se enumeran aquí se consideran estables y no cambian.

API v5.10.0

  • DataViewMetadataColumn tiene una nueva propiedad denominada sourceFieldParameters. Esta propiedad indica si el campo actual es el resultado de un parámetro de campo. Si un único campo se puede originar a partir de varios parámetros de campo, esta propiedad enumera todos los parámetros de campo relacionados.
  • Admite Desktop (junio de 2024)

API v5.9.1

  • acquireAADTokenService: se ha mejorado para admitir las siguientes nubes.
    • Nube comercial
    • Nube de China
    • Nube de comunidad del gobierno de EE. UU.
    • Government Community Cloud High (EE. UU.)
    • Nube del Departamento de Defensa de EE. UU.

API v5.9.0

  • API de filtro de identidad jerárquica: permite crear un objeto visual que use la asignación de DataView de matriz para filtrar los datos en función de los puntos de datos que usan una estructura jerárquica. Esto resulta útil para los objetos visuales personalizados que aprovechan los modelos semánticos de claves de grupo y quieren filtrar jerarquías basadas en puntos de datos.
  • acquireAADTokenService: extendido con propiedades adicionales
  • Admite Desktop (marzo de 2024)

API v5.8.0

  • API de almacenamiento local: una nueva versión de la API de almacenamiento local disponible para todos los objetos visuales personalizados y controlados por una configuración global que está activada de forma predeterminada. El administrador puede desactivar la configuración global para deshabilitar la API heredada y la nueva versión de la API.
  • Compatibilidad con objetos para objetos visuales personalizados: compatibilidad con objetos para objetos visuales personalizados para optimizar la experiencia del usuario y proporcionar una experiencia de creación unificada a la par con los objetos visuales de fábrica.
  • Admite Desktop de febrero de 2024

API v5.7.0

  • API de autenticación de objetos visuales personalizados de Power BI: Permite a los objetos visuales personalizados obtener tokens de acceso de Microsoft Entra mediante el inicio de sesión único (SSO), lo que facilita operaciones contextuales de usuario seguras y eficaces.
  • Control de obtención de detalles dinámicos: permite que el objeto visual habilite o deshabilite la característica de obtención de detalles dinámicamente mediante una llamada API.
    • Cuando la característica de obtención de detalles está habilitada, todas las funcionalidades de las características de obtención de detalles y de expansión o contracción están disponibles. Estas funcionalidades incluyen llamadas API, comandos de menú contextual, botones de obtención de detalles de encabezado y compatibilidad con datos de jerarquía.
    • Cuando la característica de obtención de detalles está deshabilitada, estas funcionalidades no están disponibles.
  • Admite Desktop (diciembre de 2023)

API v5.4.0

API v5.3.0

  • Corrección de actualización de SelectionId para la matrizdataView.

    Nota:

    Los datos principales de selectionId pueden cambiar. Por lo tanto, es posible que un ID de selección o un índice de identidad persistentes que usen una versión anterior de la API no sean relevantes en las imágenes de la matriz.

  • downloadService: agrega un nuevo método exportVisualsContentExtended que devuelve información de resultados expandida de la descarga.
  • Admite Desktop (marzo de 2023)

API v5.2.0

API v5.1.0

  • Ordenación personalizada: se ha mejorado la ordenación personalizada para las tablas.
  • Subtotales: nuevo tipo de subtotales indica si los totales se deben recuperar antes o después del resto de los datos.
  • Filtro de identidad: filtrar datos categóricos
  • Nuevo panel de formato: diseñe un objeto visual personalizado que admita el nuevo diseño del panel de formato
  • Admite Desktop de octubre de 2022

API v4.7.0

  • API de licencias: venda, administre y aplique licencias directamente desde el marketplace comercial.
  • API de obtención de detalles: cree un objeto visual que pueda desencadenar una operación de obtención de detalles por sí misma, sin interacción del usuario.
  • Admite Desktop de julio de 2022

API v4.6.0

API v4.2.0

API v3.8.0

  • Admite Desktop RS de mayo de 2021 y versiones posteriores.

API v3.7.0

  • Admite Desktop de abril de 2021 y versiones posteriores.

API v3.6.0

  • El objeto visual puede permite recibir actualizaciones desde Power BI sin necesidad de enlazar ningún dato.
  • Admite Desktop de febrero de 2021 y versiones posteriores.
  • Admite Desktop RS de mayo de 2021 y versiones posteriores.

API v3.4.0

  • fetchMoreData: nuevo parámetro de aggregateSegments (valor predeterminado: "true"), para admitir fetchMoreData sin agregación
  • Admite Desktop de noviembre de 2020 y versiones posteriores.
  • Admite Desktop RS de enero de 2021 y versiones posteriores.

API v3.2.0

  • Admite supportsMultiVisualSelection
  • Admite Desktop de septiembre de 2019 y versiones posteriores.
  • Admite Desktop RS de enero de 2020 y versiones posteriores.

API v2.6.0

  • Agrega isInFocus a la opción de actualización y el método switchFocusModeState al host del objeto visual.
  • Admite la personalización de subtotales.
  • Admite Desktop de junio de 2019 y versiones posteriores.
  • Admite Desktop RS de mayo de 2019 y versiones posteriores.

API v2.5.0

  • Admite el panel Análisis .
  • Admite los métodos SelectionIdBuilderwithMatrixNode y withTable.
  • Ya no admite la interfaz DataRepetitionSelector, se ha reemplazado por la interfaz data.CustomVisualOpaqueIdentity.

API v2.3.0

API v2.2.0

API v2.1.0

  • Mejoras de rendimiento:
    • Tiempos de carga más rápidos
    • Menor superficie de memoria
    • Optimización de transacciones de eventos y datos

Notas de la versión

  • Las API de filtrado refactorizadas estarán disponibles en la API 2.2 y no se admiten en la API 2.1.

  • Los objetos visuales solo recibirán el tipo dataView que se declaró en sus capacidades. Los objetos visuales que usan varios tipos de vistas de datos se romperán como resultado de esta actualización.

  • Ya no admite la interfaz DataViewScopeIdentity, se ha reemplazado por la interfaz data.DataRepetitionSelector. Si ha usado la propiedad clave de la interfaz DataViewScopeIdentity, puede reemplazarla por JSON.stringify(identity).

  • undefined se reemplaza por null dentro de dataView. Al recorrer en iteración una matriz mediante var item in myArray, se omite en undefined, pero no en null. Es posible que esta actualización interrumpa los objetos visuales que usan este patrón. Asegúrese de buscar null en las matrices:

    for (var item in myArray) {
   if (!item) {
     continue;
   }
   console.log(item);
}

  • La propiedad proto ya no almacena metadatos o datos ocultos dentro de dataView. Esta actualización puede invalidar los objetos visuales que tienen acceso a las propiedades a través de proto.

API v1.13.0

API v1.12.0

API v1.11.0

API v1.10.0

  • Agrega ILocalizationManager.
  • API de Autenticación

API v1.9.0

API v1.8.0

  • Admite el nuevo tipo fillRule (gradiente) en el esquema de capacidades.
  • Admite la propiedad rule en el esquema de capacidades de las propiedades de objeto.

API v1.7.0

API v1.6.2

API v1.5.0

API v1.4.0

API v1.3.0

API v1.2.0

  • Agrega colorPalette para administrar los colores utilizados en el objeto visual.
  • Admite selección múltiple: selectionManager puede aceptar una matriz de SelectionId.
  • Admite objetos visuales de R mediante scripts de R.

API v1.1.0

  • Admite objetos visuales de depuración en iFrame.
  • Agrega un espacio aislado ligero con una inicialización más rápida del iFrame
  • Soluciona el problema de que Capabilities.objects no admite el tipo "text".
  • Admite pbiviz update para actualizar las definiciones de tipo y el esquema de la API de objetos visuales.
  • Admite --api-version marca en pbiviz new para crear objetos visuales con una versión de API específica
  • Admite la versión alpha de la API v1.2.0.

Host de objetos visuales

  • Agrega createSelectionIdBuilder para crear identificadores únicos que se usan para la selección de datos.
  • Agrega createSelectionManager para administrar el estado de selección del objeto visual y comunica los cambios al host de objetos visuales.
  • Agrega una matriz de colores predeterminados para usar en los objetos visuales.

API v1.0.0

  • Versión inicial de la API