Herramienta de conversión del Integrador de transacciones

  • Artículo

La utilidad de línea de comandos TIConversionTool facilita la migración a Host Integration Server desde HIS 2010, HIS 2009, HIS 2008, HIS 2006 y HIS 2004. Puede usarlo para convertir TLB iniciados por ventanas (WIP) o ensamblados iniciados por host (HIP) y ensamblados de .NET creados en versiones anteriores de HIS a ensamblados .NET de Host Integration Server. Puede usarlo para convertir un único TLB o ensamblado, o varios TLB o ensamblados.

El TIConversionTool.exe se encuentra en las siguientes carpetas:

SO Location
x64 C:\Archivos de programa\Microsoft Host Integration Server 2020\SysWOW64\
x86 C:\Archivos de programa\Microsoft Host Integration Server 2020\system\

Puede ejecutar la utilidad de conversión desde la línea de comandos o llamarla desde otro programa como PowerShell. Para obtener instrucciones de uso en tiempo de ejecución, ejecute TIConversionTool.exe desde la línea de comandos sin argumentos.

La herramienta TIConversion cuando se ejecuta producirá el siguiente directorio con el mismo nombre que el ensamblado o el TLB que se va a convertir. En ese directorio se colocan los siguientes archivos y un directorio bin que contiene el ensamblado ti convertido.

  1. xxxx.asmx: archivo de configuración para implementar el ensamblado de TI como servicio web

  2. xxxx.svc: archivo de configuración para implementar el ensamblado de TI como un servicio wcf

  3. xxxx.xsd: archivo de esquema para su uso con el adaptador de aplicación host de BizTalk

  4. web.config. WCF: archivo de configuración web wcf para la implementación de IIS

  5. web.config.WS: archivo de configuración web asmx para la implementación de II

  6. bin/xxxx.dll: ensamblado ti convertido.

    Consideraciones sobre TIConversionTool

  • El TIConversionTool.exe migra la interfaz de contexto a la nueva interfaz de contexto introducida en Host Integration Server.

  • TheTIConversionTool.exe actualizará la clase RE solo cuando ya no se admita la clase RE actual.

  • La utilidad actualiza las bibliotecas de tipos antiguas y los ensamblados de .NET para que funcionen con Host Integration Server. Una vez convertido, se recomienda asociar las conversiones a la nueva configuración de RE. Puede asociar las conversiones his 2009 y HIS 2010 con las RES de HIS existentes o con las nuevas Res de Host Integration Server coincidentes.

  • Al convertir una biblioteca de tipos antigua en un ensamblado de .NET, TI convierte los tipos de datos de Automatización de Visual Basic versión 6.0 en tipos de .NET de Visual Basic, como se describe en la tabla siguiente.

    Visual Basic v6 Visual Basic .NET
    Entero Short
    long Entero
    Moneda Decimal
    Recordset DataTable
    UDT Estructura

  • La función NewRecordset no se admite en .NET. Debe modificar el código en las aplicaciones cliente que usan la función NewRecordset para crear conjuntos de registros desconectados.

  • Debe volver a compilar los clientes COM existentes que usan el enlace declarativo debido a los cambios de GUID.

  • Debe usar la característica Importar en Designer para convertir el ensamblado TLB o .NET en los casos siguientes:

    • La aplicación usa conexiones de persistencia.

    • Quiere usar características que se basan en el nuevo modelo, como los RE dinámicos.

    • El ProgID del TLB tiene más de 39 caracteres.

  • El TLB de TI contenía dos interfaces para el contexto de TI cuando se configuró el tlb para permitir el uso de clientContext. HIS2020 ensamblados .Net de TI solo contienen una única interfaz cuando se configura para permitir el uso de clientContext. Una aplicación cliente que usa un tlb con el modelo de llamada directa no requería el valor de contexto definido dentro de la lista de parámetros de la llamada al método ti. En HIS2020 Después de ejecutar el tlb a través de TIconversiontool.exe el resultado se reemplazará por un ensamblado de .Net. el cliente debe incluir el valor de contexto dentro de la lista de parámetros de la llamada al método ti.

    Para obtener más información, vea Trabajar con ti Designer.

Uso

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

Syntax

/f
Especifique las bibliotecas que se van a convertir.

/Fl
Especifique un archivo de texto que contenga una lista de bibliotecas que se van a convertir.

/o
Especifique el directorio que contendrá los ensamblados convertidos.

/L
Especifique el nombre del archivo de registro.

/d
Especifique un directorio que contenga las bibliotecas que se van a convertir.

/ds
Especifique un directorio que contenga las bibliotecas que se van a convertir, incluidas las de los subdirectorios.

/Ow
Sobrescriba todos los ensamblados existentes.

/Sk
Omita las bibliotecas de tipos cuyos ensamblados de salida ya existen.

/Ol
Sobrescriba el archivo de registro si existe.

Ejemplo de uso

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

Advertencia

Los parámetros de línea de comandos especificados sin usar las marcas anteriores se tratan como bibliotecas que se van a convertir.