Microsoft Power BI Developer Samples 教程

1. 项目目录结构及介绍

本项目位于GitHub上，旨在为开发者提供一系列关于如何在不同场景下使用Power BI的示例。主要框架分为.NET Framework、.NET Core、Python、Java、Node.js等，以支持“应用拥有数据”（Embed for your customers）和“用户拥有数据”（Embed for your organization）两种嵌入模式。项目结构大致如下：

• 根目录: 包含总的说明文档(README.md)，提供了总体项目概述和关键信息。
• 框架特定文件夹:
  • .NET Framework, .NET Core, Python, Java, Node.js: 每个框架都有其子目录，内含针对该语言的样例代码。
  • React TS: 特定于React技术栈的解决方案。
• PowerShell: 包含了用于调用Power BI REST API的PowerShell脚本示例。
• 样本相关文档: 在各个样本的目录中，有专门的README.md文件详细介绍了如何运行各自的样本。

2. 项目启动文件介绍

由于此项目是多语言、多场景的集合，启动文件依赖于具体的技术栈和应用场景。通常：

• 对于.NET项目，启动文件可能是Program.cs或者对应的入口类文件，负责初始化应用程序。
• 在Python中，可能会有一个名为main.py或对应应用逻辑的起始脚本。
• Node.js项目可能通过index.js或指定的脚本来启动。
• Java项目一般有一个主类，含有public static void main(String[] args)作为程序入口点。

具体到每个示例，应该参照各自目录下的README.md文件，它将提供清晰的步骤来说明如何启动相应的示例应用。

3. 项目的配置文件介绍

配置文件根据技术栈的不同而变化。一般来说：

• .NET 和 .NET Core: 配置通常位于appsettings.json或环境特定的文件如appsettings.Development.json。
• Python: 可能采用.ini文件或简单的.py配置模块。
• Java: 配置可以存储在一个 properties 文件中，例如 application.properties。
• Node.js: 常见于一个名为config.js的文件或是环境变量中。
• 共通: 许多示例可能还包括特定于Power BI的设置，这些设置可能涉及API密钥、工作区ID等，这些通常也是在配置文件或环境变量中定义。

对于加密凭据和更新数据源的解决方案，特别注意的是这些配置处理逻辑通常集成在项目代码内，并且特定于使用的框架。确保查看各框架下的具体样例和它们的配置指南来获取详细信息。

在操作之前，请确保Windows系统上的路径长度不超过260个字符，这是运行项目的一个重要先决条件。此外，详细的开发文档和解决过程中的常见问题解答可以在Power BI Developer Documentation找到。