如何通过Office JS访问并更新SharePoint自定义内容类型字段值？

当然可以用Office JS访问并更新自定义内容类型的字段值！你之前遇到的问题主要是用错了API路径，还有CSOM和Office客户端锁机制的冲突问题，下面给你详细拆解：

一、为什么customproperties拿不到自定义字段？ #

context.document.properties.customproperties确实只能拿到和文档本身绑定的少量系统级自定义属性（比如ContentTypeId），而你自定义内容类型里的字段本质是存在SharePoint列表项的属性中的，得用Office JS专门的SharePoint列表项API来操作。

二、用Office JS操作自定义字段的正确姿势 #

1. 先确认权限配置

在你的Office Add-in清单文件里，要配置足够的权限，比如如果只需要操作当前文档的字段，设置ReadWriteDocument就够了：

<Permissions>ReadWriteDocument</Permissions>

如果需要操作整个列表的其他项，可以用ReadWriteList。

2. 示例代码：读取并更新自定义字段

下面是完整的异步操作示例，记得把字段的内部名称替换成你自己的（内部名称可以在SharePoint列表设置的字段详情页找到，不是显示名称）：

// 获取当前文档对应的SharePoint列表项
Office.context.document.sharepointSite.getItemAsync(function(result) {
  if (result.status === Office.AsyncResultStatus.Succeeded) {
    const listItem = result.value;
    
    // 读取自定义字段值
    const fieldValue = listItem.get_item('YourCustomFieldInternalName');
    console.log('当前字段值：', fieldValue);
    
    // 更新字段值
    listItem.set_item('YourCustomFieldInternalName', '更新后的新值');
    
    // 提交更改到SharePoint
    listItem.updateAsync(function(updateResult) {
      if (updateResult.status === Office.AsyncResultStatus.Succeeded) {
        alert('字段更新成功！');
      } else {
        console.error('更新失败：', updateResult.error.message);
      }
    });
  } else {
    console.error('获取列表项失败：', result.error.message);
  }
});

三、关于CSOM的“文档锁定”错误 #

这个问题是因为当你在Office客户端打开文档时，客户端会自动给文档加一个临时协作锁，防止多人冲突编辑。而CSOM是直接调用SharePoint服务器端API，没有和客户端的锁机制做协同，所以容易触发锁冲突报错。用Office JS的话，操作是在Office客户端的上下文里进行的，会自动处理锁的问题，基本不会出现这个错误。

补充：文档属性面板的字段同步 #

你提到字段在文档属性面板里显示，也可以尝试用Office.context.document.properties.load()加载所有属性，但有些自定义字段可能还是需要通过列表项API才能读写，因为properties对象只同步了部分和Office客户端兼容的字段，而内容类型的自定义字段更可靠的方式还是用SharePoint列表项API。

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