Новий модуль PowerShell програмно створює Designer об'єкти на сервері інтеграції хостів

Застосовується до
Host Integration Server 2016

Зведення

Host Integration Server містить Designer Visual Studio, що дає змогу створювати файли HIDX, які використовуються різними компонентами середовища виконання HIS для обміну даними із серверною системою. Створення .hidx-файлів через Studio Designer є виключно ручною операцією. Однак автоматизування створення файлів HIDX за допомогою PowerShell може заощадити час на виконання проекту. Сукупний пакет оновлень 2 дає змогу створювати та змінювати файли HIDX за допомогою PowerShell.

Зверніть увагу, що 32-розрядну версію PowerShell слід використовувати, оскільки викликаються компоненти 32-розрядної версії Visual Studio Designer. Якщо використовується 64-розрядна версія PowerShell, реєструється повідомлення про помилку приблизно такого вигляду:

Примітка.

Ініціалізатор типів для "Microsoft.HostIntegration.Importer.PowerShell.NewHisWipHidxFile" кинув виняток.

Додаткові відомості

Це оновлення входить до сукупного пакета оновлень 2 для Host Integration Server 2016.

Нижче наведено типи проектів інтеграції хостів, які можна створити у Visual Studio:

  • BizTalk pipeline conversion
  • Хост-програми
  • Host files
  • Черга повідомлень

Після інсталяції цього зведеного оновлення можна створити файли HIDX для кожного з цих типів проектів за допомогою PowerShell. Перш ніж створювати файли за допомогою PowerShell, радимо створити файли HIDX через Visual Studio Designer.

Щоб використовувати PowerShell, відкрийте 32-розрядну Windows PowerShell ISE (x86), а потім у меню View (Вигляд) виберіть Show Command Add-on (Показати додатковий компонент команди). На вкладці Команди виберіть модуль Microsoft.HostIntegration.Importer.PowerShell , щоб відобразити список доступних команд PowerShell.

Приклад

Щоб виконати наведені нижче завдання вручну, виконайте такі дії:

  1. Створіть об'єкт WIP hidx.
  2. Додайте метод з іменем GetAccounts.
  3. Додайте вхідний 30-символьний рядок із іменем CustomerName.
  4. Додайте вхідний 6-значний параметр рядка з іменем AccountNum.
  5. Додайте вихідний десятковий параметр з іменем Баланс , тобто PIC S9(7)V99.
  6. Збережіть об'єкт WIP hidx як файл. Файл hidx збережено в папці C:\Lab. Пам'ятайте, що папка має існувати, щоб мати змогу створювати об'єкт $WIPhidx.

Щоб автоматизувати ці завдання, виконайте наведений нижче сценарій у 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()

Примітка Додаткові приклади сценаріїв PowerShell доступні на GitHub.

Посилання

Дізнайтеся про термінологію , яка використовується корпорацією Майкрософт для опису оновлень програмного забезпечення.