Konvertierungstool für Transaktionsintegrator

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

Die TIConversionTool.exe befindet sich in den folgenden Ordnern:

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

Das TIConversion-Tool, wenn ausgeführt wird, erzeugt 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, das die konvertierte TI-Assembly enthält, platziert.

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 BizTalk Host Application Adapter

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 zu der 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 für die Arbeit mit hostintegrationsserver. Nach der Konvertierung wird empfohlen, dass die Konvertierungen der neuen RE-Konfiguration zugeordnet werden. Sie können HIS 2009- und HIS 2010-Konvertierungen vorhandenen HIS-REs oder neuen übereinstimmenden Hostintegrationsserver-REs zuordnen.

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

  Visual Basic v6	Visual Basic .NET
  Integer	Kurz
  Lang	Integer
  Währungen	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 neu kompilieren, die deklarative Bindung aufgrund von GUID-Änderungen verwenden.

• 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 der TLB ist größer als 39 Zeichen.

• Die TLB enthielt zwei Schnittstellen für den TI-Kontext, als die tlb so konfiguriert wurde, dass clientContext verwendet werden kann. HIS2020 TI .Net-Assemblys enthalten nur eine einzige Schnittstelle, wenn sie für die Verwendung von clientContext konfiguriert ist. Eine Clientanwendung, die eine tlb mit dem direkten Aufrufmodell verwendet, erforderte nicht den Kontextwert, der in der Parameterliste des TI-Methodenaufrufs definiert ist. In HIS2020 Nach ausführung der tlb durch TIconversiontool.exe wird das Ergebnis durch eine .Net-Assembly ersetzt. der Kunde muss den Kontextwert in der Parameterliste des TI-Methodenaufrufs enthalten.

  Weitere Informationen finden Sie unter "Arbeiten mit TI Designer".

Verwendung

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 derjenigen in den Unterverzeichnissen.

/Ow
Überschreiben Sie alle vorhandenen Assemblys.

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

/Ol
Überschreiben Sie ggf. die Protokolldatei.

Beispiel für die Verwendung

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