El nuevo módulo PowerShell crea mediante programación objetos Designer en Host Integration Server

Se aplica a
Host Integration Server 2016

Resumen

Host Integration Server incluye visual Studio Designer para permitir la creación de archivos .hidx que usan varios componentes de SU runtime para comunicarse con sistemas back-end. La creación de archivos .hidx a través de Studio Designer es estrictamente una operación manual. Sin embargo, automatizar la generación de archivos .hidx a través de PowerShell puede ahorrar tiempo a lo largo de la vida de un proyecto. La actualización acumulativa 2 permite la creación y modificación de archivos .hidx a través de PowerShell.

Tenga en cuenta que la versión de 32 bits de PowerShell debe usarse porque se llaman los componentes de Designer de Visual Studio de 32 bits. Si se usa la versión de 64 bits de PowerShell, se registra un mensaje de error similar al siguiente:

Nota

El inicializador de tipo para 'Microsoft.HostIntegration.Importer.PowerShell.NewHisWipHidxFile' lanzó una excepción.

Más información

Esta actualización se incluye en la actualización acumulativa 2 para Host Integration Server 2016.

A continuación se muestran 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
  • Poner mensajes en cola

Después de instalar este paquete acumulativo de actualizaciones, puede crear archivos .hidx para cada uno de estos tipos de proyecto a través de PowerShell. Le recomendamos que tenga experiencia al crear archivos .hidx a través de Visual Studio Designer antes de intentar usar PowerShell para crear los archivos.

Para usar PowerShell, abra la Windows PowerShell ISE de 32 bits (x86) y, después, seleccione Mostrar complemento de comando en el menú Ver. En la pestaña Comandos , seleccione el módulo Microsoft.HostIntegration.Importer.PowerShell para mostrar la lista de comandos de PowerShell disponibles.

Ejemplo

Para realizar las siguientes tareas manualmente, siga estos pasos:

  1. Crear un objeto hidx WIP.
  2. Agregue un método denominado GetAccounts.
  3. Agregue un parámetro de 30 caracteres-cadena de entrada denominado CustomerName.
  4. Agregue un parámetro de cadena de 6 caracteres de entrada denominado AccountNum.
  5. Agregue un parámetro decimal de salida denominado Balance que sea PIC S9(7)V99.
  6. Guarde el objeto hidx WIP 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 en 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 Hay scripts de PowerShell de ejemplo adicionales disponibles en GitHub.

Referencias

Obtén información sobre la terminología que Microsoft usa para describir las actualizaciones de software.