Freigeben über

Konvertierungstool von Transaction Integrator

  • Artikel

Das Befehlszeilenprogramm TIConversionTool ermöglicht eine schnelle und einfache Migration zum Host Integration Server von HIS 2010, HIS 2009, HIS 2008, HIS 2006 und HIS 2004. Sie können es verwenden, um windowsinitiierte TLBs (WIP) oder hostinitiierte (HIP) und .NET-Assemblys, die in früheren Versionen von HIS erstellt wurden, in Host Integration Server .NET-Assemblys zu konvertieren. Sie können es verwenden, um eine einzelne TLB oder Assembly oder mehrere TLBs oder Assemblys zu konvertieren.

Die TIConversionTool.exe befindet sich in den folgenden Ordnern:

OS Standort
x64 C:\Programme\Microsoft Host Integration Server 2020\SysWOW64\
x86 C:\Programme\Microsoft Host Integration Server 2020\system\

Sie können das Konvertierungsprogramm über die Befehlszeile ausführen oder es über ein anderes Programm wie PowerShell aufrufen. Führen Sie für Verwendungsanweisungen zur Laufzeit TIConversionTool.exe über die Befehlszeile ohne Argumente aus.

Das TIConversion-Tool erzeugt bei Ausführung das folgende Verzeichnis mit demselben Namen wie die assembly oder TLB, die konvertiert wird. In diesem Verzeichnis werden die folgenden Dateien und ein bin-Verzeichnis platziert, das die konvertierte TI-Assembly enthält.

  1. xxxx.asmx : Konfigurationsdatei für die Bereitstellung der TI-Assembly als Webdienst

  2. xxxx.svc: Konfigurationsdatei für die Bereitstellung der TI-Assembly als Wcf-Dienst

  3. xxxx.xsd: Schemadatei für die Verwendung mit dem BizTalk-Hostanwendungsadapter

  4. web.config. WCF: Wcf-Webkonfigurationsdatei für die IIS-Bereitstellung

  5. web.config.WS : asmx-Webkonfigurationsdatei für die II-Bereitstellung

  6. bin/xxxx.dll: Konvertierte TI-Assembly.

    Überlegungen zu TIConversionTool

  • Die TIConversionTool.exe migriert die Kontextschnittstelle zur neuen Kontextschnittstelle, die in Host Integration Server eingeführt wurde.

  • TheTIConversionTool.exe aktualisiert die RE-Klasse nur, wenn die aktuelle RE-Klasse nicht mehr unterstützt wird.

  • Das Hilfsprogramm aktualisiert alte Typbibliotheken und .NET-Assemblys, um mit Host Integration Server zu arbeiten. Nach der Konvertierung wird empfohlen, die Konvertierungen der neuen RE-Konfiguration zuzuordnen. Sie können HIS 2009- und HIS 2010-Konvertierungen vorhandenen HIS-REs oder neuen übereinstimmenden Host Integration Server-REs zuordnen.

  • Beim Konvertieren einer alten Typbibliothek in eine .NET-Assembly konvertiert TI Visual Basic- Version 6.0 Automation-Datentypen in Visual Basic .NET-Typen, wie in der folgenden Tabelle beschrieben.

    Visual Basic v6 Visual Basic .NET
    Integer Short
    Long Integer
    Währung Decimal
    Recordset DataTable
    UDT Struktur

  • Die NewRecordset-Funktion wird in .NET nicht unterstützt. Sie müssen Code in Clientanwendungen ändern, die die NewRecordset-Funktion verwenden, um getrennte Recordsets zu erstellen.

  • Sie müssen vorhandene COM-Clients, die aufgrund von GUID-Änderungen deklarative Bindung verwenden, neu kompilieren.

  • Sie müssen das Importfeature in Designer verwenden, um die TLB- oder .NET-Assembly in den folgenden Fällen zu konvertieren:

    • Ihre Anwendung verwendet Persistenzverbindungen.

    • Sie möchten Features verwenden, die auf dem neuen Modell basieren, z. B. dynamische REs.

    • Die ProgID des TLB ist größer als 39 Zeichen.

  • Die TLB von TI enthielten zwei Schnittstellen für den TI-Kontext, als der tlb so konfiguriert wurde, dass clientContext verwendet werden kann. HIS2020 TI .NET-Assemblys enthalten nur eine einzelne Schnittstelle, wenn sie so konfiguriert sind, dass clientContext verwendet werden kann. Eine Clientanwendung, die einen tlb mit einem direkten Aufrufmodell verwendet, erforderte nicht den in der Parameterliste des TI-Methodenaufrufs definierten Kontextwert. In HIS2020 Nach dem Ausführen des tlb über TIconversiontool.exe wird das Ergebnis durch eine .NET-Assembly ersetzt. Der Kunde muss den Kontextwert in die Parameterliste des TI-Methodenaufrufs einschließen.

    Weitere Informationen finden Sie unter Arbeiten mit TI Designer.

Verbrauch

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

Syntax

/f
Geben Sie bibliotheken an, die konvertiert werden sollen.

/Fl
Geben Sie eine Textdatei an, die eine Liste der zu konvertierenden Bibliotheken enthält.

/O
Geben Sie das Verzeichnis an, das die konvertierten Assemblys enthält.

/L
Geben Sie den Namen der Protokolldatei an.

/d
Geben Sie ein Verzeichnis an, das die zu konvertierenden Bibliotheken enthält.

/Ds
Geben Sie ein Verzeichnis an, das die zu konvertierenden Bibliotheken enthält, einschließlich der Bibliotheken in den Unterverzeichnissen.

/Ow
Überschreiben Sie alle vorhandenen Assemblys.

/Sk
Überspringen Sie Typbibliotheken, deren Ausgabeassemblys bereits vorhanden sind.

/Ol
Überschreiben Sie die Protokolldatei, falls vorhanden.

Beispielverwendung

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

Warnung

Befehlszeilenparameter, die ohne verwendung der oben genannten Flags angegeben werden, werden als zu konvertierende Bibliotheken behandelt.