使用Salesforce元数据API创建联系人列表视图的报错及参数有效性咨询

你当前提交的SOAP元数据API payload 完全不具备创建Contact对象列表视图的合法性，就算解决了当前的content-type报错，也会因为元数据字段缺失、结构不匹配返回创建失败的错误。

已遇到报错的根因说明 #

• 第一次调用REST端点的METHOD_NOT_ALLOWED报错：
  你使用的/services/data/v51.0/sobjects/Contact/listviews是REST API的只读查询端点，仅支持GET、HEAD方法拉取现有列表视图的元数据，本身不支持POST创建操作，场景不匹配是报错核心原因。
• 第二次切换SOAP端点后的content-type of the request should be text/xml报错：
  你更换的SOAP元数据端点格式是完全合规的，不需要调整；Salesforce SOAP元数据API兼容SOAP 1.1协议，强制要求请求头携带Content-Type: text/xml; charset=UTF-8，你当前的请求未设置对应头字段（大概率客户端默认发送了application/json类型的头），直接被服务端拦截。

当前SOAP payload的核心缺失项 #

你要创建的列表视图属于ListView类型元数据，当前提交的metadata块仅填了fullName字段，完全不符合元数据创建的必填规则：

• 缺失元数据类型声明：createMetadata接口支持传入多类元数据对象，必须通过xsi:type="met:ListView"明确告知服务端本次要创建的是ListView类型的元数据，否则会触发元数据类型识别错误
• 缺失列表视图的归属对象标识：必须显式指定<met:object>Contact</met:object>字段，否则服务端无法识别该视图要挂载到哪个业务对象下
• fullName字段格式错误：ListView类型元数据的fullName遵循「父对象API名称.列表视图API名称」的层级规则，正确格式应为Contact.TESTVIEW__c，你当前仅填写TESTVIEW__c，无归属上下文
• 缺失所有必填展示与行为控制字段：至少需要补充列表视图的显示名称label、可见范围sharedToAll、数据过滤范围filterScope、视图类型type，否则系统无法完成视图初始化

合规的最小可运行SOAP请求示例 #

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:met="http://soap.sforce.com/2006/04/metadata">
   <soap:Header>
      <met:AllOrNoneHeader>
         <met:allOrNone>false</met:allOrNone>
      </met:AllOrNoneHeader>
      <met:CallOptions>
         <met:client>你的客户端标识</met:client>
      </met:CallOptions>
      <met:SessionHeader>
         <met:sessionId>你的有效会话ID</met:sessionId>
      </met:SessionHeader>
   </soap:Header>
   <soap:Body>
      <met:createMetadata>
         <met:metadata xsi:type="met:ListView" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <!-- 正确格式的fullName：对象名.视图API名 -->
            <met:fullName>Contact.TESTVIEW__c</met:fullName>
            <!-- 明确指定归属对象 -->
            <met:object>Contact</met:object>
            <!-- 视图显示名称 -->
            <met:label>测试自定义视图</met:label>
            <!-- 是否全员可见 -->
            <met:sharedToAll>false</met:sharedToAll>
            <!-- 数据过滤范围：此处设置为查看当前用户名下的联系人 -->
            <met:filterScope>MyItems</met:filterScope>
            <!-- 视图类型为自定义向导生成视图 -->
            <met:type>Wizard</met:type>
         </met:metadata>
      </met:createMetadata>
   </soap:Body>
</soap:Envelope>

注意点：发送上述请求时必须在HTTP请求头里设置Content-Type: text/xml; charset=UTF-8，否则还是会触发之前的content-type拦截报错。

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