Resumen
Host Integration Server incluye un diseñador de Visual Studio para habilitar la creación de archivos de .hidx que se utilizan por diversos componentes del runtime HIS para comunicarse con sistemas back-end. La creación de archivos de .hidx a través del Diseñador de Studio es estrictamente una operación manual. Sin embargo, al automatizar la generación de archivos de .hidx a través de PowerShell puede ahorrar tiempo durante la vida de un proyecto. Actualización acumulativa 2 permite la creación y modificación de archivos de .hidx a través de PowerShell.
Tenga en cuenta que debe utilizarse la versión de 32 bits de PowerShell porque llaman a los componentes del Diseñador de Visual Studio de 32 bits. Si se utiliza la versión de 64 bits de PowerShell, se registra un mensaje de error similar al siguiente:
El inicializador de tipo para 'Microsoft.HostIntegration.Importer.PowerShell.NewHisWipHidxFile' produjo una excepción.
Más información
Esta actualización se incluye en la actualización acumulativa 2 para Host Integration Server 2016.
Los siguientes son los tipos de proyectos de integración de Host que se pueden crear en Visual Studio:
-
Conversión de canalización de BizTalk
-
Aplicaciones host
-
Archivos de host
-
Message Queue Server
Después de instala este paquete acumulativo de actualizaciones, puede crear archivos de .hidx para cada uno de estos tipos de proyectos a través de PowerShell. Recomendamos que tenga alguna experiencia en la generación de archivos de .hidx a través del Diseñador de Visual Studio antes de intentar usar PowerShell para crear los archivos.
Para usar PowerShell, abra 32 bits Windows PowerShell ISE (x86) y, a continuación, seleccione Mostrar comando complementos en el menú Ver . En la ficha comandos , seleccione el módulo Microsoft.HostIntegration.Importer.PowerShell para mostrar la lista de comandos de PowerShell que están disponibles.
Ejemplo
Para llevar a cabo las siguientes tareas manualmente, siga estos pasos:
-
Crear un objeto de hidx de trabajo en curso.
-
Agregue un método denominado GetAccounts.
-
Agregue un parámetro de cadena de caracteres de 30 entrada denominada CustomerName.
-
Agregue un parámetro de cadena de 6 caracteres de entrada que se denomina AccountNum.
-
Agregar un parámetro de salida decimal denominado Saldo PIC S9 (7) V99.
-
Guardar el objeto de hidx de trabajo en curso como un archivo. El archivo hidx se guarda en C:\Lab. tenga en cuenta que la carpeta debe existir para poder crear el objeto $WIPhidx.
Para automatizar estas tareas, ejecute el siguiente script de 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: Las secuencias de comandos de PowerShell de ejemplo adicionales están disponibles en GitHub.
Referencias
Aprender acerca de la terminología que utiliza Microsoft para describir las actualizaciones de software.