Strumento di conversione di Transaction Integrator

  • Articolo

L'utilità da riga di comando TIConversionTool semplifica la migrazione a Host Integration Server da HIS 2010, HIS 2009, HIS 2008, HIS 2006 e HIS 2004. È possibile usarlo per convertire le TLB avviate da finestre (WIP) o gli assembly avviato dall'host (HIP) e .NET creati nelle versioni precedenti di HIS in assembly .NET di Host Integration Server. È possibile usarlo per convertire un singolo TLB o assembly o più TLB o assembly.

La TIConversionTool.exe si trova nelle cartelle seguenti:

OS Posizione
x64 C:\Programmi\Microsoft Host Integration Server 2020\SysWOW64\
x86 C:\Programmi\Microsoft Host Integration Server 2020\system\

È possibile eseguire l'utilità di conversione dalla riga di comando o chiamarla da un altro programma, ad esempio PowerShell. Per istruzioni sull'utilizzo in fase di esecuzione, eseguire TIConversionTool.exe dalla riga di comando senza argomenti.

Lo strumento TIConversion durante l'esecuzione produrrà la directory seguente con lo stesso nome dell'assembly o del TLB in fase di conversione. In tale directory vengono inseriti i file seguenti e una directory bin contenente l'assembly TI convertito.

  1. xxxx.asmx - File di configurazione per la distribuzione di assembly TI come servizio Web

  2. xxxx.svc - File di configurazione per la distribuzione di assembly TI come servizio wcf

  3. xxxx.xsd - File di schema da usare con l'adapter dell'applicazione host BizTalk

  4. web.config. WCF - File di configurazione Web wcf per la distribuzione IIS

  5. web.config.WS - file di configurazione Web asmx per la distribuzione II

  6. bin/xxxx.dll - Assembly TI convertito.

    Considerazioni su TIConversionTool

  • L'TIConversionTool.exe esegue la migrazione dell'interfaccia di contesto alla nuova interfaccia di contesto introdotta in Host Integration Server.

  • TheTIConversionTool.exe aggiornerà la classe RE solo quando la classe RE corrente non è più supportata.

  • L'utilità aggiorna le librerie di tipi precedenti e gli assembly .NET per usare Host Integration Server. Dopo la conversione, è consigliabile associare le conversioni alla nuova configurazione RE. È possibile associare le conversioni HIS 2009 e HIS 2010 alle RE HIS esistenti o alle nuove istanze di Host Integration Server corrispondenti.

  • Quando si converte una libreria di tipi precedenti in un assembly .NET, TI converte i tipi di dati di Automazione di Visual Basic versione 6.0 in tipi di dati .NET di Visual Basic, come descritto nella tabella seguente.

    Visual Basic v6 Visual Basic .NET
    Integer Short
    long Integer
    Valuta Decimal
    recordset DataTable
    UDT Struttura

  • La funzione NewRecordset non è supportata in .NET. È necessario modificare il codice nelle applicazioni client che usano la funzione NewRecordset per creare set di recordset disconnessi.

  • È necessario ricompilare i client COM esistenti che usano l'associazione dichiarativa a causa delle modifiche GUID.

  • È necessario usare la funzionalità Import in Designer per convertire l'assembly TLB o .NET nei casi seguenti:

    • L'applicazione usa connessioni di persistenza.

    • Si vogliono usare le funzionalità che si basano sul nuovo modello, ad esempio RES dinamiche.

    • Il progID del TLB è maggiore di 39 caratteri.

  • I due interfacce di TILB contenuti per il contesto TI quando il tlb è stato configurato per consentire l'uso di clientContext. HIS2020 assembly TI .Net contengono solo un'unica interfaccia quando configurata per consentire l'uso di clientContext. Un'applicazione client che usa un modello tlb con chiamata diretta non richiedeva il valore di contesto definito nell'elenco dei parametri della chiamata al metodo TI. In HIS2020 Dopo aver eseguito il tlb tramite TIconversiontool.exe il risultato verrà sostituito con un assembly .Net. il cliente deve includere il valore di contesto all'interno dell'elenco di parametri della chiamata al metodo TI.

    Per altre informazioni, vedere Uso della Designer TI.

Utilizzo

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

Sintassi

/F
Specificare le librerie da convertire.

/Fl
Specificare un file di testo contenente un elenco di librerie da convertire.

/o
Specificare la directory che conterrà gli assembly convertiti.

/L
Specificare il nome del file di log.

/d
Specificare una directory contenente le librerie da convertire.

/Ds
Specificare una directory contenente le librerie da convertire, incluse quelle nelle sottodirectory.

/Ow
Sovrascrivere tutti gli assembly esistenti.

/Sk
Ignorare le librerie di tipi i cui assembly di output esistono già.

/Ol
Sovrascrivere il file di log se esistente.

Esempio di utilizzo

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

Avviso

I parametri della riga di comando specificati senza usare i flag precedenti vengono considerati come librerie da convertire.