SuperAPI AI 工具集

create-pcf

编程与开发

查看项目

更新于 11-16 11:45

技能介绍

create-pcf 用于为模型驱动应用(model-driven apps)创建或扩展 Power Apps Component Framework(PCF)控件,目标产物是可运行的 TypeScript PCF 项目,而非设计稿或代码片段。

主要能力

  • 支持字段控件(绑定单个列)与数据集控件(绑定表视图/子网格)的创建与扩展。
  • 要求每个新控件使用 pac pcf init --framework react 脚手架,使用宿主提供的 React 与 Fluent UI v9 平台库。
  • 控件逻辑、组件与测试使用 .ts/.tsx 编写,不使用纯 JavaScript;不修改自动生成文件。
  • 通过 context.webAPI 执行 Dataverse 操作,通过解决方案打包支持发布与跨环境推广。
  • 提供质量检查清单,以及组件模式、清单参考、虚拟控件生命周期等官方文档参考材料。

使用方式

  1. 勘察仓库说明、现有 PCF 项目、清单、生成类型、依赖、共享辅助、本地化资源与测试,尽量扩展已有虚拟控件。
  2. 确认缺失决策:控件名称/命名空间/目录、新建或扩展、字段或数据集绑定、目标位置与设备尺寸、默认值/激活/提交/取消行为、可空与可访问性要求、打包与部署信息。
  3. 核验 PAC CLI、Node/npm、MSBuild 及项目构建要求,使用配置的 npm 源并固定与平台契约兼容的版本。
  4. 在约定目录执行 pac pcf init 脚手架(field 或 dataset 模板、react 框架),复用脚手架的 pcf-scripts、生成类型与构建管线。
  5. 实现 ComponentFramework.ReactControl 生命周期、数据流、Dataset 绑定与 Dataverse 操作,并遵循非文本可空字段编辑器的空值到默认值契约。
  6. 未经明确批准不得部署。

适用场景

  • 为模型驱动应用构建或扩展自定义字段编辑器、评分、开关等 PCF 控件。
  • 构建数据集控件并在真实宿主中测试分页、筛选/排序、选择与 WebAPI 行为。
  • 需要遵循 React 与 Fluent UI v9 平台库契约、TypeScript 边界与解决方案打包规范的项目。

限制

  • 不使用 React 18 API(如 createRoot、useId),不引入独立的打包器。
  • 不使用 Xrm.WebApi、直接 Dataverse fetch/HTTP 客户端或父窗口 API;字段值通过绑定输出由表单管理保存生命周期。
  • 测试工具不完全实现数据集 API,相关行为需在真实模型驱动宿主中验证。
  • 文中列出的运行时版本为编写时的参考快照,不是当前可用性的承诺。