O novo módulo do PowerShell cria programaticamente objetos Designer no Servidor de Integração de Anfitriões

Aplica-se A
Host Integration Server 2016

Resumo

O Host Integration Server inclui um visual Studio Designer para permitir a criação de ficheiros .hidx que são utilizados por vários componentes do runtime HIS para comunicar com sistemas de back-end. A criação de ficheiros .hidx através do Studio Designer é estritamente uma operação manual. No entanto, automatizar a geração de ficheiros .hidx através do PowerShell pode poupar tempo ao longo da vida útil de um projeto. A Atualização Cumulativa 2 permite a criação e modificação de ficheiros .hidx através do PowerShell.

Tenha em atenção que a versão de 32 bits do PowerShell tem de ser utilizada porque os componentes do Visual Studio de 32 bits Designer são chamados. Se for utilizada a versão de 64 bits do PowerShell, é registada uma mensagem de erro semelhante ao seguinte:

Nota

O inicializador de tipo para "Microsoft.HostIntegration.Importer.PowerShell.NewHisWipHidxFile" gerou uma exceção.

Mais informações

Esta atualização está incluída na Atualização Cumulativa 2 para o Host Integration Server 2016.

Seguem-se os tipos de Projetos de Integração de Anfitriões que podem ser criados no Visual Studio:

  • Conversão do pipeline BizTalk
  • Aplicações anfitriãs
  • Ficheiros de anfitrião
  • Colocação de mensagens em fila

Após a instalação deste update rollup, pode criar ficheiros .hidx para cada um destes tipos de projeto através do PowerShell. Recomendamos que tenha alguma experiência na criação de ficheiros .hidx através do Visual Studio Designer antes de tentar utilizar o PowerShell para criar os ficheiros.

Para utilizar o PowerShell, abra o ise de Windows PowerShell de 32 bits (x86) e, em seguida, selecione Mostrar Suplemento de Comandos no menu Ver. No separador Comandos , selecione o módulo Microsoft.HostIntegration.Importer.PowerShell para apresentar a lista de comandos do PowerShell disponíveis.

Exemplo

Para executar as seguintes tarefas manualmente, siga estes passos:

  1. Crie um objeto hidx wip.
  2. Adicione um método denominado GetAccounts.
  3. Adicione um parâmetro input de 30 carateres-cadeia com o nome CustomerName.
  4. Adicione um parâmetro de cadeia de 6 carateres de entrada com o nome AccountNum.
  5. Adicione um parâmetro decimal de saída denominado Saldo que é PIC S9(7)V99.
  6. Guarde o objeto hidx do WIP como um ficheiro. O ficheiro hidx é guardado em C:\Lab. Tenha em atenção que a pasta tem de existir para poder criar o objeto $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 Estão disponíveis scripts do PowerShell de exemplo adicionais no GitHub.

Referências

Saiba mais sobre a terminologia que a Microsoft utiliza para descrever as atualizações de software.