Ny PowerShell-modul oppretter programmatisk Designer Objects i Host Integration Server

Gjelder for
Host Integration Server 2016

Sammendrag

Host Integration Server inkluderer en Visual Studio-Designer for å aktivere oppretting av .hidx-filer som brukes av ulike komponenter i HIS-kjøretiden til å kommunisere med baksystemer. Oppretting av .hidx-filer via Studio Designer er bare en manuell operasjon. Automatisere genereringen av .hidx-filer via PowerShell kan imidlertid spare tid i løpet av prosjektets levetid. Kumulativ oppdatering 2 gjør det mulig å opprette og endre .hidx-filer via PowerShell.

Vær oppmerksom på at 32-bitersversjonen av PowerShell må brukes fordi komponenter i 32-biters Visual Studio Designer kalles. Hvis 64-bitersversjonen av PowerShell brukes, logges en feilmelding som ligner på følgende:

Obs!

Typeinitialisereren for Microsoft.HostIntegration.Importer.PowerShell.NewHisWipHidxFile forårsaket et unntak.

Mer informasjon

Denne oppdateringen er inkludert i kumulativ oppdatering 2 for Host Integration Server 2016.

Følgende er typene vertsintegrasjonsprosjekter som kan opprettes i Visual Studio:

  • Konvertering av BizTalk-datasamlebånd
  • Vertsprogrammer
  • Vertsfiler
  • Melding i kø

Når denne samleoppdateringen er installert, kan du opprette .hidx-filer for hver av disse prosjekttypene gjennom PowerShell. Vi anbefaler at du har litt erfaring med å bygge .hidx-filer gjennom Visual Studio Designer før du prøver å bruke PowerShell til å opprette filene.

Hvis du vil bruke PowerShell, åpner du 32-biters Windows PowerShell ISE (x86), og deretter velger du Vis kommandotillegg på Vis-menyen. Velg modulen Microsoft.HostIntegration.Importer.PowerShell på Kommandoer-fanen for å vise listen over PowerShell-kommandoer som er tilgjengelige.

Eksempel

Følg disse trinnene for å utføre følgende oppgaver manuelt:

  1. Opprett et WIP hidx-objekt.
  2. Legg til en metode som heter GetAccounts.
  3. Legg til en parameter for inndatastreng med 30 tegn som heter CustomerName.
  4. Legg til en parameter for inndatastreng med seks tegn som heter AccountNum.
  5. Legg til en utdatadesimalparameter med navnet Saldo som er PIC S9(7)V99.
  6. Lagre WIP hidx-objektet som en fil. Hidx-filen lagres på C:\Lab. Vær oppmerksom på at mappen må finnes for å kunne opprette $WIPhidx objektet.

Hvis du vil automatisere disse oppgavene, kjører du følgende 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()

Merk Andre eksempler på PowerShell-skript er tilgjengelige på GitHub.

Kilder

Finn ut mer om terminologien Microsoft bruker til å beskrive programvareoppdateringer.