Overzicht
Host Integration Server bevat een Visual Studio-Designer om het maken van .hidx-bestanden mogelijk te maken die worden gebruikt door verschillende onderdelen van de HIS-runtime om te communiceren met back-endsystemen. Het maken van .hidx-bestanden via Studio Designer is uitsluitend een handmatige bewerking. Het automatiseren van het genereren van .hidx-bestanden via PowerShell kan echter tijd besparen tijdens de levensduur van een project. Cumulatieve update 2 maakt het maken en wijzigen van .hidx-bestanden mogelijk via PowerShell.
Houd er rekening mee dat de 32-bits versie van PowerShell moet worden gebruikt omdat onderdelen van 32-bits Visual Studio-Designer worden aangeroepen. Als de 64-bits versie van PowerShell wordt gebruikt, wordt een foutbericht met de volgende strekking geregistreerd:
Opmerking
De type-initializer voor 'Microsoft.HostIntegration.Importer.PowerShell.NewHisWipHidxFile' heeft een uitzondering veroorzaakt.
Meer informatie
Deze update is opgenomen in cumulatieve update 2 voor Host Integration Server 2016.
Hier volgen de soorten hostintegratieprojecten die kunnen worden gemaakt in Visual Studio:
- BizTalk-pijplijnconversie
- Hosttoepassingen
- Hostbestanden
- Berichtenwachtrij
Nadat dit updatepakket is geïnstalleerd, kunt u .hidx-bestanden maken voor elk van deze projecttypen via PowerShell. We raden u aan enige ervaring te hebben met het bouwen van .hidx-bestanden via Visual Studio Designer voordat u PowerShell probeert te gebruiken om de bestanden te maken.
Als u PowerShell wilt gebruiken, opent u de 32-bits Windows PowerShell ISE (x86) en selecteert u opdrachtinvoegtoepassing weergeven in het menu Beeld. Selecteer op het tabblad Opdrachten de module Microsoft.HostIntegration.Importer.PowerShell om de lijst met beschikbare PowerShell-opdrachten weer te geven.
Voorbeeld
Voer de volgende stappen uit om de volgende taken handmatig uit te voeren:
- Maak een WIP hidx-object.
- Voeg een methode toe met de naam GetAccounts.
- Voeg een invoerparameter van 30 tekens toe met de naam CustomerName.
- Voeg een invoertekenreeksparameter van 6 tekens toe met de naam AccountNum.
- Voeg een uitvoerdecimaalparameter met de naam Balance toe die PIC S9(7)V99 is.
- Sla het WIP hidx-object op als bestand. Het hidx-bestand wordt opgeslagen in C:\Lab. Houd er rekening mee dat de map moet bestaan om het $WIPhidx-object te kunnen maken.
Voer het volgende script uit in PowerShell om deze taken te automatiseren:
$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()
Opmerking Aanvullende voorbeeldscripts van PowerShell zijn beschikbaar op GitHub.
Meer informatie
Meer informatie over de terminologie die Microsoft gebruikt om software-updates te beschrijven.