Sammanfattning
Host Integration Server innehåller en Visual Studio Designer för att skapa .hidx filer som används av olika komponenter i HIS runtime för att kommunicera med backend-system. Skapandet av .hidx filer via Studio Designer är strikt en manuell åtgärd. Automatisera den generation av .hidx filer via PowerShell kan emellertid spara tid under ett projekts livstid. Kumulativ uppdatering 2 möjliggör skapande och ändring av .hidx filer via PowerShell.
Observera att 32-bitarsversionen av PowerShell måste användas eftersom komponenter i Visual Studio Designer för 32-bitars kallas. Om du använder 64-bitarsversionen av PowerShell loggas ett felmeddelande av följande slag:
Ett undantagsfel inträffade för typinitieraren för 'Microsoft.HostIntegration.Importer.PowerShell.NewHisWipHidxFile'.
Mer information
Den här uppdateringen ingår i kumulativ uppdatering 2 för Host Integration Server 2016.
Typer av Host Integration projekt som kan skapas i Visual Studio är följande:
-
BizTalk-pipeline-konvertering
-
Värdprogram
-
Värd för filer
-
Message Queuing
När den här samlade uppdateringen har installerats kan skapa du .hidx filer för vart och ett av dessa projekt via PowerShell. Vi rekommenderar att du har viss erfarenhet skapa .hidx filer via Visual Studio Designer innan du försöker använda PowerShell för att skapa filerna.
Om du vill använda PowerShell öppna 32-bitars Windows PowerShell ISE (x86) och sedan markera Visa kommandot tillägg på Visa -menyn. Välj Microsoft.HostIntegration.Importer.PowerShell -modul för att visa listan med PowerShell-kommandon som är tillgängliga på fliken kommandon .
Exempel
Gör så här om du vill utföra följande uppgifter manuellt:
-
Skapa ett objekt för PIA-hidx.
-
Lägga till en metod som heter GetAccounts.
-
Lägga till en indataparameter 30 teckensträng som heter CustomerName.
-
Lägga till en parameter i Indatasträngen 6 tecken som kallas AccountNum.
-
Lägga till en decimal utdataparameter som heter Saldo är PIC S9 (7) V99.
-
Spara PIA hidx objekt som en fil. Filen hidx sparas i C:\Lab. Observera att mappen måste finnas för att kunna skapa $WIPhidx-objekt.
Kör följande skript för att automatisera åtgärderna i 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()
Obs! Ytterligare exempel PowerShell-skript finns på GitHub.
Referenser
Lär dig mer om den terminologin som Microsoft använder för att beskriva programuppdateringar.
