Résumé
Host Integration Server comprend un concepteur Visual Studio pour permettre la création de fichiers .hidx qui sont utilisés par différents composants du runtime HIS pour communiquer avec les systèmes back-end. La création de fichiers de .hidx via le concepteur Studio est strictement une opération manuelle. Toutefois, automatisation de la génération de fichiers .hidx par le biais de PowerShell peut gagner du temps sur la durée de vie d’un projet. Mise à jour cumulative, 2 permet la création et la modification de fichiers .hidx par le biais de PowerShell.
Notez que la version 32 bits de PowerShell doit être utilisée, car les composants du Concepteur de Visual Studio 32 bits sont appelés. Si la version 64 bits de PowerShell est utilisée, un message d’erreur semblable au suivant est enregistré :
L’initialiseur de type pour 'Microsoft.HostIntegration.Importer.PowerShell.NewHisWipHidxFile' a levé une exception.
Plus d'informations
Cette mise à jour est inclus dans la mise à jour Cumulative des 2 pour Host Integration Server 2016.
Les types de projets d’intégration d’hôte qui peuvent être créés dans Visual Studio sont les suivantes :
-
Conversion de pipeline BizTalk
-
Applications hôtes
-
Fichiers de l’hôte
-
Message Queuing
Après avoir installé ce correctif cumulatif, vous pouvez créer des fichiers de .hidx pour chacun de ces types de projet par le biais de PowerShell. Il est recommandé d’avoir une expérience de la génération de .hidx des fichiers via le Concepteur de Visual Studio avant d’essayer d’utiliser PowerShell pour créer les fichiers.
Pour utiliser PowerShell, ouvrez l’ordinateur 32 bits Windows PowerShell ISE (x86) et puis sélectionnez Afficher les modules complémentaires de commande dans le menu affichage . Sous l’onglet commandes , sélectionnez le module de Microsoft.HostIntegration.Importer.PowerShell pour afficher la liste des commandes PowerShell qui sont disponibles.
Exemple
Pour effectuer les tâches suivantes manuellement, procédez comme suit :
-
Créez un objet de hidx de travaux en cours.
-
Ajoutez une méthode nommée GetAccounts.
-
Ajouter un paramètre de chaîne de 30 caractères d’entrée nommé CustomerName.
-
Ajouter un paramètre de chaîne de 6 caractères d’entrée nommé AccountNum.
-
Ajouter un paramètre de sortie décimal nommé Solde PIC S9 (7) V99.
-
Enregistrer l’objet hidx de travaux en cours dans un fichier. Le fichier hidx est enregistré dans C:\Lab. n’oubliez pas que le dossier doit exister pour pouvoir créer l’objet $WIPhidx.
Pour automatiser ces tâches, exécutez le script suivant dans PowerShell :
$WIPhidx = New-HisWipHidxFile -ElmUserData -Name MyNamespace -Interface IMyInterface -
Description "My Description" -File C:\Lab\WIPSample.hidx
$WIPMethod = Add-HisHidxElement -InputObject $WIPhidx -Method -Name GetAccounts
$NameParameter = $WIPMethod | Add-HisHidxParameter -Name CustomerName -Atomic
$NameParameter.Direction = "In"
$NameParameter.DataType = "String"
$NameParameter.ConversionInformation.Size = 30
$AccountParameter = $WIPMethod | Add-HisHidxParameter -Name AccountNum -Atomic
$AccountParameter.Direction = "In"
$AccountParameter.DataType = "String"
$AccountParameter.ConversionInformation.Size = 6
$BalanceParameter = $WIPMethod | Add-HisHidxParameter -Name Balance -Atomic
$BalanceParameter.Direction = "Out"
$BalanceParameter.DataType = "Decimal"
$BalanceParameter.ConversionInformation.HostDataType = "PIC S9(n)V9(n) COMP-3"
$BalanceParameter.ConversionInformation.Precision = 7
$BalanceParameter.ConversionInformation.Scale = 2
$WIPhidx.Save()
Remarque Les scripts PowerShell exemple supplémentaires sont disponibles sur GitHub.
Références
Découvrez la terminologie que Microsoft utilise pour décrire les mises à jour logicielles.
