用途
add-sharepoint 用于向 Power Apps 代码应用添加 SharePoint Online 连接器。适用场景包括:读取 SharePoint 列表、管理文档、与 SharePoint 站点集成,以及创建新的 SharePoint 列表。
主要能力
该技能提供两条路径:使用已有列表(直接跳到第 6 步)或创建新列表(执行完整工作流)。完整工作流包含 12 个步骤:检查 Memory Bank、规划、设置 Graph API 认证、审查现有列表、创建列表、获取连接 ID、发现站点、发现表、添加连接器、配置、构建、更新 Memory Bank。
技能附带多份参考文档:shared-instructions.md(跨领域关注点)、sharepoint-reference.md(列编码、选项字段、查找、API 模式,标注为关键)、api-authentication-reference.md(Graph API 认证、令牌、站点 ID)、list-management-reference.md(查询、创建、扩展列表和列)。
使用方式
规划阶段会询问用户需要哪些 SharePoint 列表、列表是否已存在。若创建新列表,会询问所需数据并设计 schema,复用已有列表,进入计划模式展示列设计并获取批准。
设置 Graph API 认证(创建列表时)需验证 Azure CLI 登录,并调用 Initialize-SharePointGraphApi,需要 Sites.Manage.All 权限。
审查现有列表时先查询已有列表,使用 Find-SimilarLists、Compare-ListSchemas、Get-ListSchema 等函数,向用户呈现可复用、需扩展、需新建的列表。创建列表需明确确认,使用 New-SharePointListIfNotExists、Add-SharePointColumnIfNotExists、Add-SharePointLookupColumn 等安全函数。
获取连接 ID 时运行 /list-connections 技能,查找 SharePoint Online 连接;若无则引导用户通过环境专属 Connections URL 创建。
发现站点使用命令:pa connector list-datasets --connector sharepointonline -c <connection-id>。发现表使用命令:pa connector list-tables --connector sharepointonline -c <connection-id> -d '<site-url>'。
添加连接器使用命令:pa app add data-source --connector sharepointonline -c <connection-id> -d '<site-url>' --table '<table-name>'。
配置阶段提供常见操作示例,包括 GetItems、PostItem、ListFolder、GetFileContent。关键点:dataset 始终是完整 SharePoint 站点 URL;table 是列表显示名称;API 中的列名可能与显示名不同(空格变为 x0020,特殊字符被编码);文档库操作使用文件夹/文件 ID 或服务器相对 URL;选项列使用字符串值而非整数代码。
构建阶段运行 npm run build,修复 TypeScript 错误,暂不部署。最后更新 memory-bank.md,记录连接器、站点 URL、配置或创建的列表/库、构建状态。
适用场景
适用于需要在 Power Apps 代码应用中集成 SharePoint Online 数据的开发者,包括读取列表项、创建列表项、获取文档库文件、获取文件内容等。
限制
创建列表需要 Sites.Manage.All 权限。若 pa connector list-datasets 或 list-tables 失败或返回空结果,需按指引排查认证或权限问题,确认后仍为空则停止。站点 URL 必须精确复制,不能重新输入。具体收费、价格、平台支持范围等事实暂未提供。