Power Apps自定义卡片字段提交后未同步至SharePoint列表的解决咨询

刚碰到过一模一样的情况，给你整理了几个核心排查点和解决办法，按顺序来大概率能搞定：

1. 检查自定义卡片的数据绑定是否正确 #

• 确保自定义卡片里的输入控件（比如文本框、下拉框）是绑定到原SharePoint列的，而不是新建变量或无关数据源。比如文本框的Default属性应该设为ThisItem.原列名，而不是静态值或其他变量。
• 如果是下拉框这类选项控件，Items属性要关联到原列的选项集，比如写Choices([@你的列表名].原列名)，别用自定义选项列表，否则提交时无法匹配列表字段类型。

2. 确认卡片的Update属性配置 #

这是最容易踩坑的点！把默认卡片改成自定义卡片后，Power Apps经常不会自动继承原有Update逻辑，得手动设置：

• 选中整个自定义卡片（注意是卡片容器，不是里面的输入控件），在右侧属性面板找到Update属性。
• 把它设置为输入控件的输出值：比如文本框TextInput1就写TextInput1.Text；下拉框Dropdown1写Dropdown1.Selected.Value（或Dropdown1.Selected，根据字段类型调整）。
• 重点提醒：如果是人员、日期、附件这类复杂字段，Update属性的格式必须和SharePoint列类型匹配。比如人员字段要写成{Claims: User().Email, DisplayName: User().FullName, Email: User().Email}这种符合要求的对象格式。

3. 验证表单的SubmitForm逻辑和模式 #

• 确认提交用的是SubmitForm(你的表单名)函数，别用Patch或其他自定义提交逻辑（如果用Patch得确保每个字段都正确映射，SubmitForm更省心）。
• 检查表单的Mode属性：编辑模式要设为FormMode.Edit，新建模式设为FormMode.New，模式错了会直接导致提交不生效。
• 另外，表单的DataSource必须是你的目标SharePoint列表，这个基础点有时候会不小心选错。

4. 排查SharePoint列的设置和权限 #

• 确认你修改的列不是SharePoint列表里的隐藏列或只读列，如果管理员设了只读，Power Apps就算提交了也无法更新。
• 检查当前用户对该列表的权限，必须有编辑项权限，否则提交时可能静默失败（有时候不会弹出错误提示）。
• 如果是计算列、已发布的受控列这类特殊字段，本身就不允许通过表单修改，只能由系统自动计算，这种情况得换普通列或调整逻辑。

5. 调试和测试技巧 #

• 可以在输入控件的OnChange事件里加Notify("当前值：" & Self.Text)，实时查看输入的值是否正确，避免控件没获取到输入内容。
• 提交时用If(SubmitForm(你的表单名), Notify("提交成功"), Notify("提交失败：" & ErrorInfo.Message))捕获错误信息，根据提示定位问题（比如字段类型不匹配、权限不足）。
• 临时把表单DefaultMode改成FormMode.New，新建一条测试数据，看自定义字段能不能正常写入，排除编辑模式下的特殊问题。

内容的提问来源于stack exchange，提问作者kellboy22