Resumo
O Host Integration Server inclui uma Designer do Visual Studio para habilitar a criação de arquivos .hidx que são usados por vários componentes do runtime his para se comunicar com sistemas de back-end. A criação de arquivos .hidx por meio do Studio Designer é estritamente uma operação manual. No entanto, automatizar a geração de arquivos .hidx por meio do PowerShell pode economizar tempo ao longo da vida de um projeto. A Atualização Cumulativa 2 permite a criação e modificação de arquivos .hidx por meio do PowerShell.
Observe que a versão de 32 bits do PowerShell deve ser usada porque os componentes do Visual Studio de 32 bits Designer são chamados. Se a versão de 64 bits do PowerShell for usada, uma mensagem de erro que se assemelha ao seguinte será registrada:
Observação
O inicializador de tipo para 'Microsoft.HostIntegration.Importer.PowerShell.NewHisWipHidxFile' gerou uma exceção.
Mais informações
Essa atualização está incluída na Atualização Cumulativa 2 do Host Integration Server 2016.
Veja a seguir os tipos de Projetos de Integração de Host que podem ser criados no Visual Studio:
- Conversão de pipeline do BizTalk
- Aplicativos host
- Arquivos host
- Fila de mensagens
Depois que essa reversão de atualização for instalada, você poderá criar arquivos .hidx para cada um desses tipos de projeto por meio do PowerShell. Recomendamos que você tenha alguma experiência na criação de arquivos .hidx por meio do Visual Studio Designer antes de tentar usar o PowerShell para criar os arquivos.
Para usar o PowerShell, abra o ISE de Windows PowerShell de 32 bits (x86) e selecione Mostrar Complemento de Comando no menu Exibir. Na guia Comandos , selecione o módulo Microsoft.HostIntegration.Importer.PowerShell para exibir a lista de comandos do PowerShell disponíveis.
Exemplo
Para executar as seguintes tarefas manualmente, siga estas etapas:
- Crie um objeto hidx WIP.
- Adicione um método chamado GetAccounts.
- Adicione um parâmetro de cadeia de caracteres de entrada de 30 caracteres chamado CustomerName.
- Adicione um parâmetro de cadeia de caracteres de 6 caracteres de entrada chamado AccountNum.
- Adicione um parâmetro decimal de saída chamado Balance que é PIC S9(7)V99.
- Salve o objeto hidx wip como um arquivo. O arquivo hidx é salvo em C:\Lab. Esteja ciente de que a pasta deve existir para poder criar o objeto $WIPhidx.
Para automatizar essas 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 Exemplo adicional de scripts do PowerShell estão disponíveis no GitHub.
Referências
Saiba mais sobre a terminologia que a Microsoft usa para descrever atualizações de software.