ModelDerivative API无法获取链接模型属性的技术咨询

可能的问题点及解决办法 #

1. 转换作业未正确包含链接模型 #

转换带链接的Revit模型时，必须显式配置参数确保链接模型被完整处理：

• 提交转换作业的Payload需包含advanced.includeLinks和generateMasterViews参数：

{
  "input": {
    "urn": "your-urn-here"
  },
  "output": {
    "formats": [
      {
        "type": "svf",
        "views": ["3d"],
        "advanced": {
          "generateMasterViews": true,
          "includeLinks": true
        }
      }
    ]
  }
}

若之前未配置这些参数，重新提交转换作业并等待完成后再测试。

2. 所选3D视图未包含链接模型 #

• 通过GET /modelderivative/v2/designdata/{urn}/metadata获取的3D视图可能仅加载主模型元素，需确认视图是否为包含所有链接的主视图（通常命名带有"Master View"标识）。
• 尝试遍历所有3D视图的Guid，分别调用Properties Query接口，验证是否有视图能返回链接模型属性。

3. Query接口未指定包含链接的范围 #

近期API可能调整了默认查询范围，需显式指定查询覆盖链接模型：

• 在POST请求的Payload中添加scope: "all"参数：

{
  "queryIn": [
    "externalId",
    "guid1",
    "guid2"
  ],
  "fields": ["objectid", "name", "externalId"],
  "scope": "all"
}

4. ExternalId格式不匹配 #

链接模型的ExternalId可能带有特定前缀（如链接模型的URN或标识），需确认传入的Guid格式是否正确：

• 先调用不带过滤的GET /modelderivative/v2/designdata/{urn}/metadata/{3dViewGuid}/properties，获取链接模型元素的ExternalId，对比你传入的Guid是否完全一致（比如是否包含链接模型的前缀）。

5. 验证链接模型的元数据是否存在 #

• 调用GET /modelderivative/v2/designdata/{urn}/metadata，检查返回的元数据中是否包含role为link的子元数据项。如果没有，说明转换环节未正确处理链接模型，需重新配置转换参数。

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