시각적 개체에 경고 아이콘 표시 추가
Power BI 시각적 개체에서 경고 아이콘 표시는 사용자에게 가능한 문제 또는 오류를 알릴 수 있습니다. 경고 아이콘 표시는 다음과 같은 많은 경우에 유용할 수 있습니다.
지도 시각적 개체는 값이 위도 또는 경도 유효 범위를 벗어나는 경우 경고 아이콘을 표시할 수 있습니다.
원형 차트 시각적 개체는 양수 값과 혼합된 음수 값을 표시할 때 경고 아이콘을 표시할 수 있습니다.
무한대 값이 계산되면 카티전 차트에서 경고 아이콘을 표시할 수 있습니다. 예를 들어 Y가 0이면 X를 Y로 나눌 때 결과는 무한대입니다.
아이콘이 표시되면 마우스로 가리켜 경고 메시지의 제목을 볼 수 있습니다.
사용자가 경고 아이콘을 선택하면 문제를 설명하는 메시지가 팝업 창에 나타납니다.
경고 아이콘 만들기
사용자 지정 시각적 개체에 사용자 지정 메시지가 있는 경고 아이콘을 만들 수 있습니다. 경고 아이콘을 발생시킬지를 결정할 수 있습니다. 이러한 예제에서 알 수 있듯이 경고 아이콘이 표시되면 시각적 개체가 계속 작동합니다.
업데이트 메서드에 호출 추가
시각적 개체에 경고 아이콘 표시를 추가하려면 displayWarningIcon 메서드를 호출합니다. 메서드는 IVisualHost의 일부이며 powerbi-visuals-api를 사용하여 노출됩니다.
파일에 다음 가져오기를 추가합니다.
import powerbiVisualsApi from "powerbi-visuals-api";
가져오기를 추가한 후 경고 아이콘을 표시할 시기를 결정하는 조건을 추가합니다. 이 문서의 예제를 사용하여 두 가지 선택 조건을 볼 수 있습니다.
예제 1: 언어 호환성 검사
지역화는 운영 체제의 설정에 따라 결정되는 고객의 네이티브 언어로 시각적 개체를 표시하는 데 사용됩니다.
이 예제에서 시각적 개체는 미국 영어로 설정된 시각적 개체의 언어를 운영 체제의 언어와 비교합니다. 언어가 일치하지 않으면 경고 아이콘이 표시됩니다.
if (this.locale != 'en-US') {
this.host.displayWarningIcon('Language inconsistency', 'This visual supports only US English. For the visual to work as expected, set your browser's language to US English.');
}
예 2: 인접 열의 색 비교
이 예제에서는 서로 인접한 두 열이 동일한 색을 갖는 경우 경고 아이콘 표시가 나타납니다.
getColumnColorByIndex 메서드는 모든 열을 반복합니다. 인접한 두 열의 색이 같으면 경고 아이콘이 표시됩니다.
let category = options.dataViews[0].categorical.categories[0];
let dataValue = options.dataViews[0].categorical.values[0];
let colorPalette = this.host.colorPalette;
for (let i = 0, len = Math.max(category.values.length, dataValue.values.length); i < len-1; i++) {
const color1: string = getColumnColorByIndex(category, i, colorPalette);
const color2: string = getColumnColorByIndex(category, i+1, colorPalette);
if (color1 == color2) {
this.host.displayWarningIcon('Adjacent columns have the same color.', 'Columns that are next to each other have the same color. To change a column's color, use the data colors option in the Format tab.');
}
}
고려 사항 및 제한 사항
일부 오류 및 경고는 시각적 개체로 인해 발생하지 않습니다. 예를 들어 값이 너무 많습니다. 모든 데이터를 표시하지 않음 오류는 Power BI 서비스에서 파생되지 않습니다. 이러한 오류 및 경고는 시각적 개체의 호출 전에 전파됩니다. 시각적 개체의 코드에서 발생하는 오류보다 우선합니다. 데이터를 로드하는 동안 오류가 발생하는 경우 시각적 개체의 코드가 실행되고 경고 아이콘 표시 조건이 충족되기 전에 경고 아이콘 표시 오류 대신 이 오류가 표시됩니다.
시각적 개체를 렌더링하는 동안(예: 새 데이터를 시각적 개체로 끌어올 때) 경고 표시가 지워집니다. 시각적 개체의
update()메서드는 시각적 개체를 렌더링한 후에 호출됩니다. 업데이트 메서드에서 확인된 조건에 따라 시각적 개체의 경고가 발생하는 경우 시각적 개체를 렌더링할 때마다 조건이 충족되면 경고가 다시 표시됩니다.시각적 개체의 크기를 조정해도 경고 아이콘에는 영향을 주지 않습니다.
아이콘 표시 텍스트에는 다음과 같은 제한 사항이 있습니다.
제목의 최대 길이는 70자입니다.
텍스트의 최대 길이는 2,000자입니다.
텍스트는 일반 텍스트로만 표시됩니다.