Novo módulo de PowerShell programaticamente cria objectos de Designer no Host Integration Server

Sumário

Host Integration Server inclui o Visual Studio Designer para permitir a criação de ficheiros de .hidx que são utilizados por vários componentes Runtime HIS para comunicar com sistemas back-end. A criação de ficheiros de .hidx através de Studio Designer é estritamente uma operação manual. No entanto, automatizar a criação de ficheiros de .hidx através de PowerShell pode poupar tempo ao longo da vida de um projecto. 2 de actualização cumulativa permite a criação e modificação de ficheiros de .hidx através de PowerShell.

Tenha em atenção que a versão de 32 bits do PowerShell deve ser utilizada porque denominam-se os componentes de 32 bits Visual Studio Designer. Se for utilizada a versão de 64 bits do PowerShell, é registada uma mensagem de erro semelhante à seguinte:

Mais informações

Esta actualização está incluída na actualização cumulativa 2 para o Host Integration Server 2016.

Seguem-se os tipos de projectos de integração do anfitrião que podem ser criados no Visual Studio:

• Conversão de pipeline do BizTalk

• Aplicações de anfitrião

• Ficheiros de anfitrião

• Colocação em fila de mensagem

Depois de instalar este update rollup, pode criar ficheiros de .hidx para cada um destes tipos de projecto através de PowerShell. Recomendamos que tenha alguma experiência de criação de ficheiros de .hidx através do Visual Studio Designer antes de tentar utilizar o PowerShell para criar os ficheiros.

Para utilizar o PowerShell, abra a 32-bit Windows PowerShell ISE (x86) e, em seguida, seleccione o Suplemento de comando Mostrar no menu Ver . No separador de comandos , seleccione o módulo de Microsoft.HostIntegration.Importer.PowerShell para apresentar a lista de comandos PowerShell que estão disponíveis.

Exemplo

Para efectuar as seguintes tarefas manualmente, siga estes passos:

1. Crie um objecto de hidx de TRAB.

2. Adicione um método denominado GetAccounts.

3. Adicione um parâmetro de cadeia de caracteres de 30 de entrada com o nome NomeDoCliente.

4. Adicione um parâmetro de entrada de 6 caracteres de cadeia denominado AccountNum.

5. Adicionar um parâmetro decimal de saída com Saldo , que é PIC S9 (7) V99.

6. Guarde o objecto de hidx de trabalho em curso como um ficheiro. O ficheiro hidx está guardado em C:\Lab. tenha em atenção que a pasta tem de existir para conseguir criar o objecto $WIPhidx.

Para automatizar estas tarefas, execute o seguinte script no 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 Scripts de PowerShell exemplo adicionais estão disponíveis em GitHub.

Referências

Obter informações sobre a terminologia a Microsoft utiliza para descrever actualizações de software.