드릴다운 API

드릴다운 API를 사용하면 사용자 상호 작용 없이 자체적으로 드릴다운 작업을 트리거할 수 있는 시각적 개체를 만들 수 있습니다.

API는 시각적 개체가 다음 수준을 표시하거나, 다음 수준으로 확장하거나, API에 전달된 매개 변수에 따라 드릴업하도록 지원합니다. 드릴다운에 대한 자세한 내용은 드릴다운 지원을 참조하세요.

드릴다운 API를 사용하는 방법

참고 항목

드릴다운 API는 API 버전 4.7.0에서 사용할 수 있습니다. 사용 중인 버전을 확인하려면 pbiviz.json 파일에서 apiVersion을 확인합니다.

capabilities.json 파일에 다음을 추가합니다.

    "drilldown": {
        "roles": ["Rows", "Columns"]
    }

예: 드릴다운 API

다음 예제에서는 시각적 개체가 드릴다운 작업을 호출하는 방법을 보여줍니다.

public update(options: VisualUpdateOptions) {
        if ((options.dataViews[0].metadata.dataRoles.drillableRoles['Columns']).indexOf(powerbi.DrillType.Down) >= 0) {
            let args: powerbi.DrillDownArgs = {
                roleName: "Columns",
                drillType: powerbi.DrillType.Down
            };
            this.host.drill(args);
        }