다음을 통해 공유

Power BI 시각적 개체 API 변경 로그

  • 아티클

이 페이지에는 기존 API 버전에 대한 간략한 요약과 예정된 버전에서 기대할 수 있는 사항이 포함되어 있습니다. 여기에 나열된 버전은 안정적인 것으로 간주되며 변경되지 않습니다.

API v5.10.0

  • DataViewMetadataColumn에는 sourceFieldParameters라는 새로운 속성이 있습니다. 이 속성은 현재 필드가 필드 매개 변수의 결과인지를 나타냅니다. 하나의 필드가 여러 필드 매개 변수에서 비롯될 수 있는 경우, 이 속성은 관련된 모든 필드 매개 변수를 나열합니다.
  • 2024년 6월 데스크톱 지원

API v5.9.1

  • acquireAADTokenService: 다음 클라우드를 지원하도록 향상되었습니다.
    • 상용 클라우드
    • 중국 클라우드
    • 미국 정부 커뮤니티 클라우드
    • 미국 정부 커뮤니티 클라우드 High
    • 미국 국방부 클라우드

API v5.9.0

  • 계층 구조 ID 필터 API: 이 API를 통해, 계층 구조를 사용하는 데이터 포인트를 기반으로 데이터를 필터링하는 데 행렬 DataView 매핑을 사용하는 시각적 개체를 만들 수 있습니다. 이는 그룹 온 키(group-on key)가 있는 의미 체계 모델을 활용하고 데이터 포인트를 기반으로 계층을 필터링하려는 사용자 지정 시각적 개체에 유용합니다.
  • acquireAADTokenService: 추가 속성으로 확장됨
  • 2024년 3월 데스크톱 지원

API v5.8.0

  • 로컬 스토리지 API: 모든 사용자 지정 시각적 개체에 사용할 수 있고 기본적으로 켜짐 상태의 전역 설정으로 제어되는 새로운 버전의 로컬 스토리지 API입니다. 관리자는 전역 설정을 꺼서 레거시 API와 새 버전의 API를 모두 사용하지 않도록 설정할 수 있습니다.
  • 사용자 지정 시각적 개체에 대한 개체별 지원: 사용자 환경을 최적화하고 기본 제공 가능한 시각적 개체와 동등한 통합 제작 환경을 제공하기 위한 사용자 지정 시각적 개체에 대한 개체별 지원입니다.
  • 2024년 2월 데스크톱 지원

API v5.7.0

  • Power BI 사용자 지정 시각적 개체 인증 API: 사용자 지정 시각적 개체가 SSO(Single Sign-On)를 통해 Microsoft Entra 액세스 토큰을 가져올 수 있어 안전하고 효율적인 사용자 컨텍스트 작업이 가능해집니다.
  • 동적 드릴 제어: 시각적 개체가 API 호출을 사용하여 드릴 기능을 동적으로 사용하거나 사용하지 않도록 설정할 수 있습니다.
    • 드릴 기능이 사용하도록 설정되면 드릴다운 및 확장/축소 기능의 모든 기능을 사용할 수 있습니다. 이러한 기능에는 API 호출, 바로 가기 메뉴 명령, 헤더 드릴 단추 및 계층 구조 데이터 지원이 포함됩니다.
    • 드릴 기능이 사용하지 않도록 설정되면 이러한 기능을 사용할 수 없습니다.
  • 2023년 12월 데스크톱 지원

API v5.4.0

  • 향상된 키보드 탐색: 키보드를 사용하여 시각적 개체와 상호 작용하기 위한 더 많은 옵션을 제공하여 시각적 개체의 접근성과 유용성을 개선합니다.
  • 보고서에서 필터 사용 검색 : 보고서에 적용된 필터가 있는지 검색합니다.
  • 2023년 4월 데스크톱 지원

API v5.3.0

  • 행렬 dataView에 대한 SelectionId의 업데이트 수정.

    참고 항목

    selectionId의 핵심 데이터가 변경될 수 있습니다. 따라서 이전 API 버전을 사용하는 지속형 selectionId/identityIndex는 행렬 시각적 개체와 관련이 없을 수 있습니다.

  • downloadService: 다운로드의 확장된 결과 정보를 반환하는 새 메서드 exportVisualsContentExtended를 추가합니다.
  • 2023년 3월 데스크톱 지원

API v5.2.0

API v5.1.0

  • 사용자 지정 정렬 - 테이블에 대한 사용자 지정 정렬 개선
  • 부분합 - 새 부분합 형식은 나머지 데이터 앞이나 후에 합계를 검색해야 하는지 여부를 나타냅니다.
  • ID 필터 - 범주 데이터 필터링
  • 새 서식 창 - 새 서식 창 디자인을 지원하는 사용자 지정 시각적 개체 디자인
  • 2022년 10월 데스크톱 지원

API v4.7.0

  • 라이선싱 API - 상업용 Marketplace를 통해 직접 라이선스를 판매, 관리, 적용합니다.
  • 드릴다운 API - 사용자 상호 작용 없이 자체적으로 드릴다운 작업을 트리거할 수 있는 시각적 개체를 만듭니다.
  • 2022년 7월 데스크톱 지원

