인증된 Power BI 시각적 개체

아티클
02/18/2024

인증된 Power BI 시각적 개체는 Microsoft Power BI 팀 코드 요구 사항 및 테스트를 충족하는 AppSource 의 Power BI 시각적 개체입니다. 수행된 테스트는 시각적 개체가 외부 서비스 또는 리소스에 액세스하지 않는지 검사 위해 설계되었습니다. 그러나 Microsoft는 타사 사용자 지정 시각적 개체의 작성자가 아니며, 이러한 시각적 개체의 기능을 확인하기 위해 작성자에게 직접 문의하는 것이 좋습니다.

인증된 Power BI 시각적 개체는 다른 Power BI 시각적 개체와 마찬가지로 사용할 수 있습니다. 인증되지 않은 시각적 개체보다 더 많은 기능을 제공합니다. 예를 들어 PowerPoint로 내보내거나 사용자가 보고서 페이지를 구독할 때 받은 이메일에 시각적 개체를 표시할 수 있습니다.

인증 프로세스는 선택 사항입니다. 개발자는 시각적 개체 인증을 받을지 여부를 결정해야 합니다. 인증되지 않은 Power BI 시각적 개체가 반드시 안전하지는 않습니다. 일부 Power BI 시각적 개체는 인증 요구 사항 중 하나 이상을 준수하지 않았기 때문에 인증되지 않았습니다. 예를 들어 외부 서비스에 연결하는 맵 Power BI 시각적 개체 또는 상용 라이브러리를 사용하는 Power BI 시각적 개체는 인증할 수 없습니다.

인증 제거

Microsoft는 재량에 따라 인증된 목록에서 시각적 개체를 제거할 권리를 보유합니다.

인증 요구 사항

Power BI 시각적 개체를 인증받으려면 이 섹션에 나열된 요구 사항을 준수해야 합니다.

일반 요구 사항

Power BI 시각적 개체는 파트너 센터에서 승인되어야 합니다. 인증을 요청하기 전에 AppSource에 Power BI 시각적 개체를 게시하는 것이 좋습니다. Power BI 시각적 개체를 AppSource에 게시하는 방법을 알아보려면 파트너 센터에 Power BI 시각적 개체 게시를 참조하세요.

인증을 위해 Power BI 시각적 개체를 제출하기 전에 다음을 확인합니다.

시각적 개체가 Power BI 시각적 개체에 대한 지침을 준수합니다.
시각적 개체가 모든 필수 테스트를 통과했습니다.
컴파일된 패키지가 제출된 패키지와 정확히 일치합니다.

코드 리포지토리 요구 사항

GitHub에서 공개적으로 코드를 공유할 필요는 없지만 Power BI 팀이 코드 리포지토리를 검토할 수 있어야 합니다. 이렇게 하는 가장 좋은 방법은 GitHub에서 소스 코드(JavaScript 또는 TypeScript)를 제공하는 것입니다.

리포지토리에는 다음이 포함되어야 합니다.

Power BI 시각적 개체 단 하나의 코드. 여러 Power BI 시각적 개체의 코드나 관계가 없는 코드는 포함할 수 없습니다.
certification(소문자 필수)이라는 분기. 이 분기의 소스 코드는 제출된 패키지와 일치해야 합니다. 이 코드는 Power BI 시각적 개체를 다시 제출하는 경우, 다음 제출 프로세스 중에만 업데이트할 수 있습니다.

Power BI 시각적 개체가 프라이빗 npm 패키지 또는 git 하위 모듈을 사용하는 경우 이 코드가 포함된 리포지토리에 대한 액세스 권한도 제공해야 합니다.

Power BI 시각적 리포지토리가 어떻게 보이는지 이해하려면 Power BI 시각적 개체 샘플 가로 막대형 차트에 대한 GitHub 리포지토리를 검토합니다.

파일 요구 사항

최신 버전의 API를 사용하여 Power BI 시각적 개체를 작성합니다.

리포지토리에는 다음 파일이 포함되어야 합니다.

.gitignore - 이 파일에 node_modules, .tmp 및 dist를 추가합니다. 코드에는 node_modules, .tmp 또는 dist 폴더가 포함될 수 없습니다.
capabilities.json - 이 파일의 속성이 변경된 새 버전의 기존 Power BI 시각적 개체를 제출하는 경우, 기존 사용자의 보고서를 중단하지 않는지 확인합니다.
pbiviz.json
package.json. 시각적 개체에는 다음 패키지가 설치되어 있어야 합니다.
- "typescript"
- "eslint"
- "eslint-plugin-powerbi-visuals"
- 이 파일은 linter를 실행하기 위한 명령 "eslint": "npx eslint . --ext .js,.jsx,.ts,.tsx"을 포함해야 합니다.
package-lock.json
tsconfig.json

명령 요구 사항

다음 명령이 오류를 반환하지 않는지 확인합니다.

npm install
pbiviz package
npm audit - 높음 또는 보통 수준의 경고를 반환하지 않아야 합니다.
필수 구성을 사용하는 ESlint. 이 명령이 lint 오류를 반환하지 않아야 합니다.

참고 항목

TSlint에서 ESLint로 마이그레이션하는 중입니다. TSlint를 사용하는 시각적 개체는 2023년 3월까지 인증을 받을 수 있습니다. 그 후에는 ESlint가 필요합니다.

컴파일 요구 사항

최신 버전의 powerbi-visuals-tools를 사용하여 Power BI 시각적 개체를 작성합니다.

pbiviz package를 사용하여 Power BI 시각적 개체를 컴파일합니다. 자체 빌드 스크립트를 사용하는 경우, npm run package 사용자 지정 빌드 명령을 제공합니다.

