Sumário
O Host Integration Server inclui um Designer do Visual Studio para permitir a criação de arquivos de .hidx que são usadas por vários componentes do runtime HIS para se comunicar com sistemas back-end. A criação de arquivos de .hidx por meio do Designer Studio é estritamente uma operação manual. No entanto, a automatizar a geração de arquivos de .hidx por meio do PowerShell pode economizar tempo durante a vida de um projeto. Atualização cumulativa 2 permite a criação e modificação de arquivos de .hidx por meio do PowerShell.
Observe que a versão de 32 bits do PowerShell deve ser usada porque são chamados de componentes do Visual Studio Designer de 32 bits. Se for usada a versão de 64 bits do PowerShell, uma mensagem de erro semelhante à seguinte é registrada:
O inicializador de tipo de 'Microsoft.HostIntegration.Importer.PowerShell.NewHisWipHidxFile' emitiu uma exceção.
Mais informações
Essa atualização está incluída no 2 de atualização cumulativa para 2016 do Host Integration Server.
Estes são os tipos de projetos de integração de Host que podem ser criados no Visual Studio:
-
Conversão de canal do BizTalk
-
Aplicativos de host
-
Arquivos de host
-
Enfileiramento de mensagens
Depois que esse pacote cumulativo de atualizações está instalado, você pode criar arquivos de .hidx para cada um desses tipos de projeto por meio do PowerShell. Recomendamos que você tenha alguma experiência na criação de arquivos de .hidx por meio do Designer do Visual Studio antes de tentar usar o PowerShell para criar os arquivos.
Para usar o PowerShell, abra a 32-bit Windows PowerShell ISE (x86) e selecione Mostrar complemento do comando no menu Exibir . Na guia ' comandos ', selecione o módulo Microsoft.HostIntegration.Importer.PowerShell para exibir a lista de comandos do PowerShell que estão disponíveis.
Exemplo:
Para executar as seguintes tarefas manualmente, siga estas etapas:
-
Crie um objeto de hidx WIP.
-
Adicione um método chamado GetAccounts.
-
Adicione um parâmetro de sequência de caracteres de 30 entrada chamada CustomerName.
-
Adicione um parâmetro de sequência de caracteres de 6 entrada chamado AccountNum.
-
Adicionar um parâmetro de saída decimal chamado Saldo PIC S9 (7) V99.
-
Salve o objeto de hidx WIP como um arquivo. O arquivo hidx é salvo em C:\Lab. Lembre-se de que a pasta deve existir para ser capaz de criar o objeto $WIPhidx.
Para automatizar essas tarefas, execute o seguinte script do 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()
Observação: Scripts do PowerShell de exemplo adicionais estão disponíveis no GitHub.
Referências
Conheça a terminologia que a Microsoft usa para descrever as atualizações de software.