시각적 개체 만들기

이 API는 보고서 페이지에서 새 시각적 개체를 만드는 방법을 제공합니다.

시각적 개체를 만들고 데이터에 바인딩하는 방법

특정 형식의 빈 시각적 개체를 만든 다음, 시각적 개체를 데이터 필드에 바인딩합니다. 시각적 개체 형식 목록은기본 시각적 개체 형식을 참조하세요.

메모

시각화 창에 설치되지 않은 시각적 개체는 보고서에 추가할 수 없습니다. 이는 설치되지 않은 사용자 지정 시각적 개체와 제거된 기본 제공 시각적 개체 모두에 해당합니다.

1. 다음 매개 변수를 사용하여 만들려는 시각적 개체를 구성합니다.

   • 시각적 개체 유형: 만들려는 시각적 개체의 형식(예: barChart)입니다.
   • 레이아웃(선택적): 새 시각적 개체에 적용할 레이아웃입니다.
   • 자동 초점 (선택 사항): 페이지가 자동으로 새로 만든 시각적 개체로 스크롤되는지 여부를 선택합니다(기본적으로 'True'로 설정).

2. 다음 메서드를 사용하여 시각적 개체를 만듭니다.

   createVisual(visualType: string, layout?: models.IVisualLayout, autoFocus?: boolean): Promise<models.ICreateVisualResponse>
   

반환된 값에는 새로 만든 시각적 개체를 나타내는 개체가 포함됩니다. 시각적 데이터 바인딩 사용하고 API를 시각적 속성을 필요에 따라 시각적 개체를 편집할 수 있습니다.

예를 들어:

let createVisualResponse = await page.createVisual('areaChart');
let visual = createVisualResponse.visual;

코드 예제

다음 코드 예제에서는 다른 매개 변수를 사용하여 시각적 개체를 만드는 방법을 보여 줍니다.

메모

사용자 지정 레이아웃을 만드는 방법에 대한 자세한 내용은 시각적 레이아웃참조하세요.

포커스가 없는 사용자 지정 레이아웃으로 영역형 차트 시각적 개체를 만듭니다.

const customLayout = {
    x: 20,
    y: 35,
    width: 1600,
    height: 1200
}

let createVisualResponse = await page.createVisual('areaChart', customLayout, false /* autoFocus */);

기본 레이아웃으로 영역형 차트를 만듭니다.

let createVisualResponse = await page.createVisual('areaChart');

사용 가능한 기본 시각적 개체 형식

• actionButton

• areaChart

• barChart

• basicShape

• 카드

• clusteredBarChart

• clusteredColumnChart

• columnChart

• debugVisual

• 분해 트리

• donutChart

• esriVisual

• filledMap

• 깔때기

• 계기

• hundredPercentStackedBarChart

• hundredPercentStackedColumnChart

• 이미지

• keyDriversVisual

• kpi

• lineChart

• lineClusteredColumnComboChart

• lineStackedColumnComboChart

• 지도

• multiRowCard

• pieChart

• 피벗 테이블

• PowerApps

• pythonVisual

• qnaVisual

• ribbonChart

• scatterChart

• scriptVisual

• shapeMap

• 슬라이서

• stackedAreaChart

• tableEx

• 텍스트 상자

• treemap

• waterfallChart

고려 사항 및 제한 사항

시각적 개체 만들기 API는 보고서가 렌더링된 후에만 사용할 수 있습니다. 보고서 rendered 이벤트를 수신 대기하고 호출된 후에만 시각적 작성 API를 트리거합니다. 자세한 내용은 이벤트 처리 참조하세요.

관련 콘텐츠

• 시각적 형식 변경
• 데이터 필드 구성
• 서식 시각적 속성