Forge-Get Item Path 以及 BIM360 文档中的自定义属性

Question

需要两个要求：

1. 在 BIM360 文档管理中获取文档的项路径。
2. 获取该项目的所有自定义属性。 对于请求。 1，存在一个 api 来获取和获取自定义属性，另一个 api 存在并且可以检索数据。 有没有办法在一个 api 调用中同时获得这两个要求，而不是使用两个。 在大量记录的情况下，检索项目路径的api需要一个多小时才能获取19000+条记录，并且使用刷新令牌时令牌过期，而自定义属性api以50个批次处理数据，在5内完成分钟而已。 请提出建议。

Answer 1

Batch-Get Custom Attributes 是针对特定于 Document Management 的附加属性。而项目中的路径是数据管理的一般信息。

数据管理 API 以命令的形式提供了一些端点，可以要求后端处理一堆项目的数据。 https://forge.autodesk.com/en/docs/data/v2/reference/http/ListItems/

此命令一次将检索最多 50 个指定项目的元数据。它也支持 includePathInProject 标志，但用法很棘手，API 文档中没有说明。在响应中，它将告诉这些项目的 pathInProject。它可能比迭代节省更多时间。

 {
     "jsonapi": {
      "version": "1.0"
 },
  "data": {
"type": "commands",
"attributes": {
  "extension": {
    "type": "commands:autodesk.core:ListItems",
    "version": "1.0.0" ,
    "data":{
        "includePathInProject":true
    }

  }
},
"relationships": {
  "resources": {
    "data": [
      {
        "type": "items",
        "id": "urn:adsk.wipprod:dm.lineage:vkLfPabPTealtEYoXU6m7w"
      },
      {  
        "type": "items",
        "id": "urn:adsk.wipprod:dm.lineage:bcg7gqZ6RfG4BoipBe3VEQ"
      } 
    ]
  }
  }
 }
} 

Answer 2

• 在 BIM360 文档管理中获取文档的项路径。

这个问题是关于获取项目的层次结构吗？例如根文件夹>>子文件夹>>项目？使用端点，通过指定查询参数 includePathInProject=true，它将返回项目（pathInProject）在文件夹结构中的相对路径。 https://forge.autodesk.com/en/docs/data/v2/reference/http/projects-project_id-items-item_id-GET/

"data": {
    "type": "items",
    "id": "urn:adsk.wipprod:dm.lineage:xxx",
    "attributes": {
        "displayName": "my-issue-att.png",
        "createTime": "2021-03-12T04:51:01.0000000Z",
        "createUserId": "xxx",
        "createUserName": "Xiaodong Liang",
        "lastModifiedTime": "2021-03-12T04:51:02.0000000Z",
        "lastModifiedUserId": "200902260532621",
        "lastModifiedUserName": "Xiaodong Liang",
        "hidden": false,
        "reserved": false,
        "extension": {
            "type": "items:autodesk.bim360:File",
            "version": "1.0",
            "schema": {
                "href": "https://developer.api.autodesk.com/schema/v1/versions/items:autodesk.bim360:File-1.0"
            },
            "data": {
                "sourceFileName": "my-issue-att.png"
            }
        },
        "pathInProject": "/Project Files"
    }

或者如果您可以通过父级的数据进行迭代

"parent": {
    "data": {
      "type": "folders",
      "id": "urn:adsk.wipprod:fs.folder:co.sdfedf8wef"
    },
    "links": {
      "related": {
        "href": "https://developer.api.autodesk.com/data/v1/projects/b.project.id.xyz/items/urn:adsk.wipprod:dm.lineage:hC6k4hndRWaeIVhIjvHu8w/parent"
      }
    }
  },

• 获取该项目的所有自定义属性。对于请求。 1，存在一个 api 来获取和获取自定义属性，另一个 api 存在并且可以检索数据。有没有办法在一个 api 调用中同时获得这两个要求，而不是使用两个。在大量记录的情况下，检索项目路径的api需要一个多小时才能获取19000+条记录，并且使用刷新令牌时令牌过期，而自定义属性api以50个批次处理数据，在5内完成分钟而已。请提出建议。*

让我试着更好地理解这个问题。首先，有两件事：自定义属性定义和自定义属性值（与文档一起）。你能澄清一下他们有 19000 多条记录吗？

如果自定义属性定义，获取它们的 API 是 https://forge.autodesk.com/en/docs/bim360/v1/reference/http/document-management-custom-attribute-definitions-GET/ 它支持设置每次调用的限制。即一次调用的最大限制是 200，这意味着您可以 95 次获取 19000+ 条记录，而每次调用应该很快（根据我的经验

如果自定义属性值，获取它们的 API 是 https://forge.autodesk.com/en/docs/bim360/v1/reference/http/document-management-versionsbatch-get-POST/ 如您所知，每次 50 条记录。并且似乎只有在获取 19000+ 条记录的值时，5 分钟就可以在您身边相当快？