데이터 필드 구성

시각화를 만들면 할당된 데이터 필드에 따라 시각적 개체가 렌더링됩니다. 이 문서에서는 Power BI 보고서 작성 API를 사용하여 데이터 필드와 상호 작용하고 데이터 역할에 할당하는 방법을 보여 줍니다. 시각적 개체에 어떤 데이터 역할이 있는지 확인하려면 getCapabilities 메서드를 사용합니다.

데이터 필드 추가

시각적 데이터 역할에 데이터 필드를 추가하려면 시각적 개체의 addDataField 메서드를 호출합니다.

addDataField(dataRole: string, dataField: models.IBaseTarget, index?: number): Promise<models.IError>

이 메서드에는 다음과 같은 변수가 있습니다.

• dataRole - 데이터 필드를 할당해야 하는 데이터 역할의 이름입니다. dataRole 매개 변수는 데이터 역할 name 속성과 동일합니다. 사용 가능한 데이터 역할 및 이름을 검색하려면 getCapabilities 메서드를 사용합니다.
• dataField - 데이터 역할에 추가할 데이터 필드입니다. 데이터 필드는 집계가 있는 열, 집계, 측정값, 계층 구조 또는 계층 구조가 있는 열일 수 있는 대상 개체입니다. 대상에 대한 자세한 내용은 대상을 사용하여수행할 데이터 필드를 선택합니다.
• index(선택 사항) - 데이터 필드를 추가할 인덱스입니다. 기본 동작은 필드를 마지막으로 추가하는 것입니다.

예를 들어:

const dataField = {
  $schema: "http://powerbi.com/product/schema#column",
  table: "Store",
  column: "Name"
};

await visual.addDataField('Category', dataField);

데이터 필드 가져오기

데이터 역할에 정의된 데이터 필드 목록을 얻으려면 시각적 개체의 getDataFields 메서드를 호출합니다.

getDataFields(dataRole: string): Promise<models.IBaseTarget>

이 메서드에는 데이터 필드를 검색할 데이터 역할의 이름인 dataRole 변수가 있습니다.

예를 들어:

let dataField = await visual.getDataFields('Category');

데이터 필드 제거

데이터 역할에 적용되는 데이터 필드를 제거하려면 시각적 개체의 removeDataField 메서드를 호출합니다.

removeDataField(dataRole: string, index: number): Promise<models.IError>

이 메서드에는 다음과 같은 매개 변수가 있습니다.

• dataRole - 데이터 필드가 연결된 대상 데이터 역할의 이름입니다.
• index - 삭제할 데이터 필드의 인덱스입니다.

예를 들어:

await visual.removeDataField('Category', 2);

데이터 필드의 인덱스 가져오기 위해 getDataFields 결과 배열에서 대상의 인덱스로 가져올 수 있습니다.

관련 콘텐츠

• 보고서 시각적 개체 포함
• 시각적 개체 만들기
• 시각적 개체의 기능 가져오기