SPServices GetListItems获取托管元数据字段返回undefined求助

我之前踩过完全一样的坑！SPServices的GetListItems默认不会自动返回托管元数据字段的内容，直接用ows_documentname拿值自然会返回undefined，给你几个亲测有效的解决方案：

• 先确认字段的内部名称是否正确
  很多时候问题出在字段名上：托管元数据字段的内部名称可能和显示名不一样（比如显示名带空格的话，内部名会变成Document_x0020_Name这种格式）。你可以去列表设置→点击该托管元数据字段，从浏览器地址栏里提取Field=xxx里的xxx，这就是真实的内部名称。

• 在CAMLViewFields里明确指定要获取的字段
  GetListItems只会返回视图中包含的字段，或者你通过CAMLViewFields指定的字段。一定要把托管元数据字段加进去，示例代码如下：

  $().SPServices({
    operation: "GetListItems",
    listName: "你的自定义列表名称",
    CAMLViewFields: "<ViewFields><FieldRef Name='DocumentName' /></ViewFields>", // 替换成你的字段内部名
    completefunc: function (xData, Status) {
      $(xData.responseXML).SPFilterNode("z:row").each(function() {
        // 托管元数据字段的返回格式是「#|显示值|字段GUID」
        var rawMetadata = $(this).attr("ows_DocumentName"); // 对应字段内部名前缀加ows_
        if(rawMetadata) {
          // 提取实际显示值
          var displayValue = rawMetadata.split("|")[1];
          console.log("托管元数据值：", displayValue);
        } else {
          console.log("该条记录无托管元数据值");
        }
      });
    }
  });
  

• 指定包含该字段的视图
  如果不想写CAMLViewFields，可以直接用ViewName参数指定一个已经包含该托管元数据字段的视图名称（或者视图的GUID），这样GetListItems会自动返回视图里的所有字段。

• 排除权限问题
  极少数情况下，当前用户没有该字段的读取权限，也会导致返回undefined，可以换管理员账号测试一下排除这个可能。

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