扩展性工具包引入了一套功能，旨在尽可能简单地将您的数据应用程序引入到 fabric。 这些功能使开发人员能够尽可能少地构建丰富的集成体验。 使用 Extensibility Toolkit，可以轻松地直接从前端访问 Fabric API，在 Fabric 中保留项定义（状态），使用标准化项创建流，并通过 iFrame 放松和公共 API 支持利用改进的安全性和互作性。 此外，它还通过内置的 CI/CD 支持简化了开发生命周期，使部署和测试更加轻松。 以下部分概述了有关如何将它们合并到工作负载的主要功能和指南。
标准项目创建体验
通过使用 “Fabric” 控件对项目创建进行标准化，该控件帮助指导用户完成整个过程。 此控件允许用户选择在其中创建项目、分配敏感度标签和配置其他相关设置的工作区。 使用此标准化体验，不再需要自行处理项目创建的复杂性，也不再需要担心流程的未来更改。 此外，此方法允许项创建直接显示在工作负荷页中，从而提供无缝和集成的用户体验。
使用 “如何创建项”指南 来了解如何实现它。
前端 API 支持
使用扩展性工具包，可以直接在前端应用程序中获取 Microsoft Entra On-Behalf-Of （OBO） 令牌，从而能够安全地访问任何受 Entra 保护的 API。 此功能允许你与 Microsoft Fabric 服务深度集成，例如，可以在 OneLake 中读取和存储数据、创建与其他 Fabric 项进行交互，或者通过 Livey API 将 Spark 用作处理引擎。 有关详细信息，请参阅 Microsoft Entra 文档、 OneLake 文档、 Fabric REST API 和 Fabric 中的 Spark。
使用 如何获取 Microsoft Entra Token 指南 来了解如何实现它。 另请使用 “如何访问 Fabric API”指南 来了解如何与 Fabric 交互。
在 Fabric 中存储项定义（状态）
此功能使你能够将项的元数据（如项目配置和其他相关信息）直接存储在对最终用户不可见的隐藏文件夹中的 OneLake 中。 数据使用公共 API 和 CI/CD 进程应用的相同格式进行存储，确保不同集成点的一致性和互作性。 以下部分讨论了有关格式及其与公共 API 和 CI/CD 用法的详细信息。
使用 如何存储项目定义 来了解如何实现它。
定义中要存储的内容
将状态视为持有所有信息，以便在对象被删除或复制到其他位置时进行还原。 这不包括存储在 OneLake 中的数据本身（请参阅 在 OneLake 中存储项数据）。
下面是一些实际示例：
- 笔记本项：状态存储笔记本的代码、单元格顺序和元数据，例如应使用哪个执行引擎（例如 Spark、SQL）。 笔记本处理的实际数据不存储在状态中。
- 文件编辑器项：状态不存储文件内容本身，而是存储编辑器配置，例如配色方案、自动完成设置、字号和其他用户首选项。
- 安装程序或业务流程协调程序项：如果项安装或预配其他组件（如数据库或计算资源），状态应保留对其创建的项的引用（ID、URI）。 这样，您的工作负载即可检查其状态，或者稍后对其进行管理。
通过专注于配置、元数据和引用，可以确保项的状态可移植、轻型且易于还原或迁移。
在 OneLake 中存储项数据
每个项目都有其自己的 Onelake 项目文件夹，开发人员可在其中存储结构化和非结构化数据。 与 Lakehouse 类似，该项具有一个表文件夹，其中数据可以存储在 Delta 或 Iceberg 格式，以及可存储非结构化数据的 Files 文件夹。
使用 How to store data in Item 来理解如何实现它。
快捷方式数据
由于每个项目都有其自己的 Onelake 文件夹，它们也可以使用快捷方式。 通过公共 快捷方式 API 工作负载，开发人员可以创建不同的快捷方式类型，从或到其项中参与 OneLake 的单次复制保证。
使用 “如何创建快捷方式 ”来了解如何实现快捷方式。
CRUD 项 API 支持
用户可以使用标准 Fabric 项 Rest API 创建、更新和删除包含内容的项目。 这种自动启用功能使得与核心 Fabric 项目以相同方式集成工作负载项变得更加轻松，简化了互操作性，并减少了构建可靠集成所需的工作量。
CI/CD 支持
注释
扩展性工具包的 CI/CD 支持目前正在开发中。 下面介绍的功能是计划的功能，在发布之前可能会更改。
所有项目的 CI/CD 支持是客户的主要需求之一。 使用此功能，所有项目可以开箱即用地参与 CICD，无需实现任何特定的逻辑或操作。 这意味着可以使用标准 Azure Pipelines 和工具自动部署、测试和更新工作负载。 项格式和 API 旨在与 CI/CD 进程完全兼容，确保跨环境提供一致且可靠的体验。 有关与 CI/CD 集成的详细信息，请参阅 Fabric CICD 文档。
项目CRUD通知接口
注释
扩展性工具包的 CRUD 通知 API 支持目前正在开发中。 下面介绍的功能是计划的功能，在发布之前可能会更改。
在某些情况下，工作负载需要处理项 CRUD 事件。 由于项目是通过 UX 直接在平台上创建的，因此当通过这些入口点创建新项时， 公共 API 或 CI/CD 工作负荷所有者不会控制这些项。 默认情况下，项将 状态 存储在 Fabric 中，无需了解其项的更改。 然而，在某些情况下，工作负载需要参与 CRUD 流程。 这主要是需要预配或配置项目基础结构（例如数据库）的情况。 对于这些场景，我们允许合作伙伴实现一个 Crud 通知 API，Fabric 会在每个事件上调用该 API。 在此方案中，工作负载开发者需要确保其 API 可到达，否则 Fabric 操作会失败。
网络调度程序
注释
对扩展性工具包的 Fabric 调度程序支持目前正在开发中。 下面介绍的功能是计划的功能，在发布之前可能会更改。
Fabric 支持工作负载的任务调度。 此功能允许开发人员构建工作负载，即使用户不在用户体验界面前，也能在被通知后基于应执行的作业（例如，在 Onelake 中复制数据）采取行动。 合作伙伴需要实现 API 并将其工作负载配置为参与此功能。
iFrame 权限放宽
开发人员可以请求更多 iFrame 属性来启用高级方案，例如文件下载或打开外部网站。 此功能允许工作负载在执行需要更广泛的浏览器功能的作（例如，使用当前 Fabric 凭据启动下载或将用户连接到外部 API）之前提示用户明确同意。 通过在工作负荷配置中指定这些要求，可确保用户获得通知并可以授予必要的权限，从而在保持安全性和用户信任的同时，实现与外部系统的无缝集成。
使用 “如何放宽 iFrame ”，了解如何实现它。
注释
启用此功能需要用户授予对放宽范围更多的Microsoft Entra 同意，超出了基本工作负荷功能所需的标准 Fabric 范围。
功能限制
专用链接
如果租户或工作区级别启用了专用链接，则会阻止所有工作负荷的使用和开发。