Note: this repository was recently moved from powerbi-visuals-docs.

The old powerbi-visuals repository has been moved to powerbi-visuals-core.

#Power BI Visuals

Learn how to build Power BI visuals!

##Developing Your First PowerBI Visual

This section is to provide you with a step by step tutorial of developing your first PowerBI visual. In this tutorial, you will be building a simple bar chart. The source code is located here in the Sample Bar Chart Repo.

Setting Up Environment

1. Install PowerBI visuals CLI tool
2. Install SSL certifications to enable live preview of visuals
3. Enable Developer Tools in PowerBI
4. Create New PowerBI Visual Project
5. Start Development Server for Live Update and Incremental Development
6. Adding the Debug Visual from the Visual Well into your Favorite Report
7. Adding External Libraries
8. Installing Typings for Libraries

Building Bar Chart

1. Building a Visual with Static Data
2. Adding Databinding to the Bar Chart
3. Adding Color to the Bar Chart
4. Adding Selection and Interaction with Other Visuals
5. Adding Static Objects to Property Pane
6. Adding Databound Objects to Property Pane
7. Finally Package for Distribution ... Done!

##Table of Contents

• Anatomy of a Visual Project
• Installing PowerBI Visuals Tool
  • Install SSL Certifications
  • Enable Developer Tools
  • Tools Usage Guide
  • Debugging Guide
• Adding External Libraries
  • Installing Typings for Libraries
• Visual Capabilities Definition
  • Data Roles
  • Data View Mappings
  • Objects
  • Highlighting
• Visual Documentation
  • Visual/IVisual Api
  • Handling Selection in Visuals
• PowerBI Glossary
• Change Log
• Roadmap

##Reporting Issues

If you have any issues with Power BI custom visuals or the command line tools please let us know. First, search the issues page to see if your issue has already been reported. If it already exists please contribute your experience to the comments otherwise create a new issue. Be sure to be as detailed as possible about exactly what you were doing when the issue occured and how we can reproduce it.

• PowerBI-visuals-tools issue page - Issues related to the CLI tools specifically
• PowerBI-visuals issue page - Any other issues related to Power BI visuals