交易整合器轉換工具

TIConversionTool 命令列公用程式可讓您快速且輕鬆地從 HIS 2010、HIS 2009、HIS 2008、HIS 2006 和 HIS 2004 遷移至 Host Integration Server。 您可以使用它來轉換視窗起始的 (WIP) 或在舊版 HIS 中建立的主控制項 (HIP) TLBs 和 .net 元件,以 Host Integration Server .net 元件。 您可以使用它來轉換單一 TLB 或元件,或多個 TLBs 或元件。

TIConversionTool.exe 位於下列資料夾:

OS 位置
x64 C:\Program Files\Microsoft Host Integration Server 2013 \ SysWOW64 \
x86 C:\Program Files\Microsoft Host Integration Server 2013 \ 系統 \

您可以從命令列執行轉換公用程式,或從另一個程式(例如 PowerShell)進行呼叫。 如需執行時間的使用指示,請從命令列執行 TIConversionTool.exe,但不含引數。

執行 TIConversion 工具時,會產生下列目錄,其名稱與要轉換的元件或 TLB 名稱相同。 在該目錄中,會放置下列檔案和包含已轉換之 TI 元件的 bin 目錄。

  1. xxxx-將 TI 元件部署為 web 服務的設定檔案

  2. xxxx-將 TI 元件部署為 wcf 服務的設定檔案

  3. 用於 BizTalk 主控制項應用程式介面卡的 xxxx .xsd 架構檔案

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

  5. web.config 適用于 II 部署的 WS-.asmx web 設定檔

  6. bin/xxxx.dll 轉換的 TI 元件。

    TIConversionTool 考慮

  • TIConversionTool.exe 會將內容介面遷移到 Host Integration Server 引進的新內容介面。

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

  • 此公用程式會更新舊類型程式庫和 .NET 元件,以搭配 Host Integration Server 使用。 轉換之後,建議您將轉換與新的重新設定相關聯。 您可以使用現有的 HIS res 或新的相符 Host Integration Server REs,將 HIS 2009 和 HIS 2010 轉換產生關聯。

  • 將舊類型程式庫轉換成 .net 元件時,TI 會將 Visual Basic 版本 6.0 Automation 資料類型轉換成 Visual Basic .net 類型,如下表所述。

    Visual Basic v6 Visual Basic .NET
    整數 Short
    long 整數
    貨幣 Decimal
    資料錄集 DataTable
    UDT 結構
  • .NET 不支援 NewRecordset 函數。 您必須在使用 NewRecordset 函式的用戶端應用程式中修改程式碼,以建立已中斷連線的記錄集。

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

  • 在下列情況下,您必須使用 [設計工具] 中的 [匯入] 功能來轉換 TLB 或 .NET 元件:

    • 您的應用程式會使用持續性連接。

    • 您想要使用依賴新模型的功能,例如動態 REs。

    • TLB 的 ProgID 大於39個字元。

  • 當 tlb 設定為允許使用 clientCoNtext 時,TI TLB 會包含兩個 TI 內容的介面。 HIS2013 TI .Net 元件在設定為允許使用 clientCoNtext 時,只會包含單一介面。 使用具有直接呼叫模型之 tlb 的用戶端應用程式,不需要在 TI 方法呼叫的參數清單中定義內容值。 在 HIS2013 透過 TIconversiontool.exe 執行 tlb 之後,結果會被 .Net 元件取代。 客戶必須在 TI 方法呼叫的參數清單中包含內容值。

    如需詳細資訊,請參閱 使用 TI 設計工具。

使用方式

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

語法

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

/fl
指定包含要轉換之程式庫清單的文字檔。

/o
指定將包含已轉換元件的目錄。

/l
指定記錄檔名稱。

/d
指定包含要轉換之程式庫的目錄。

/ds
指定包含要轉換之程式庫的目錄,包括子目錄中的程式庫。

/ow
覆寫所有現有的元件。

/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  

警告

未使用上述旗標所指定的命令列參數,會被視為要轉換的程式庫。