用途:为 Power Pages 代码站点添加服务端逻辑(Server Logic),即运行于 Power Pages 运行时、对浏览器隐藏的服务端 JavaScript,用于安全调用外部 API、读写 Dataverse 记录以及实现自定义业务逻辑,避免向客户端暴露敏感代码或凭据。工作流涵盖确认站点、需求分析、获取最新文档、方案确认、编写代码、配置表权限、管理密钥与环境变量、配置站点设置、前端集成、验证测试与部署。
主要能力与约束:运行于沙箱服务端环境,支持 ECMAScript 2023;无 fetch、XMLHttpRequest、setTimeout 等浏览器 API,无 npm 依赖。文件只能导出 get、post、put、patch、del 五个顶层函数(delete 为保留字)。每个函数必须返回字符串,返回对象或数组时使用 JSON.stringify()。可用 SDK 能力包括 Server.Connector.HttpClient、Server.Connector.Dataverse、Server.Context、Server.User、Server.Logger、Server.Sitesetting、Server.EnvironmentVariable、Server.Website。
使用方式:需已创建 Power Pages 代码站点并至少部署一次(存在 .powerpages-site 文件夹),因为逻辑文件位于 .powerpages-site/server-logic/。插件检查运行 node "${PLUGIN_ROOT}/scripts/check-version.js";列出 Dataverse 自定义操作运行 node "${PLUGIN_ROOT}/scripts/list-custom-actions.js" "<ENV_URL>"。可复用或扩展现有 Server Logic;涉及 Dataverse 时可选择包装已有 Custom API 或 Custom Process Action。涉及密钥时可选 Azure Key Vault(推荐)或直接使用 Dataverse 环境变量。
限制与注意:官方文档为唯一事实来源,Server Logic 功能处于预览阶段,SDK 可能变化,编写代码前应获取最新 Microsoft Learn 文档,不能仅依赖缓存知识。若缺少 .powerpages-site,必须先部署或停止流程。资料未提供具体收费信息、完整代码示例及部署命令细节。