交易整合器轉換工具

TIConversionTool 命令列工具讓從 HIS 2010、HIS 2009、HIS 2008、HIS 2006 和 HIS 2004 快速且輕鬆地遷移到主機整合伺服器。 你可以用它將早期 HIS 版本中建立的 Windows Initiated（WIP）或 Host Initiated（HIP）TLB 及 .NET 組件轉換成 Host Integration Server 的 .NET 組件。 你可以用它轉換單一 TLB 或組件，或多個 TLB 或組件。

該 TIConversionTool.exe 位於以下資料夾中：

作業系統 地點
x64 C：\Program Files\Microsoft Host Integration Server 2020\SysWOW64\
x86 C：\Program Files\Microsoft Host Integration Server 2020\system\

你可以從命令列執行轉換工具，或是用其他程式（例如 PowerShell）呼叫它。 執行時的使用指令，請從命令列執行 TIConversionTool.exe，且不需參數。

執行 TIConversion 工具時，會產生一個與正在轉換的組合語言或 TLB 名稱相同的目錄。 在該目錄中放置以下檔案及包含轉換後 TI 組合語言的 bin 目錄。

  1. xxxx.asmx - 用於部署 TI 組合語言作為網路服務的設定檔

  2. xxxx.svc - 用於部署 TI assembly 作為 WCF 服務的設定檔

  3. xxxx.xsd - 用於 BizTalk 主機應用程式介面卡的結構檔案

  4. web.config。WCF - 用於 IIS 部署的 WCF 網頁設定檔

  5. web.config。WS - 用於 II 部署的 asmx 網頁設定檔

  6. bin/xxxx.dll - 轉換後的 TI 組件。

    TIConversionTool 考量

  • TIConversionTool.exe 將情境介面遷移至主機整合伺服器（Host Integration Server）引入的新情境介面。

  • TheTIConversionTool.exe 只會在現有的RE類別不再支援時更新。

  • 該工具會更新舊型態函式庫與 .NET 組件，使其能與 Host Integration Server 相容。 轉換完成後，我們建議將轉換與新的 RE 配置綁定。 你可以將 HIS 2009 和 HIS 2010 的轉換與現有的 HIS RE，或新的匹配主機整合伺服器 RE 關聯起來。

  • 當將舊型別函式庫轉換成 .NET 組合語言時，TI 會將 Visual Basic 6.0 版自動化資料型態轉換為 Visual Basic .NET 型別，詳見下表。

    Visual Basic v6 Visual Basic .NET
    整數 短
    長 整數
    貨幣 十進制
    Recordset DataTable
    UDT 結構

  • NewRecordset 函式在 .NET 中不被支援。 您必須在使用 NewRecordset 函式的用戶端應用程式中修改程式碼，以建立不連通的記錄集。

  • 由於 GUID 變更，您必須重新編譯使用宣告式綁定的現有 COM 用戶端。

  • 在以下情況下，您必須使用 Designer 的匯入功能來轉換 TLB 或 .NET 組合語言：

    • 你的應用程式使用持久連線。

    • 你要使用依賴新模型的功能，例如動態 RE。

    • TLB 的進度大於 39 個字元。

  • TI TLB 在設定允許使用 clientContext 時，包含兩個 TI 上下文介面。 HIS2020 TI .Net 組件在設定允許使用 clientContext 時，僅包含單一介面。 使用直接呼叫模型的 TLB 客戶端應用程式不需要 TI 方法呼叫參數列表中定義的上下文值。 在 HIS2020 將 TLB TIconversiontool.exe 執行後，結果會被 .Net assembly 取代。 客戶必須在 TI 方法呼叫的參數清單中包含上下文值。

    更多資訊請參閱 「使用 TI Designer」。

使用方式

TIConversionTool [[/f] libraryname1 [libraryname1 ...] [/o outputdir] [/fl fileList1 [fileList2 ...]] [/l logFile]]

語法

/f
指定要轉換的函式庫。

/fl
指定一個包含要轉換函式庫清單的文字檔。

/o
指定將包含轉換後組裝的目錄。

/l
請指定日誌檔名稱。

/d
指定一個包含待轉換函式庫的目錄。

/ds
指定一個目錄，包含待轉換的函式庫，包括子目錄中的函式庫。

/哎呦
覆寫所有現有的組件。

/sk
跳過已經存在輸出組件的類型函式庫。

/ol
如果存在的話，會覆寫日誌檔案。

範例使用方式

TIConversionTool /f c:\temp\ComClnt1.tlb  

TIConversionTool /f c:\temp\NetClnt1.dll /o c:\output  

TIConversionTool /f c:\temp\NetClnt1.dll NetClnt2.dll  

TIConversionTool /f c:\temp\NetClnt1.dll NetClnt1.dll /o c:\output  

TIConversionTool /fl fileList.txt  

TIConversionTool /fl fileList.txt /l fileList.log  

TIConversionTool /fl fileList.txt /o c:\output

警告

未使用上述旗標而指定的命令列參數，則視為待轉換的函式庫。

  • 上次更新時間：