トランザクション インテグレーター変換ツール

  • [アーティクル]

TIConversionTool コマンドライン ユーティリティを使用すると、HIS 2010、HIS 2009、HIS 2008、HIS 2006、HIS 2004 からホスト統合サーバーにすばやく簡単に移行できます。 これを使用して、以前のバージョンの HIS で作成されたウィンドウ開始 (WIP) またはホスト開始 (HIP) TLV および .NET アセンブリを Host Integration Server .NET アセンブリに変換できます。 これを使用して、1 つの TLB またはアセンブリ、または複数の TLB またはアセンブリを変換できます。

TIConversionTool.exe は、次のフォルダーにあります。

OS 場所
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 アセンブリを Web サービスとしてデプロイするための構成ファイル

  2. xxxx.svc - WCF サービスとして TI アセンブリをデプロイするための構成ファイル

  3. xxxx.xsd - BizTalk ホスト アプリケーション アダプターで使用する のスキーマ ファイル

  4. web.config。WCF - IIS 展開用の WCF Web 構成ファイル

  5. web.config.WS - II デプロイ用の asmx Web 構成ファイル

  6. bin/xxxx.dll - 変換された TI アセンブリ。

    TIConversionTool に関する考慮事項

  • TIConversionTool.exe は、Host Integration Server で導入された新しいコンテキスト インターフェイスにコンテキスト インターフェイスを移行します。

  • TheTIConversionTool.exe は、現在の RE クラスがサポートされなくなった場合にのみ RE クラスを更新します。

  • このユーティリティは、Host Integration Server と連携するように、古いタイプ ライブラリと .NET アセンブリを更新します。 変換が完了したら、変換を新しい RE 構成に関連付けすることをお勧めします。 HIS 2009 と HIS 2010 の変換を既存の HIS RU に関連付けるか、新しい一致するホスト統合サーバーの RU に関連付けることができます。

  • 古いタイプ ライブラリを .NET アセンブリに変換する場合、TI は次の表で説明するように Visual Basic バージョン 6.0 Automation データ型を Visual Basic .NET 型に変換します。

    Visual Basic v6 Visual Basic .NET
    Integer Short
    Long 整数型
    Currency Decimal
    レコードセット DataTable
    UDT 構造体

  • NewRecordset 関数は、.NET ではサポートされていません。 切断されたレコードセットを作成するには、 NewRecordset 関数を使用するクライアント アプリケーションのコードを変更する必要があります。

  • GUID の変更により宣言型バインディングを使用する既存の COM クライアントを再コンパイルする必要があります。

  • 次の場合は、Designerのインポート機能を使用して TLB または .NET アセンブリを変換する必要があります。

    • アプリケーションは永続化接続を使用します。

    • 動的な RU など、新しいモデルに依存する機能を使用する必要があります。

    • TLB の ProgID が 39 文字を超えています。

  • TI TLB には、tlb が clientContext の使用を許可するように構成されている場合、TI コンテキスト用の 2 つのインターフェイスが含まれていました。 HIS2020 TI .Net アセンブリには、clientContext の使用を許可するように構成されている場合、1 つのインターフェイスのみが含まれます。 直接呼び出しモデルで tlb を使用するクライアント アプリケーションでは、TI メソッド呼び出しのパラメーター リスト内で定義されたコンテキスト値は必要ありませんでした。 HIS2020 TIconversiontool.exe を介して tlb を実行した後、結果は .Net アセンブリに置き換えられます。 顧客は、TI メソッド呼び出しのパラメーター リスト内にコンテキスト値を含める必要があります。

    詳細については、「TI Designerの操作」を参照してください。

使用

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

構文

/f
変換するライブラリを指定します。

/階
変換するライブラリのリストを含むテキスト ファイルを指定します。

/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

警告

上記のフラグを使用せずに指定されたコマンド ライン パラメーターは、変換するライブラリとして扱われます。