Considérations sur la migration pour les versions antérieures de WIP (Windows-Initiated Processing )
Cette rubrique contient les sections suivantes qui décrivent comment migrer à partir de versions antérieures de Transaction Integrator Windows-Initiated traitement :
Conversion de bibliothèques de types COM
Les bibliothèques de types (TLB) ne sont plus prises en charge. Vous devez convertir toutes les bibliothèques de types COMTI ou TI TLB existantes en assemblys TI .NET, puis les redéployer.
Il existe deux façons d’effectuer la conversion :
Nous vous recommandons d’utiliser l’outil de conversion d’intégrateur de transactions (TIConverionTool.exe). Il prend en charge les conversions uniques et par lots.
Pour les cas spéciaux, utilisez la fonctionnalité d’importation Designer pour convertir des TLB uniques.
Le TIConversionTool.exe est un utilitaire de ligne de commande qui peut être exécuté à partir de l’invite de commandes ou appelé à partir d’un autre programme, tel que PowerShell. Le TIConverionTool.exe prend en charge les opérations uniques et par lots. Le TIConversionTool.exe se trouve dans les dossiers suivants :
| Système d''exploitation | Emplacement |
|---|---|
| x64 | C :\Program Files\Microsoft Host Integration Server 2020\SysWOW64\ |
| x86 | C :\Program Files\Microsoft Host Integration Server 2020\system\ |
Pour plus d’informations sur la syntaxe de ligne de commande de l’utilitaire TIConverionTool, consultez Outil de conversion d’intégrateur de transactions.
Une fois le processus de conversion terminé, vous pouvez déployer le nouvel objet .NET à l’aide des unités de requête existantes dans les cas où le TLB en cours de conversion a été créé précédemment. Vous devez créer une nouvelle re pour les TLB créées dans les versions antérieures de HIS.
Suppression des bibliothèques de types existantes
Avant de déployer le nouvel assembly, vous devez supprimer l’équilibrage de charge TLB existant à l’aide de TI Manager. Il existe des contraintes plus strictes dans la nouvelle version de TI. Vous pouvez donc rencontrer des avertissements ou des erreurs si l’ancien TLB a violé ces contraintes. Par exemple, pendant le processus de conversion, ADO RecordSets sera converti en .NET DataTables. Si le TLB en cours de conversion porte le même nom pour l’espace de noms et l’interface, l’outil de conversion ajoute automatiquement _rename au nom de l’interface. Si le ProgID du TLB en cours de conversion est de plus de 39 caractères, une erreur est générée par l’outil de conversion et l’équilibrage de charge TLB n’est pas converti. Pour les TLB avec des progID de plus de 39 caractères, vous devez utiliser la méthode Designer/ Import pour effectuer la conversion. La prise en charge d’IMS Implicite et Explicite a été supprimée dans la transaction TI 2010 et les TLB de ces types seront convertis à l’aide du modèle IMS Connect. Pour plus d’informations, consultez IMS Connect.
Mise à niveau des bibliothèques de types à l’aide du Designer
Vous pouvez mettre à niveau vos bibliothèques de types une par une en créant un assembly .NET avec les mêmes caractéristiques. Vous pouvez ensuite importer l’équilibrage de charge TLB existant. Si le contexte client a été activé dans l’équilibrage de charge du client, au cours du processus d’importation, l’équilibrage de charge du client sera converti du tableau d’objets Contexte client de style ancien en nouveau modèle objet contexte client. Vous devez ensuite modifier l’application cliente pour qu’elle fonctionne avec le nouveau modèle objet Context. Ce processus prend beaucoup de temps et est sujet aux erreurs, et ne doit être utilisé que pour les cas non pris en charge par l’utilitaire TIConversionTool. Les cas spéciaux sont les suivants :
La persistance Connections vous oblige à utiliser le modèle objet Contexte client, sinon l’appel échoue. Vous devez également modifier le code client pour qu’il fonctionne avec le nouveau modèle de contexte.
TLB avec des progID de plus de 39 caractères.
Nouvelles fonctionnalités contextuelles, telles que les ER dynamiques.
Pour plus d’informations, consultez la rubrique d’aide Utilisation des Designer TI.
Mise à niveau des assemblys .NET
Vous disposez d’options différentes en fonction de la version HIS utilisée pour créer l’assembly .NET, le modèle d’hébergement (remoting.NET, service Web, service WCF ou appel direct) et le modèle de programmation. La plupart des assemblys .NET continueront à fonctionner sans aucune modification. Dans certains cas, l’assembly doit être converti et redéployé. Nous vous recommandons d’utiliser l’utilitaire TIConversionTool.exe qui prend en charge la conversion unique et la conversion par lots. Pour les cas spéciaux, vous pouvez utiliser la fonctionnalité Designer et Importer pour convertir un assembly à la fois.
Les assemblys .NET HIS ne nécessitent aucune modification nécessaire, sauf si vous utilisez le type réseau LU6.2. Dans ce cas, les assemblys doivent être convertis à l’aide de l’utilitaire TIConverionTool.exe ou à l’aide de la fonctionnalité Importer dans le Designer.
IMS Implicit et IMS Explicit ne sont plus pris en charge et seront convertis en modèle de programmation IMS Connect lorsqu’ils sont convertis à l’aide du TIConversionTool.exe. Pour plus d’informations, consultez IMS Connect.
Déploiement d’assemblys convertis
Une fois le processus de conversion terminé, vous pouvez déployer le nouvel objet .NET à l’aide du RE existant si l’assembly en cours de conversion.
La prise en charge du modèle d’hébergement .NET Remoting est supprimée. Vous devez déployer des assemblys .NET à l’aide des modèles d’hébergement WCF ou Direct Call.
Mise à niveau d’assemblys à l’aide du Designer
Utilisez la fonctionnalité d’importation Designer pour convertir vos assemblys .NET HIS 2006 et HIS 2004 uniquement dans des cas spéciaux. Si le contexte client a été activé dans l’assembly pendant le processus d’importation, il est converti à partir de l’ancien tableau de contexte client d’objets en nouveau modèle objet contexte client. Vous devez modifier l’application cliente pour qu’elle fonctionne avec le nouveau modèle objet Contexte client. Vous devez également créer un re correspondant dans le cadre du processus de déploiement.
La persistance Connections vous oblige à utiliser le nouveau modèle objet contexte client, sinon l’appel échoue. Vous devez également modifier le code client pour qu’il fonctionne avec le nouveau modèle de contexte.
Considérations supplémentaires
Lorsqu’une bibliothèque de types ou un assembly est entièrement mis à niveau, les deux aspects suivants de l’ancienne bibliothèque de types peuvent être mis à jour en fonction du processus de mise à niveau que vous avez utilisé.
Classe d’environnement distante.
Informations de conversion par défaut définies au niveau de la bibliothèque. Les valeurs par défaut pour la conversion des types de données sont différentes dans .NET et COM. Pour plus d’informations, consultez Types de données.
En fonction de votre situation et des exigences de vos applications, vous pouvez mettre à jour l’une ou les deux. Le tableau suivant décrit les actions utilisateur, les actions TI, les résultats et les recommandations.
| Action de l'utilisateur | TI Actions | Résultats | Quand l’utiliser |
|---|---|---|---|
| Aucun. Utiliser un objet .NET et des unités de recherche existants | Aucune modification n’est apportée à : -RE - GUID d’objet Ti - Conversions par défaut de l’assembly .NET |
- L’objet .NET TI et RE sont entièrement fonctionnels. - Les propriétés dans la bibliothèque de types et RE ne peuvent plus être modifiées. - Les nouveaux assemblys .NET créés avec TI Project ne peuvent pas être associés à d’anciens RE. - Les clients existants n’ont pas besoin de modifications. - Les assemblys COM TLBs et NET LU6.2 ne s’exécutent pas et doivent être convertis à l’aide de TIConverisionTool.exe Utility. |
- Mise à niveau initiale en place à partir de la version précédente. Les anciens objets .NET TI et les anciennes unités de recherche fonctionnent et n’ont pas besoin d’être modifiés. |
| Convertir des assemblys TLB et .NET à l’aide de l’utilitaire TIConversionTool | Aucune modification n’est apportée à : - Modèle ClientContext - Ne met pas à jour la classe Remote Environment |
- Les anciens types de TLB et les assemblys .NET sont mis à jour pour fonctionner avec des versions plus récentes. L’assembly .NET mis à jour ne peut être associé qu’aux nouvelles unités de requête. Il est recommandé d’associer également des TLB et des assemblys .NET convertis à des unités de requête. Si vous migrez une ancienne bibliothèque de types vers un assembly .NET, TI migre également tous les types de données Automation Visual Basic version 6.0 vers les types de données Visual Basic .NET, notamment : - Entier à Court - Long à Entier - Devise en décimal - Recordset to DataTable - UDT vers Structure Les applications clientes qui utilisent la fonction NewRecordset pour créer des recordsets déconnectés doivent modifier le code. La fonction NewRecordset n’est pas prise en charge dans .NET. - Les clients COM existants qui utilisent une liaison déclarative doivent être recompilés en raison de modifications de GUID. |
- Migration des assemblys HIS 2009 TLB et .NET LU62. - Migration à partir d’assemblys .NET et his 2006 ou HIS 2004. - Une nouvelle RE doit être créée dans l’environnement Host Integration Server 2009. - Utilisation des fonctionnalités RE. - Passage à l’environnement pris en charge par HIS. - Le modèle de programmation reste le même. |
| Convertir des TLB et des assemblys .NET à l’aide de la fonctionnalité d’importation Designer | - Mises à jour la classe Remote Environment. - Génère un nouvel assembly .NET Utilise le nouveau modèle objet ClientContext |
La propriété de méthode Include Context Parameter est automatiquement définie sur True. Si les applications clientes n’ont pas besoin de prendre en charge le contexte client et fonctionnent sans modification, car le contexte client est un paramètre facultatif. Dans le projet Visual Studio TI, définissez Include Context Parameter sur False sur la méthode . Modèle ClientContext converti du tableau d’objets en modèle en modèle objet. L’application cliente doit être modifiée pour fonctionner avec le nouveau modèle objet si ClientContext est activé. Si vous migrez une ancienne bibliothèque de types vers un assembly .NET, TI migre également tous les types de données Automation Visual Basic version 6.0 vers les types de données Visual Basic .NET, notamment : - Entier à Court - Long à Entier - Devise en décimal - Recordset to DataTable - UDT vers Structure Les applications clientes qui utilisent la fonction NewRecordset pour créer des recordsets déconnectés doivent modifier le code. La fonction NewRecordset n’est pas prise en charge dans .NET. Les clients COM existants qui utilisent une liaison déclarative doivent être recompilés en raison de modifications de GUID. |
- Création d’un instance de l’application pour une opération côte à côte avec Host Integration Server 2009 dans le but d’étendre l’application. - Utilisation de nouvelles fonctionnalités de contexte client (Sécurité du client, Connections persistants, etc.). - Modification du modèle de programmation - Modification de l’environnement cible (CICS, IMS, IBM i) - Changement d’initiation (WIP, HIP) - Conversion d’assemblys .NET implicites OU IMS explicites TLBs avec progID de plus de 39 caractères. |