SPFx中用XML创建带查找列的SharePoint列表遇值范围错误

常见原因及修复步骤 #

1. 查找列的目标列表引用错误 #

查找列必须精准指向已创建的「Employee details」列表，若引用的GUID或名称不匹配，会直接触发该错误。

• 修复操作：
  • 在「Selected Employee」列表的Schema.xml中，确保查找列的List属性使用目标列表的准确GUID，或使用无空格的内部名称（比如EmployeeDetails）。
  • 正确示例：

    <Field Type="Lookup" DisplayName="Selected Employee" Required="FALSE" List="{$ListId:Employee details$}" ShowField="Title" StaticName="SelectedEmployee" Name="SelectedEmployee" />
    

  • 注意：使用{$ListId:列表显示名称$}语法时，名称需和element.xml中定义的完全一致，包括空格和大小写。

2. 列表创建顺序颠倒 #

如果「Selected Employee」列表先于「Employee details」创建，查找列找不到目标列表就会报错。

• 修复操作：
  • 在package-solution.json的features数组中，调整顺序让「Employee details」对应的feature排在前面。
  • 正确示例：

    "features": [
      {
        "title": "Employee Details List Feature",
        "description": "Provisions Employee Details list",
        "id": "xxxx-xxxx-xxxx-xxxx",
        "version": "1.0.0.0",
        "assets": {
          "elementManifests": [
            "EmployeeDetails/Elements.xml"
          ]
        }
      },
      {
        "title": "Selected Employee List Feature",
        "description": "Provisions Selected Employee list with lookup to Employee Details",
        "id": "yyyy-yyyy-yyyy-yyyy",
        "version": "1.0.0.0",
        "assets": {
          "elementManifests": [
            "SelectedEmployee/Elements.xml"
          ]
        }
      }
    ]
    

3. XML文件存在语法/属性错误 #

XML文件中标签未闭合、属性值无效或缺失必填项，也会引发范围错误。

• 修复操作：
  • 检查两个列表的element.xml和Schema.xml，确保所有标签格式正确，Type、Name等属性拼写无误。
  • 确保Schema.xml中List节点的Title和Url属性无特殊字符或格式问题。
  • 正确示例（Employee details的element.xml）：

    <Elements xmlns="http://schemas.microsoft.com/sharepoint/">
      <ListInstance Title="Employee details" OnQuickLaunch="TRUE" TemplateType="100" Url="Lists/EmployeeDetails" Description="Stores employee information">
        <DataSource>
          <Property Name="ListUrl" Value="Lists/EmployeeDetails"/>
        </DataSource>
      </ListInstance>
    </Elements>
    

4. 重复的GUID或模板ID #

若两个列表的Feature ID重复，或列表模板ID与系统内置模板冲突，会触发错误。

• 修复操作：
  • 确保package-solution.json中每个feature的id都是唯一GUID（可通过在线工具生成新的）。
  • 自定义列表使用TemplateType="100"，避免和系统内置列表模板ID冲突。

5. 站点已存在同名列表 #

若站点中已有「Employee details」或「Selected Employee」列表，安装应用时会因冲突报错。

• 修复操作：
  • 先删除站点内的同名列表，再重新安装SPFx应用；或修改列表的Title和Url属性，使用唯一名称（比如EmployeeDetails_v2）。

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