Un nouveau module PowerShell crée par programmation des objets Designer dans Host Integration Server

Résumé

Host Integration Server inclut un Designer Visual Studio pour permettre la création de fichiers .hidx utilisés par différents composants du runtime HIS pour communiquer avec les systèmes principaux. La création de fichiers .hidx via Studio Designer est strictement une opération manuelle. Toutefois, l’automatisation de la génération de fichiers .hidx via PowerShell peut faire gagner du temps sur la durée de vie d’un projet. La mise à jour cumulative 2 permet la création et la modification de fichiers .hidx via PowerShell.

Notez que la version 32 bits de PowerShell doit être utilisée, car les composants de Visual Studio 32 bits Designer sont appelés. Si la version 64 bits de PowerShell est utilisée, un message d’erreur semblable à ce qui suit est enregistré :

Informations complémentaires

Cette mise à jour est incluse dans la mise à jour cumulative 2 pour Host Integration Server 2016.

Voici les types de projets d’intégration d’hôte qui peuvent être créés dans Visual Studio :

• Conversion de pipeline BizTalk
• Applications hôtes
• Fichiers hôtes
• Mise en file d’attente des messages

Une fois ce correctif cumulatif installé, vous pouvez créer des fichiers .hidx pour chacun de ces types de projets via PowerShell. Nous vous recommandons d’avoir une certaine expérience dans la création de fichiers .hidx via Visual Studio Designer avant d’essayer d’utiliser PowerShell pour créer les fichiers.

Pour utiliser PowerShell, ouvrez le Windows PowerShell ISE 32 bits (x86), puis sélectionnez Afficher le module complémentaire commande dans le menu Affichage. Sous l’onglet Commandes , sélectionnez le module Microsoft.HostIntegration.Importer.PowerShell pour afficher la liste des commandes PowerShell disponibles.

Exemple

Pour effectuer les tâches suivantes manuellement, procédez comme suit :

1. Créez un objet hidx WIP.
2. Ajoutez une méthode nommée GetAccounts.
3. Ajoutez un paramètre de chaîne de 30 caractères d’entrée nommé CustomerName.
4. Ajoutez un paramètre de chaîne de 6 caractères d’entrée nommé AccountNum.
5. Ajoutez un paramètre décimal de sortie nommé Balance qui est PIC S9(7)V99.
6. Enregistrez l’objet hidx WIP en tant que 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()

Note D’autres exemples de scripts PowerShell sont disponibles sur GitHub.

Références

Découvrez la terminologie utilisée par Microsoft pour décrire les mises à jour logicielles.