元素信息抽提与管理

本文介绍了元素信息管理的功能与使用方法。

介绍

针对需要重新进行元素信息抽提的数据，通过元素信息管理模块，可以对元素信息进行生成与管理，包括元素信息的抽提、状态查询、删除。

功能

功能	接口	描述	接口文档
发起BIM元素信息抽提	PUT https://api.bimface.com/feature-management/v1/domain/extraction	针对目标文件及指定业务场景，对元素信息进行抽提操作。	发起元素信息抽提 (opens new window)
查询BIM元素信息抽提状态及列表	POST https://api.bimface.com/feature-management/v1/domain/extraction-states	查询元素信息抽提状态及列表。	查询元素信息抽提 (opens new window)
删除元素信息	DELETE https://api.bimface.com/feature-management/v1/domain/extraction	删除元素信息。	删除元素信息 (opens new window)

常见属性信息

属性	说明
fileId	单模型文件id
integrateId	集成模型文件id
extractType	元素信息抽提类型
pipeSystem	元素信息业务场景：管道分析

使用方法

发起元素信息抽提

目的：

1. 对模型中包含的元素信息，按使用场景分类，进行重新组织，以适配BIMFACE后端提供的计算能力；

使用前提：

1. 有正常可用的BIMFACE账号，并拥有使用元素信息的权限；
2. 准备好了模型，并且模型已经轻量化（转换或集成）成功，可获取fileId、integrateId；
3. 当前模型格式可以适配期望进行的元素信息场景(可参考模块介绍 (opens new window))；

PUT https://api.bimface.com/feature-management/v1/domain/extraction

输入的示例Body参数如下：

{
    "fileId":#your fileId#,
    "extractType":"pipeSystem"
}

查询元素信息状态及列表

目的：

1. 批量查询元素信息抽提状态；
2. 批量查询账号内元素信息的抽提情况；

使用前提：

1. 有正常可用的BIMFACE账号，并拥有使用元素信息的权限；
2. 针对查询元素信息抽提状态的使用场景，应先发起元素信息抽提；

POST https://api.bimface.com/feature-management/v1/domain/extraction-states

输入的示例Body参数如下：

{
    "fileId": 10000026430341,
    // 当不输入projectId时，查找默认项目下的文件元素信息抽提情况
    "projectId":"10000005720505"
}

当status=99时，说明抽提任务已经完成。

进行业务应用

在完成元素信息抽提并成功后，可应用不同模块提供的功能进行业务分析。

管网分析模块可参考：管网分析教程 (opens new window)