Zusammenfassung
Host Integration Server enthält eine Visual Studio-Designer, um die Erstellung von HIDX-Dateien zu ermöglichen, die von verschiedenen Komponenten der HIS-Runtime für die Kommunikation mit Back-End-Systemen verwendet werden. Die Erstellung von HIDX-Dateien über Studio Designer ist ausschließlich ein manueller Vorgang. Die Automatisierung der Generierung von HIDX-Dateien über PowerShell kann jedoch zeitsparend über die Lebensdauer eines Projekts verfügen. Kumulatives Update 2 ermöglicht das Erstellen und Ändern von HIDX-Dateien über PowerShell.
Beachten Sie, dass die 32-Bit-Version von PowerShell verwendet werden muss, da Komponenten von 32-Bit-Visual Studio-Designer aufgerufen werden. Wenn die 64-Bit-Version von PowerShell verwendet wird, wird eine Fehlermeldung protokolliert, die der folgenden ähnelt:
Hinweis
Der Typinitialisierer für "Microsoft.HostIntegration.Importer.PowerShell.NewHisWipHidxFile" hat eine Ausnahme ausgelöst.
Weitere Informationen
Dieses Update ist im kumulativen Update 2 für Host Integration Server 2016 enthalten.
Im Folgenden finden Sie die Arten von Hostintegrationsprojekten, die in Visual Studio erstellt werden können:
- Konvertierung der BizTalk-Pipeline
- Hostanwendungen
- Hostdateien
- Nachrichtenwarteschlangen
Nachdem dieses Updaterollup installiert wurde, können Sie HIDX-Dateien für jeden dieser Projekttypen über PowerShell erstellen. Es wird empfohlen, dass Sie über ein gewisses Erfahrungserlebnis beim Erstellen von HIDX-Dateien über Visual Studio Designer verfügen, bevor Sie versuchen, die Dateien mithilfe von PowerShell zu erstellen.
Um PowerShell zu verwenden, öffnen Sie die 32-Bit-Windows PowerShell ISE (x86), und wählen Sie dann Befehls-Add-On anzeigen im Menü Ansicht aus. Wählen Sie auf der Registerkarte Befehle das Modul Microsoft.HostIntegration.Importer.PowerShell aus, um die Liste der verfügbaren PowerShell-Befehle anzuzeigen.
Beispiel
Führen Sie die folgenden Schritte aus, um die folgenden Aufgaben manuell auszuführen:
- Erstellen Sie ein WIP-Hidx-Objekt.
- Fügen Sie eine Methode mit dem Namen GetAccounts hinzu.
- Fügen Sie einen 30-Zeichen-Zeichenfolgenparameter mit dem Namen CustomerName hinzu.
- Fügen Sie einen 6-stelligen Zeichenfolgenparameter mit dem Namen AccountNum hinzu.
- Fügen Sie einen Ausgabedezimalparameter mit dem Namen Balance hinzu, der PIC S9(7)V99 ist.
- Speichern Sie das WIP-Hidx-Objekt als Datei. Die Hidx-Datei wird unter C:\Lab gespeichert. Beachten Sie, dass der Ordner vorhanden sein muss, um das $WIPhidx-Objekt erstellen zu können.
Führen Sie das folgende Skript in PowerShell aus, um diese Aufgaben zu automatisieren:
$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()
Hinweis Weitere PowerShell-Beispielskripts sind auf GitHub verfügbar.
Referenzmaterial
Erfahren Sie mehr über die Terminologie , die Microsoft zum Beschreiben von Softwareupdates verwendet.