C#開發BIMFACE系列23 服務端API之擷取模型資料8：擷取模型連結資訊

BIMFACE二次開發

BIMFACE二次開發系列目錄     【已更新最新開發文章，點選檢視詳細】

　　在Revit等BIM設計工具中可以給模型的某個部位添加連結資訊。即類似于在Office Word、Excel 中給一段文字添加本地檔案連結或者網址連結等類似功能。例如下面的一個RVT模型種包含了2個連結。

下面詳細介紹如何擷取單個模型包含的所有連結資訊。

請求位址：GET https://api.bimface.com/data/v2/files/{fileId}/links

說明：擷取一個模型種包含的所有連結資訊

參數：

請求 path(示例)：https://api.bimface.com/data/v2/files/1211223382064960/links

請求 header(示例)："Authorization: Bearer dc671840-bacc-4dc5-a134-97c1918d664b"

HTTP響應示例(200)：

{
  "code" : "success",
  "data" : [ {
    "guid" : "ffb665b7-067f-4cd6-b080-214e96db0f73-00058185",
    "id" : 0,
    "name" : "file_link.rvt : 12 : loc <not shared>",
    "transform" : ""
  } ],
  "message" : ""
}      

傳回的結果封裝成 SingleModelLink 類

/// <summary>
///  擷取單個模型的連結資訊傳回的結果類
/// </summary>
[Serializable]
public class SingleModelLink : GeneralResponse<List<Link>>
{

}      

[Serializable]
public class Link
{
    [JsonProperty("guid")]
    public string Guid { get; set; }

    [JsonProperty("id")]
    public long? Id { get; set; }

    /// <summary>
    ///  樣例 : "file_link.rvt : 12 
    /// </summary>
    [JsonProperty("name")]
    public string Name { get; set; }

    [JsonProperty("transform")]
    public string Transform { get; set; }

    /// <summary>傳回表示目前對象的字元串。</summary>
    /// <returns>表示目前對象的字元串。</returns>
    public override string ToString()
    {
        return String.Format("[Link guid={0}, id={1}, name={2},transform={3}]",
                             Guid, Id, Name, Transform);
    }
}      

C#實作方法：

1 /// <summary>
 2 ///  擷取單個模型的樓層資訊
 3 /// </summary>
 4 /// <param name="accessToken">【必填】令牌</param>
 5 /// <param name="fileId">【必填】代表該單模型的檔案ID</param>
 6 /// <returns></returns>
 7 public virtual SingleModelLink GetSingleModelLink(string accessToken, long fileId)
 8 {
 9     // GET https://api.bimface.com/data/v2/files/{fileId}/links
10     string url = string.Format(BimfaceConstants.API_HOST + "/data/v2/files/{0}/links", fileId);
11 
12     BimFaceHttpHeaders headers = new BimFaceHttpHeaders();
13     headers.AddOAuth2Header(accessToken);
14 
15     try
16     {
17         SingleModelLink response;
18 
19         HttpManager httpManager = new HttpManager(headers);
20         HttpResult httpResult = httpManager.Get(url);
21         if (httpResult.Status == HttpResult.STATUS_SUCCESS)
22         {
23             response = httpResult.Text.DeserializeJsonToObject<SingleModelLink>();
24         }
25         else
26         {
27             response = new SingleModelLink
28             {
29                 Message = httpResult.RefText
30             };
31         }
32 
33         return response;
34     }
35     catch (Exception ex)
36     {
37         throw new Exception("[擷取模型連結資訊]發生異常！", ex);
38     }
39 }      

其中調用到的 httpManager.Get() 方法，請參考《C# HTTP系列》

測試

在BIMFACE的控制台中可以看到我們上傳的檔案清單，模型狀态均為轉換成功。

 以模型 “A4.rvt” 為例測試上述的方法

查詢到了2條連結資訊，與文章開始處的源檔案中的連結資訊對應。

并不是所有的模型中都包含連結資訊，如果不包含，則傳回 null

測試代碼如下：

