Partager via

Outil de conversion de l’intégrateur de transactions

  • Article

L’utilitaire de ligne de commande TIConversionTool permet de migrer rapidement et facilement vers Host Integration Server à partir de HIS 2010, HIS 2009, HIS 2008, HIS 2006 et HIS 2004. Vous pouvez l’utiliser pour convertir des assemblys .NET et des TLB initiés par une fenêtre (WIP) ou hip (Host Initiated) et des assemblys .NET créés dans des versions antérieures de HIS en assemblys .NET Host Integration Server. Vous pouvez l’utiliser pour convertir un seul assembly ou un seul TLB, ou plusieurs TLB ou assemblys.

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\

Vous pouvez exécuter l’utilitaire de conversion à partir de la ligne de commande ou l’appeler à partir d’un autre programme comme PowerShell. Pour obtenir des instructions d’utilisation au moment de l’exécution, exécutez TIConversionTool.exe à partir de la ligne de commande sans argument.

L’outil TIConversion, lorsqu’il est exécuté, génère le répertoire suivant portant le même nom que l’assembly ou le TLB en cours de conversion. Dans ce répertoire, les fichiers suivants et un répertoire bin qui contient l’assembly TI converti sont placés.

  1. xxxx.asmx : fichier de configuration pour le déploiement de l’assembly TI en tant que service web

  2. xxxx.svc : fichier de configuration pour le déploiement de l’assembly TI en tant que service Wcf

  3. xxxx.xsd : fichier de schéma à utiliser avec l’adaptateur d’application hôte BizTalk

  4. web.config. WCF - fichier de configuration web wcf pour le déploiement IIS

  5. web.config.WS - fichier de configuration web asmx pour le déploiement II

  6. bin/xxxx.dll : assembly TI converti.

    Considérations relatives à TIConversionTool

  • Le TIConversionTool.exe migre l’interface de contexte vers la nouvelle interface de contexte introduite dans Host Integration Server.

  • TheTIConversionTool.exe mettre à jour la classe RE uniquement lorsque la classe RE actuelle n’est plus prise en charge.

  • L’utilitaire met à jour les anciennes bibliothèques de types et les assemblys .NET pour qu’ils fonctionnent avec Host Integration Server. Une fois converties, nous vous recommandons d’associer les conversions à la nouvelle configuration RE. Vous pouvez associer des conversions HIS 2009 et HIS 2010 à des unités de recherche HIS existantes ou à de nouvelles unités de demande de serveur d’intégration d’hôte correspondantes.

  • Lors de la conversion d’une ancienne bibliothèque de types en assembly .NET, TI convertit les types de données Visual Basic version 6.0 Automation en types Visual Basic .NET, comme décrit dans le tableau suivant.

    Visual Basic v6 Visual Basic .NET
    Integer Court
    Long Integer
    Devise Decimal
    Ensemble d'enregistrements DataTable
    UDT Structure

  • La fonction NewRecordset n’est pas prise en charge dans .NET. Vous devez modifier le code dans les applications clientes qui utilisent la fonction NewRecordset pour créer des recordsets déconnectés.

  • Vous devez recompiler les clients COM existants qui utilisent une liaison déclarative en raison de modifications du GUID.

  • Vous devez utiliser la fonctionnalité Importer dans Designer pour convertir l’assembly TLB ou .NET dans les cas suivants :

    • Votre application utilise des connexions de persistance.

    • Vous souhaitez utiliser des fonctionnalités qui s’appuient sur le nouveau modèle, telles que les ER dynamiques.

    • Le ProgID du TLB est supérieur à 39 caractères.

  • Ti TLB contenait deux interfaces pour le contexte TI lorsque le tlb a été configuré pour permettre l’utilisation de clientContext. HIS2020 assemblys .Net TI ne contiennent qu’une seule interface lorsqu’ils sont configurés pour autoriser l’utilisation de clientContext. Une application cliente utilisant un tlb avec un modèle d’appel direct n’a pas besoin de la valeur de contexte définie dans la liste de paramètres de l’appel de méthode TI. Dans HIS2020 Après avoir exécuté le tlb via TIconversiontool.exe le résultat est remplacé par un assembly .Net. le client doit inclure la valeur de contexte dans la liste des paramètres de l’appel de méthode TI.

    Pour plus d’informations, consultez Utilisation des Designer TI.

Utilisation

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

Syntax

/f
Spécifiez les bibliothèques à convertir.

/Fl
Spécifiez un fichier texte qui contient une liste de bibliothèques à convertir.

/O
Spécifiez le répertoire qui contiendra les assemblys convertis.

/L
Spécifiez le nom du fichier journal.

/d
Spécifiez un répertoire qui contient les bibliothèques à convertir.

/ds
Spécifiez un répertoire qui contient les bibliothèques à convertir, y compris celles des sous-répertoires.

/Ow
Remplacez tous les assemblys existants.

/Sk
Ignorez les bibliothèques de types dont les assemblys de sortie existent déjà.

/Ol
Remplacez le fichier journal s’il existe.

Exemple d’utilisation

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

Avertissement

Les paramètres de ligne de commande spécifiés sans utiliser les indicateurs ci-dessus sont traités comme des bibliothèques à convertir.