Herramienta de conversión del Integrador de transacciones

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 los TLB iniciados por ventana (WIP) o los ensamblados iniciados por host (HIP) y los ensamblados de .NET creados en versiones anteriores de HIS para Host Integration Server ensamblados de .NET. Puede usarlo para convertir un único TLB o ensamblado, o varios TLB o ensamblados.

El TIConversionTool.exe se encuentra en las carpetas siguientes:

SO Location
x64 C:\Archivos de programa\Microsoft Host Integration Server 2013\SysWOW64\
x86 C:\Archivos de programa\Microsoft Host Integration Server 2013\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 ejecutó producirá el siguiente directorio con el mismo nombre que el ensamblado o TLB que se va a convertir. En ese directorio se colocan los siguientes archivos y un directorio bin que contiene el ensamblado de 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 que se usará 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 ii

  6. bin/xxxx.dll: ensamblado de TI convertido.

    Consideraciones sobre TIConversionTool

  • El TIConversionTool.exe 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 admite 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 convertida, se recomienda asociar las conversiones a la nueva configuración de RE. Puede asociar las HIS 2009 y HIS 2010 con las RE de HIS existentes o con las nuevas Host Integration Server RE.

  • Al convertir una biblioteca de tipos antigua en un ensamblado de .NET, TI convierte los tipos de datos de Automation de la versión 6.0 de Visual Basic en tipos de .NET 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 cambios en el GUID.

  • Debe usar la característica Importar en el Diseñador para convertir el ensamblado de 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 RSE 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. Los ensamblados .NET de TI HIS2013 solo contienen una interfaz única cuando se configuran para permitir el uso de clientContext. Una aplicación cliente que usa un tlb con el modelo de llamada directa no requiere el valor de contexto definido en la lista de parámetros de la llamada al método ti. En HIS2013 Después de ejecutar el tlb hasta TIconversiontool.exe el resultado se reemplazará por un ensamblado .Net. El cliente debe incluir el valor de contexto en 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]]  

Sintaxis

/f
Especifique las bibliotecas que se convertirán.

/fl
Especifique un archivo de texto que contenga una lista de bibliotecas que se va 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 convertirán.

/ds
Especifique un directorio que contenga las bibliotecas que se convertirán, 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.