Il nuovo modulo di PowerShell crea a livello di programmazione oggetti Designer in Host Integration Server

Si applica a
Host Integration Server 2016

Riepilogo

Host Integration Server include un Visual Studio Designer per consentire la creazione di file .hidx che vengono utilizzati da vari componenti del runtime HIS per comunicare con sistemi back-end. La creazione di file .hidx tramite Studio Designer è strettamente un'operazione manuale. Tuttavia, l'automazione della generazione di file HIDX tramite PowerShell consente di risparmiare tempo durante la vita di un progetto. L'aggiornamento cumulativo 2 consente la creazione e la modifica di file HIDX tramite PowerShell.

Si noti che è necessario usare la versione a 32 bit di PowerShell perché vengono chiamati i componenti di Visual Studio Designer a 32 bit. Se viene usata la versione a 64 bit di PowerShell, viene registrato un messaggio di errore simile al seguente:

Nota

L'inizializzatore del tipo "Microsoft.HostIntegration.Importer.PowerShell.NewHisWipHidxFile" ha generato un'eccezione.

Altre informazioni

Questo aggiornamento è incluso nell'aggiornamento cumulativo 2 per Host Integration Server 2016.

Di seguito sono elencati i tipi di progetti di integrazione host che possono essere creati in Visual Studio:

  • Conversione pipeline BizTalk
  • Applicazioni host
  • File host
  • Accodamento dei messaggi

Dopo aver installato questo aggiornamento cumulativo, è possibile creare file HIDX per ognuno di questi tipi di progetto tramite PowerShell. È consigliabile provare a creare file hidx tramite Visual Studio Designer prima di provare a usare PowerShell per creare i file.

Per usare PowerShell, apri il Windows PowerShell ISE a 32 bit (x86) e quindi seleziona Mostra componente aggiuntivo comando nel menu Visualizza. Nella scheda Comandi selezionare il modulo Microsoft.HostIntegration.Importer.PowerShell per visualizzare l'elenco dei comandi di PowerShell disponibili.

Esempio

Per eseguire manualmente le attività seguenti, seguire questa procedura:

  1. Creare un oggetto hidx WIP.
  2. Aggiungere un metodo denominato GetAccounts.
  3. Aggiungere un parametro di input con stringa di 30 caratteri denominato NomeCliente.
  4. Aggiungere un parametro di stringa di 6 caratteri di input denominato AccountNum.
  5. Aggiungere un parametro decimale di output denominato Saldo che sia PIC S9(7)V99.
  6. Salvare l'oggetto hidx WIP come file. Il file hidx viene salvato in C:\Lab. Tenere presente che la cartella deve esistere per poter creare l'oggetto $WIPhidx.

Per automatizzare queste attività, eseguire lo script seguente in 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()

Nota Altri script di esempio di PowerShell sono disponibili in GitHub.

Riferimenti

Informazioni sulla terminologia utilizzata da Microsoft per descrivere gli aggiornamenti software.