Total 및 Subtotal API 사용하면 행렬 데이터 뷰를 사용하는 사용자 지정 시각적 개체가 Power BI 호스트에서 집계된 부분합 데이터를 요청할 수 있습니다. 부분합은 전체 행렬 의미 체계 모델에 대해 계산되거나 행렬 데이터 계층 구조의 개별 수준에 대해 지정됩니다. Power BI 시각적 개체의 Total 및 Subtotal API 예제는 샘플 보고서 참조하세요.
메모
부분합 데이터 요청은 버전 2.6.0 이상에서 지원됩니다.
rowSubtotalType 속성은 버전 5.1.0 이상에서 사용할 수 있습니다. 사용 중인 버전을 확인하려면 pbiviz.json 파일에서 apiVersion 확인합니다.
시각적 개체가 데이터를 새로 고칠 때마다 시각적 개체는 Power BI 백 엔드에
부분합 API
API는 각 데이터 뷰 형식에 대해 다음과 같은 사용자 지정을 제공합니다(현재 행렬 데이터 뷰만).
-
rowSubtotals: (부울) 행 필드의 모든 필드에 대해 부분합 데이터를 요청해야 하는지 여부를 나타냅니다. -
rowSubtotalsPerLevel: (불리언) 행 필드의 각 개별 필드에 대해 부분합 데이터를 개별적으로 전환할 수 있는지를 나타냅니다. -
columnSubtotals: (부울) 열 필드의 모든 필드에 대해 부분합 데이터를 요청해야 하는지 여부를 나타냅니다. -
columnSubtotalsPerLevel: (부울) 열 필드의 개별 필드에 대해 부분합 데이터를 전환할 수 있는지 여부를 나타냅니다. -
levelSubtotalEnabled: (불린) 행이나 열에 대한 부분합이 요청되었는지 여부를 나타냅니다. 다른 모든 속성과 달리 이 속성은 개별 행 또는 열에 적용됩니다. -
rowSubtotalsType: ("위쪽" 또는 "아래쪽") 총 데이터가 있는 행을 데이터의 나머지 부분 이전(top) 또는 이후(bottom)로 검색해야 하는지 여부를 나타냅니다. 이 속성이bottom설정되면 모든 데이터를 가져온 후에만 합계를 표시할 수 있습니다. 기본값은bottom.
이러한 각 스위치에는 속성 창의 관련 속성 및 기본값에 따라 값이 할당됩니다.
부분합 API를 사용하는 방법
시각적인 capabilities.json 파일은 다음을 수행해야 합니다.
- 각 스위치가에 매핑되는 속성을 명시하십시오.
- 속성이 정의되지 않은 경우 사용할 기본값을 제공합니다.
스위치는 다음 예제와 같은 형식을 사용합니다.
"rowSubtotals": {
"propertyIdentifier": {
"objectName": "subTotals",
"propertyName": "rowSubtotals"
},
"defaultValue": true
},
앞의 코드는 행 부분합이 subTotals 개체의 속성 rowSubtotals 사용하도록 설정되어 있음을 나타냅니다. 속성의 기본값은 true.
부분합 구조와 모든 스위치 매핑이 capabilities.json 파일에 정의되면, API는 시각적 요소에 대해 자동으로 활성화됩니다.
다음 코드는 capabilities.json 파일의 전체 API 구성의 예입니다(API 샘플 시각적 개체에서 복사됨).
"subtotals": {
"matrix": {
"rowSubtotals": {
"propertyIdentifier": {
"objectName": "subTotals",
"propertyName": "rowSubtotals"
},
"defaultValue": true
},
"rowSubtotalsPerLevel": {
"propertyIdentifier": {
"objectName": "subTotals",
"propertyName": "perRowLevel"
},
"defaultValue": false
},
"columnSubtotals": {
"propertyIdentifier": {
"objectName": "subTotals",
"propertyName": "columnSubtotals"
},
"defaultValue": true
},
"columnSubtotalsPerLevel": {
"propertyIdentifier": {
"objectName": "subTotals",
"propertyName": "perColumnLevel"
},
"defaultValue": false
},
"levelSubtotalEnabled": {
"propertyIdentifier": {
"objectName": "subTotals",
"propertyName": "levelSubtotalEnabled"
},
"defaultValue": true
},
"rowSubtotalsType": {
"propertyIdentifier": {
"objectName": "subtotals",
"propertyName": "rowSubtotalsType"
},
"defaultValue": "Bottom"
}
}
}
시각적 개체의 enumerateProperties() 함수가 capabilities.json 파일에 지정된 기본값과 일치해야 합니다. 사용자 지정 논리는 지정된 기본값에 따라 작동합니다.
enumerateProperties() 함수와 기본값이 정렬되지 않은 경우 실제 부분합 사용자 지정은 사용자의 예상과 다를 수 있습니다.
enum RowSubtotalType {
Top = "Top",
Bottom = "Bottom",
}
사용 가능한 사용자 지정을 보려면 서식 속성 창에서 부분합 드롭다운 메뉴를 열어보세요. 부분합 설정을 수정하고 시각화 패널에서 부분합 표시(요약)의 변경 사항을 추적합니다.
고려 사항 및 제한 사항
rowSubtotalsType속성은 행에만 사용할 수 있습니다. 열 부분합을 열의 시작 부분으로 설정할 수 없습니다.확장 및 축소 기능이
rowSubtotals를 재정의합니다. 부분합은 행이 확장될 때 표시되며,rowSubtotals가 false로 설정된 경우에도 마찬가지입니다.