소스 코드 요구 사항

Power BI 시각적 개체 추가 인증 정책 목록을 따라야 합니다. 제출이 이러한 지침을 따르지 않는 경우 파트너 센터에서 나열된 정책 번호가 포함된 거부 이메일을 받게 됩니다.

여기에 나열된 코드 요구 사항에 따라 코드가 Power BI 인증 정책과 일치하는지 확인합니다.

Required

공용 Javascript 또는 TypeScript 라이브러리와 같은 공개적으로 검토 가능한 OSS 구성 요소만 사용하세요.
코드는 렌더링 이벤트 API를 지원해야 합니다.
DOM을 안전하게 조작해야 합니다. DOM에 추가하기 전에 사용자 입력 또는 사용자 데이터에 대한 삭제를 사용합니다.
샘플 보고서를 테스트 데이터 세트로 사용합니다.

허용되지 않음

외부 서비스 또는 리소스에 액세스. 예를 들어 Power BI가 어떤 서비스에도 HTTP/S 또는 WebSocket 요청을 보낼 수 없어야 합니다. 따라서 기능 설정에서 WebAccess 권한 은 비어 있거나 생략해야 합니다.
innerHTML 또는 D3.html(user data or user input) 사용.
브라우저 콘솔에서 입력 데이터에 대한 JavaScript 오류 또는 예외.
eval()과 같은 임의 또는 동적 코드, settimeout(), requestAnimationFrame(), setinterval(user input function), 사용자 입력 또는 사용자 데이터의 안전하지 않은 사용.
축소된 JavaScript 파일 또는 프로젝트.

인증을 위한 Power BI 시각적 개체 제출

이제 Power BI 팀에서 Power BI 시각적 개체를 인증하도록 요청을 제출할 준비가 되었습니다.

팁

Power BI 인증 프로세스는 시간이 걸릴 수 있습니다. 새 Power BI 시각적 개체를 만드는 경우 Power BI 인증을 요청하기 전에 파트너 센터를 통해 Power BI 시각적 개체를 게시하는 것이 좋습니다. 이렇게 하면 시각적 개체의 게시가 지연되지 않습니다.

Power BI 인증을 요청하려면

파트너 센터에 로그인합니다.
개요 페이지에서 Power BI 시각적 개체를 선택하고 제품 설정 페이지로 이동합니다.
Power BI 인증 요청 확인란을 선택합니다.
검토 및 게시 페이지의 인증에 대한 참고 사항 텍스트 상자에 소스 코드 및 액세스 자격 증명에 대한 링크를 제공합니다.

프라이빗 리포지토리 제출 프로세스

GitHub와 같은 프라이빗 리포지토리를 사용하여 인증을 위한 Power BI 시각적 개체를 제출하는 경우 이 섹션의 지침을 따르세요.

유효성 검사 팀을 위한 새 계정을 만듭니다.
계정의 2단계 인증을 구성합니다.
새 복구 코드 집합을 생성합니다.
Power BI 시각적 개체를 제출할 때 다음 세부 정보를 제공해야 합니다.
- 리포지토리에 대한 링크
- 로그인 자격 증명(암호 포함)
- 복구 코드
- 우리 계정(pbicvsupport)에 대한 읽기 전용 권한

인증된 Power BI 시각적 개체 배지

Power BI 시각적 개체가 인증되면 인증된 Power BI 시각적 개체임을 나타내는 지정된 배지를 가져옵니다.

AppSource의 인증된 Power BI 시각적 개체

누군가 온라인에서 AppSource의 Power BI 시각적 개체를 검색하면 시각적 카드에 있는 작은 노란색 배지에 인증된 Power BI 시각적 개체라고 표시됩니다.
AppSource에서 Power BI 시각적 카드를 클릭하면 PBI 인증이라는 노란색 배지에 이 Power BI 시각적 개체가 인증되었다고 표시됩니다.

Power BI 인터페이스의 인증된 Power BI 시각적 개체

Power BI(데스크톱 또는 서비스) 내에서 Power BI 시각적 개체를 가져오는 경우 파란색 배지는 Power BI 시각적 개체가 인증되었음을 표시합니다.
Power BI 인증 필터 옵션을 선택하여 인증된 Power BI 시각적 개체만 표시할 수 있습니다.

게시 타임라인

AppSource에 배포하는 프로세스에는 시간이 걸릴 수 있습니다. 이 프로세스가 완료되면 Power BI 시각적 개체를 AppSource에서 다운로드할 수 있습니다.

사용자가 내 시각적 개체를 다운로드할 수 있나요?

새 Power BI 시각적 개체를 제출한 경우 사용자는 AppSource에서 이메일을 받은 후 몇 시간 후에 다운로드할 수 있습니다.
기존 Power BI 시각적 개체에 업데이트를 제출하는 경우 사용자가 제출한 후 2주 이내에 업데이트를 다운로드할 수 있습니다.

참고 항목

AppSource의 버전 필드는 시각적 개체를 제출한 후 약 1주일 후에 AppSource에서 Power BI를 승인한 날짜로 업데이트됩니다. 사용자는 업데이트된 시각적 개체를 다운로드할 수 있지만 업데이트된 기능은 적용되지 않습니다. 시각적 개체의 새 기능은 약 2주 후에 사용자의 보고서에 영향을 줍니다.

언제 내 Power BI 시각적 개체에서 인증 배지를 표시하나요?

인증 배지는 제출이 승인된 후 3주 이내에 표시되어야 합니다.

추가 질문이 있으신가요? Power BI 커뮤니티를 사용해 보세요.

인증된 Power BI 시각적 개체

인증 제거