Consideraciones sobre la migración en versiones anteriores del procesamiento iniciado por Windows (WIP)
Este tema contiene las secciones siguientes que describen cómo migrar desde versiones anteriores del integrador de transacciones Windows-Initiated procesamiento:
Conversión de bibliotecas de tipos COM
Las bibliotecas de tipos (TLB) ya no se admiten. Debe convertir las bibliotecas de tipos TLB de TI o COMTI existentes en ensamblados .NET de TI y, a continuación, volver a implementarlas.
Hay dos maneras de realizar la conversión:
Se recomienda usar la herramienta de conversión del integrador de transacciones (TIConverionTool.exe). Admite conversiones únicas y por lotes.
Para casos especiales, use la característica de importación de Designer para convertir TLB únicos.
El TIConversionTool.exe es una utilidad de línea de comandos que se puede ejecutar desde el símbolo del sistema o desde otro programa, como PowerShell. El TIConverionTool.exe admite operaciones únicas y por lotes. 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\ |
Para obtener más información sobre la sintaxis de la línea de comandos de la utilidad TIConverionTool, vea Herramienta de conversión del integrador de transacciones.
Una vez completado el proceso de conversión, puede implementar el nuevo objeto .NET mediante los REs existentes en los casos en los que se creó previamente el TLB. Deberá crear un nuevo RE para los TLB creados en versiones anteriores de HIS.
Eliminación de bibliotecas de tipos existentes
Antes de implementar el nuevo ensamblado, debe quitar el TLB existente mediante el Administrador de TI. Hay restricciones más estrictas en la nueva versión de TI, por lo que puede encontrar algunas advertencias o errores si el TLB anterior ha infringido esas restricciones. Por ejemplo, durante el proceso de conversión ADO RecordSets se convertirá en DataTables de .NET. Si el TLB que se va a convertir tiene el mismo nombre tanto para el espacio de nombres como para la interfaz, la herramienta de conversión anexará automáticamente _rename al nombre de la interfaz. Si el ProgID del TLB que se va a convertir tiene más de 39 caracteres de longitud, la herramienta de conversión producirá un error y el TLB no se convertirá. En el caso de los TLB con progID de más de 39 caracteres, debe usar el método Designer / Import para realizar la conversión. La compatibilidad con IMS Implicit y Explicit se ha quitado en la transacción de TI 2010 y los TLB de esos tipos se convertirán en mediante el modelo imS Connect. Para obtener más información, consulte IMS Connect.
Actualización de bibliotecas de tipos mediante el Designer
Puede actualizar las bibliotecas de tipos de una en una mediante la creación de un nuevo ensamblado de .NET con las mismas características. A continuación, puede importar el TLB existente. Si el contexto de cliente se ha habilitado en el TLB, durante el proceso de importación, el TLB se convertirá de la matriz de contexto de cliente de estilo anterior de objetos al nuevo modelo de objetos de contexto de cliente. A continuación, debe modificar la aplicación cliente para que funcione con el nuevo modelo de objetos Context. Este proceso consume mucho tiempo y es propenso a errores y solo se debe usar para los casos no admitidos por la utilidad TIConversionTool. Entre los casos especiales se incluyen los siguientes:
La persistencia Connections requiere que use el modelo de objetos de contexto de cliente o se producirá un error en la llamada. También debe modificar el código de cliente para que funcione con el nuevo modelo de contexto.
TLB con progID de más de 39 caracteres.
Nuevas características habilitadas para el contexto, como REs dinámicos.
Para obtener más información, consulte el tema de ayuda Trabajar con ti Designer.
Actualización de ensamblados .NET
Tiene diferentes opciones en función de la versión que se usó HIS para crear el ensamblado .NET, el modelo de hospedaje (.NET Remoting, Web Service, WCF Service o Direct call) y el modelo de programación. La mayoría de los ensamblados de .NET seguirán funcionando sin cambios. En algunos casos, el ensamblado tendrá que convertirse e implementarse de nuevo. Se recomienda usar la utilidad TIConversionTool.exe que admita la conversión por lotes y única. En el caso de casos especiales, puede usar la característica Designer e Importar para convertir un ensamblado a la vez.
Los ensamblados .NET de HIS no requieren ningún cambio necesario a menos que use el tipo de red LU6.2. En este caso, los ensamblados se deben convertir mediante la utilidad TIConverionTool.exe o mediante la característica Importar del Designer.
IMS Implicit y IMS Explicit ya no se admiten y se convertirán en el modelo de programación imS Connect cuando se conviertan mediante el TIConversionTool.exe. Para obtener más información, consulte IMS Connect.
Implementación de ensamblados convertidos
Una vez completado el proceso de conversión, puede implementar el nuevo objeto .NET mediante el RE existente si se convierte el ensamblado.
Se ha quitado la compatibilidad con el modelo de hospedaje de .NET Remoting. Debe implementar ensamblados de .NET mediante los modelos de hospedaje de WCF o Direct Call.
Actualización de ensamblados mediante el Designer
Use la característica de importación Designer para convertir los ensamblados HIS 2006 y HIS 2004 .NET solo en casos especiales. Si el contexto de cliente se ha habilitado en el ensamblado durante el proceso de importación, se convertirá de la matriz de contexto de cliente de estilo anterior de objetos al nuevo modelo de objetos de contexto de cliente. Debe modificar la aplicación cliente para que funcione con el nuevo modelo de objetos de contexto de cliente. También debe crear una nueva instancia de RE coincidente como parte del proceso de implementación.
La persistencia Connections requiere que use el nuevo modelo de objetos de contexto de cliente o se producirá un error en la llamada. También debe modificar el código de cliente para que funcione con el nuevo modelo de contexto.
Consideraciones adicionales
Cuando se actualiza completamente una biblioteca de tipos o un ensamblado, se pueden actualizar los dos aspectos siguientes de la biblioteca de tipos anterior en función del proceso de actualización que usó.
Clase de entorno remoto.
Información de conversión predeterminada definida en el nivel de biblioteca. Los valores predeterminados para convertir tipos de datos son diferentes en .NET y COM. Para más información, vea Tipos de datos.
En función de sus circunstancias y los requisitos de las aplicaciones, es posible que desee actualizar uno o ambos. En la tabla siguiente se describen las acciones de usuario, las acciones de TI, los resultados y las recomendaciones.
| Acción del usuario | Acciones de TI | Results | Cuándo se usa |
|---|---|---|---|
| Ninguno. Uso de objetos y ENTORNOs de .NET existentes | No se realizan cambios en: - RE - GUID del objeto Ti - Conversiones predeterminadas del ensamblado de .NET |
- El objeto .NET de TI y RE son totalmente funcionales. - Las propiedades de la biblioteca de tipos y RE ya no se pueden modificar. - Los nuevos ensamblados de .NET creados con el proyecto de TI no se pueden asociar a las VERSIONES anteriores. - Los clientes existentes no necesitan modificaciones. - Los TLB COM y los ensamblados LU6.2 de NET no se ejecutarán y se deben convertir mediante TIConverisionTool.exe Utilidad. |
- Actualización inicial desde la versión anterior. Los objetos .NET de TI antiguos y los IDE antiguos funcionan y no es necesario modificarlos. |
| Conversión de TLB y ensamblados de .NET mediante la utilidad TIConversionTool | No se realizan cambios en: - Modelo clientContext - No actualiza la clase Remote Environment |
- Los TLB de tipo antiguo y los ensamblados de .NET se actualizan para que funcionen con versiones más recientes. El ensamblado de .NET actualizado solo se puede asociar a nuevas instancias de RE. Se recomienda que los TLB convertidos y los ensamblados de .NET también se asocie a los IDE. Si migra una biblioteca de tipos anterior a un ensamblado de .NET, TI también migra todos los tipos de datos de Automatización de Visual Basic versión 6.0 a los tipos de datos de .NET de Visual Basic, incluidos: - Entero a Corto - Long to Integer - Moneda a decimal - Conjunto de registros en DataTable - UDT a estructura Las aplicaciones cliente que usan la función NewRecordset para crear conjuntos de registros desconectados deben modificar el código. La función NewRecordset no se admite en .NET. - Los clientes COM existentes que usan el enlace declarativo deben volver a compilarse debido a los cambios de GUID. |
- Migración de TLB de HIS 2009 y ensamblados .NET LU62. - Migración desde HIS 2006 o HIS 2004 TLB y ensamblados de .NET. - Se debe crear un nuevo RE en el entorno de Host Integration Server 2009. - Uso de características de RE. - Traslado al entorno compatible con HIS. - El modelo de programación sigue siendo el mismo. |
| Conversión de TLB y ensamblados de .NET mediante la característica de importación de Designer | - Novedades la clase Entorno remoto. - Genera un nuevo ensamblado de .NET. Usa el nuevo modelo de objetos ClientContext |
La propiedad del método Include Context Parameter se establece automáticamente en True. Si las aplicaciones cliente no necesitan admitir el contexto de cliente y funcionan sin cambios, ya que el contexto de cliente es un parámetro opcional. En el proyecto de TI de Visual Studio, establezca Incluir parámetro de contexto en False en el método . Modelo ClientContext convertido de Matriz de objetos a modelo a Modelo de objetos. La aplicación cliente debe cambiarse para que funcione con el nuevo modelo de objetos es ClientContext habilitado. Si migra una biblioteca de tipos anterior a un ensamblado de .NET, TI también migra todos los tipos de datos de Automatización de Visual Basic versión 6.0 a los tipos de datos de .NET de Visual Basic, incluidos: - Entero a Corto - Long to Integer - Moneda a decimal - Conjunto de registros en DataTable - UDT a estructura Las aplicaciones cliente que usan la función NewRecordset para crear conjuntos de registros desconectados deben modificar el código. La función NewRecordset no se admite en .NET. Los clientes COM existentes que usan el enlace declarativo deben volver a compilarse debido a los cambios de GUID. |
- Creación de una nueva instancia de la aplicación para la operación en paralelo con Host Integration Server 2009 con la intención de extender la aplicación. - Usar nuevas características de contexto de cliente (Seguridad de cliente, Connections persistente, etc.). - Cambio del modelo de programación - Cambio de entorno de destino (CICS, IMS, IBM i) - Cambio de iniciación (WIP, HIP) - Conversión de ensamblados .NET implícitos o IMS explícitos de IMS TLB con progID de más de 39 caracteres. |