Power BI 시각적 개체 패키지

사용자 지정 시각적 개체를 Power BI Desktop에 로드하거나 Power BI 시각적 개체 갤러리에서 커뮤니티와 공유하려면 먼저 패키징해야 합니다. 이 자습서를 사용하여 다음을 수행합니다.

• 시각적 개체에 대한 메타데이터 및 속성 값을 제공합니다.
• 아이콘을 업데이트합니다.
• 사용자 지정 시각적 개체를 패키징합니다.

속성 값 입력

1. PowerShell에서 실행 중인 시각적 개체를 중지합니다.

2. VS Code에서 시각적 개체 프로젝트의 루트 폴더로 이동하여 pbiviz.json 파일을 엽니다.

3. visual 개체에서 displayName 값을 시각적 개체의 표시 이름이 될 값으로 설정합니다.

   

   시각적 개체 아이콘 위에 커서를 놓으면 Power BI의 시각화 창에 시각적 개체의 표시 이름이 나타납니다.

4. pbiviz.json 파일에서 다음 필드를 입력하거나 수정합니다.

   • visualClassName
   • description

   visualClassName의 경우 선택 사항이지만 패키지 명령을 실행하려면 description 항목을 입력해야 합니다.

5. supportUrl 및 gitHubUrl에 사용자가 방문하여 지원을 받고 시각적 개체의 GitHub 프로젝트를 볼 수 있는 URL을 입력합니다.

   다음 코드는 supportUrl 및 gitHubUrl 예제를 보여 줍니다.

   {
       "supportUrl": "https://community.powerbi.com",
       "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
   }
   

6. author 개체에 이름과 메일을 입력합니다.

7. pbiviz.json 파일을 저장합니다.

아이콘 업데이트(선택 사항)

1. pbiviz.json 파일에서 문서는 assets 개체의 아이콘에 대한 경로를 정의합니다. 아이콘은 Power BI의 시각화 창에 표시되는 이미지입니다. PNG 형식 파일이며 20x20픽셀이어야 합니다.

2. Windows 탐색기에서 사용하려는 icon.png 파일을 복사한 후 붙여넣어 자산 폴더에 있는 기본 icon.png 파일을 바꿉니다.

3. VS Code의 탐색기 창에서 자산 폴더를 확장한 다음, icon.png 파일을 선택합니다.

4. 아이콘을 검토합니다.

   

시각적 개체를 패키징합니다.

1. VS Code에서 모든 파일이 저장되었는지 확인합니다.

2. PowerShell에서 다음 명령을 입력하여 pbiviz 파일을 생성합니다.

   pbiviz package
   

   이 명령은 시각적 프로젝트의 /dist/ 디렉터리에 pbiviz 파일을 만들고 이전에 존재할 수 있는 pbiviz 파일을 덮어씁니다.

   

패키지가 프로젝트의 /dist/ 폴더에 출력됩니다. 패키지에는 Power BI 서비스 또는 Power BI Desktop 보고서로 사용자 지정 시각적 개체를 가져오는 데 필요한 모든 것이 포함되어 있습니다. 사용자 지정 시각적 개체를 패키징했으므로 사용할 준비가 되었습니다.

관련 콘텐츠

• 파트너 센터에 Power BI 시각적 개체 게시
• 사용자 지정 시각적 개체 가져오기