Sammanfattning
Host Integration Server innehåller en Visual Studio-Designer för att göra det möjligt att skapa HIDX-filer som används av olika komponenter i HANS runtime för att kommunicera med backend-system. Skapandet av .hidx-filer via Studio Designer är strikt en manuell åtgärd. Om du automatiserar genereringen av HIDX-filer via PowerShell kan du spara tid under ett projekts livscykel. Kumulativ uppdatering 2 gör det möjligt att skapa och ändra HIDX-filer via PowerShell.
Observera att 32-bitarsversionen av PowerShell måste användas eftersom komponenter i 32-bitars Visual Studio-Designer kallas. Om 64-bitarsversionen av PowerShell används loggas ett felmeddelande som liknar följande:
Obs
Typinitiseraren för Microsoft.HostIntegration.Importer.PowerShell.NewHisWipHidxFile gjorde ett undantag.
Mer information
Den här uppdateringen ingår i kumulativ uppdatering 2 för Host Integration Server 2016.
Följande är de typer av värdintegreringsprojekt som kan skapas i Visual Studio:
- BizTalk pipeline conversion
- Värdprogram
- Värdfiler
- Meddelandeköer
När den här samlade uppdateringen har installerats kan du skapa HIDX-filer för var och en av dessa projekttyper via PowerShell. Vi rekommenderar att du har lite erfarenhet av att 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 öppnar du 32-bitars Windows PowerShell ISE (x86) och väljer sedan Visa kommandotillägg på Visa-menyn. Välj Microsoft.HostIntegration.Importer.PowerShell-modulen på fliken Kommandon för att visa listan över tillgängliga PowerShell-kommandon.
Exempel
Gör så här om du vill utföra följande uppgifter manuellt:
- Skapa ett WIP-hidx-objekt.
- Lägg till en metod som heter GetAccounts.
- Lägg till en indataparameter med 30 tecken som heter CustomerName.
- Lägg till en indatasträngparameter på 6 tecken som heter AccountNum.
- Lägg till en utdataparameter som heter Balans som är PIC S9(7)V99.
- Spara WIP hidx-objektet som en fil. Hidx-filen sparas på C:\Lab. Tänk på att mappen måste finnas för att kunna skapa det $WIPhidx objektet.
Om du vill automatisera dessa uppgifter kör du följande skript 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()
Observera Ytterligare powershell-exempelskript är tillgängliga på GitHub.
Referenser
Läs mer om den terminologi som Microsoft använder för att beskriva programuppdateringar.