1 // 擷取單模型連結資訊
 2 protected void btnGetSingleModelLink_Click(object sender, EventArgs e)
 3 {
 4     long fileId = txtFileID.Text.Trim().ToLong();
 5     FileConvertApi api = new FileConvertApi();
 6     SingleModelLink response = api.GetSingleModelLink(txtAccessToken.Text, fileId);
 7 
 8     StringBuilder sb = new StringBuilder();
 9     if (response.Data != null)
10     {
11         List<Link> lstLink = response.Data;
12         foreach (var link in lstLink)
13         {
14             sb.AppendLine(link.ToString());
15         }
16     }
17 
18     txtResult.Text = response.Code.ToString2()
19                    + Environment.NewLine
20                    + response.Message.ToString2()
21                    + Environment.NewLine
22                    + sb;
23 }      

成在管理，敗在經驗；嬴在選擇，輸在不學！  貴在堅持！

歡迎關注作者頭條号 張傳甯IT講堂，擷取更多IT文章、視訊等優質内容。

個人作品

1、BIMFace.Community.SDK.NET

     開源位址：https://gitee.com/NAlps/BIMFace.SDK

     系列部落格：https://www.cnblogs.com/SavionZhang/p/11424431.html

     系列視訊：https://www.cnblogs.com/SavionZhang/p/14258393.html

2、ZCN.NET.Common

     開源位址：https://gitee.com/NAlps/zcn.net.common

技術棧

 1、Visual Studio、.C#/.NET、.NET Core、MVC、Web API、RESTful API、gRPC、SignalR、Python

 2、jQuery、Vue.js、Bootstrap

 3、資料庫：SQLServer、MySQL、PostgreSQL、Oracle、SQLite、Redis、MongoDB、ElasticSearch、TiDB、達夢DM、人大金倉、 神通、南大通用 GBase、華為 GaussDB 、騰訊 TDSQL 、阿裡 PolarDB、螞蟻金服 OceanBase、東軟 OpenBASE、浪潮雲溪資料庫 ZNBase

 4、ORM：Dapper、Entity Framework、FreeSql、SqlSugar、分庫分表、讀寫分離

 5、架構：領域驅動設計 DDD、ABP

 6、環境：跨平台、Windows、Linux（CentOS、麒麟、統信UOS、深度Linux）、maxOS、IIS、Nginx、Apach

 7、移動App：Android、IOS、HarmonyOS、微信、小程式、快應用、Xamarin、uni-app、MUI、Flutter、Framework7、Cordova、Ionic、React Native、Taro、NutUI、Smobiler

 雲原生、微服務、Docker、CI/CD、DevOps、K8S；

 Dapr、RabbitMQ、Kafka、分布式、大資料、高并發、負載均衡、中間件、RPC、ELK；

 .NET + Docker + jenkins + Github + Harbor + K8S；

出處：www.cnblogs.com/SavionZhang

作者：張傳甯   微軟MCP、系統架構設計師、系統內建項目管理工程師、科技部創新工程師。

          專注于微軟.NET技術(.NET Core、Web、MVC、WinForm、WPF)、通用權限管理系統、工作流引擎、自動化項目(代碼)生成器、SOA 、DDD、 雲原生(Docker、微服務、DevOps、CI/CD）；PDF、CAD、BIM 審圖等研究與應用。

          多次參與電子政務、圖書教育、生産制造等企業級大型項目研發與管理工作。

          熟悉中小企業軟體開發過程：需求分析、架構設計、編碼測試、實施部署、項目管理。通過技術與管理幫助中小企業快速化實作網際網路技術全流程解決方案。

本文版權歸作者和部落格園共有，歡迎轉載，但未經作者同意必須保留此段聲明，且在文章頁面明顯位置給出原文連接配接，否則保留追究法律責任的權利。

如有問題，可以通過郵件[email protected]聯系。共同交流、互相學習。

如果您覺得文章對您有幫助，請點選文章右下角【推薦】。您的鼓勵是作者持續創作的最大動力！