API v4.6.0

  • 새 기능 속성: 권한 및 두 가지 권한:
    • 웹 액세스
    • 사용자 지정 시각적 개체에서 파일 다운로드
  • 두 개의 해당 테넌트 관리자 스위치 추가
  • 파일에 시각적 개체를 다운로드할 수 있도록 하는 다운로드 API
  • 2022년 6월 데스크톱 지원

API v4.2.0

API v3.8.0

  • Desktop 2021년 5월 이후 버전을 지원합니다.

API v3.7.0

  • Desktop 2021년 4월 이후 버전을 지원합니다.

API v3.6.0

  • 시각적 개체는 데이터를 바인딩할 필요 없이 Power BI에서 업데이트를 받을 수 있습니다.
  • Desktop 2021 2월 이상 버전을 지원합니다.
  • Desktop RS 2021년 5월 이후 버전을 지원합니다.

API v3.4.0

  • fetchMoreData: 새로운 aggregateSegments 매개 변수(기본값: true), 집계 없음 fetchMoreData 지원
  • Desktop 2020 11월 이상 버전을 지원합니다.
  • Desktop RS 2021년 1월 이후 버전을 지원합니다.

API v3.2.0

  • supportsMultiVisualSelection 지원
  • Desktop 2019 9월 이상 버전을 지원합니다.
  • Desktop RS 2020년 1월 이후 버전을 지원합니다.

API v2.6.0

  • 업데이트 옵션에 isInFocus를 추가하고 시각적 개체에 switchFocusModeState 메서드를 추가
  • 부분합 사용자 지정을 지원
  • Desktop 2019 6월 이상 버전을 지원합니다.
  • Desktop RS 2019년 5월 이후 버전을 지원합니다.

API v2.5.0

  • 분석 창을 지원
  • SelectionIdBuilder withMatrixNode 및 withTable 메서드를 지원
  • DataRepetitionSelector 인터페이스를 더 이상 지원하지 않고 data.CustomVisualOpaqueIdentity 인터페이스로 대체

API v2.3.0

API v2.2.0

API v2.1.0

  • 성능 향상:
    • 로드 시간 단축
    • 메모리 사용 공간 축소
    • 데이터 및 이벤트 트랜잭션 최적화

릴리스 정보

  • 리팩터링된 필터링 API는 API 2.2에서 사용할 수 있으며 API 2.1에서는 지원되지 않습니다.

  • 시각적 개체는 해당 기능에 선언된 dataView 형식만 받습니다. 여러 dataView 형식을 사용하는 시각적 개체는 이 업데이트의 결과로 중단됩니다.

  • DataViewScopeIdentity 인터페이스는 더 이상 지원하지 않고 data.DataRepetitionSelector 인터페이스로 대체했습니다. DataViewScopeIdentity 인터페이스의 키 속성을 사용한 경우 JSON.stringify(identity)로 바꿀 수 있습니다.

  • undefined는 dataView 내에서 null로 바뀝니다. var item in myArray를 사용하여 배열을 반복하는 경우 undefined에서 건너뛰지만 null에서는 건너뛰지 않습니다. 이 패턴을 사용하는 시각적 개체는 이 업데이트로 인해 중단될 수 있습니다. 배열에서 null 여부를 확인해야 합니다.

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

  • proto 속성이 dataView 내부에서 숨겨진 metadata\data를 더 이상 저장하지 않습니다. proto를 통해 속성에 액세스하는 시각적 개체는 이 업데이트로 인해 중단될 수 있습니다.

API v1.13.0

API v1.12.0

API v1.11.0

API v1.10.0

  • ILocalizationManager를 추가
  • 인증 API

API v1.9.0

API v1.8.0

  • 기능 스키마에서 새 형식 fillRule(그라데이션)을 지원
  • 개체 속성용 기능 스키마에서 규칙 속성을 지원

API v1.7.0

API v1.6.2

API v1.5.0

API v1.4.0

API v1.3.0

API v1.2.0

  • 시각적 개체에 사용되는 색을 관리하기 위해 colorPalette를 추가합니다.
  • 다중 선택을 지원 - selectionManager는 SelectionId의 배열을 허용할 수 있습니다.
  • R 스크립트를 사용하여 R 시각적 개체를 지원합니다.

API v1.1.0

  • iFrame에서 시각적 개체 디버그를 지원
  • 더 빠른 iFrame 초기화를 사용하는 경량 샌드박스를 추가
  • Capabilities.objects가 "text" 형식을 지원하지 않음 문제를 수정
  • 시각적 API 형식 정의 및 스키마를 업데이트하는 pbiviz update를 지원
  • 특정 API 버전으로 시각적 개체를 만들기 위해 pbiviz new에서 --api-version 플래그를 지원
  • API v1.2.0의 알파 릴리스를 지원

시각적 개체 호스트

  • 데이터 선택에 사용되는 고유 식별자를 만드는 createSelectionIdBuilder를 추가
  • 시각적 개체의 선택 상태를 관리하고 변경 내용을 시각적 개체 호스트에 전달하는 createSelectionManager를 추가
  • 시각적 개체에서 사용할 기본 색 배열을 추가

API v1.0.0

  • 초기 API 릴리스