新しい PowerShell モジュールは、Host Integration Server でDesigner オブジェクトをプログラムで作成します

適用先
Host Integration Server 2016

概要

ホスト統合サーバーには、バックエンド システムと通信するために HIS ランタイムのさまざまなコンポーネントによって使用される .hidx ファイルの作成を可能にする Visual Studio Designerが含まれています。 Studio Designer を使用した .hidx ファイルの作成は、厳密には手動操作です。 ただし、PowerShell を使用して .hidx ファイルの生成を自動化すると、プロジェクトの有効期間を通じて時間を節約できます。 累積的な更新プログラム 2 では、PowerShell を使用して .hidx ファイルを作成および変更できます。

32 ビット版の Visual Studio Designerのコンポーネントが呼び出されるため、32 ビット バージョンの PowerShell を使用する必要があることに注意してください。 64 ビット バージョンの PowerShell を使用すると、次のようなエラー メッセージがログに記録されます。

注

'Microsoft.HostIntegration.Importer.PowerShell.NewHisWipHidxFile' の型初期化子によって例外がスローされました。

詳細情報

この更新プログラムは、ホスト統合サーバー 2016 の 累積的な更新プログラム 2 に含まれています。

Visual Studio で作成できるホスト統合プロジェクトの種類を次に示します。

  • BizTalk パイプラインの変換
  • ホスト アプリケーション
  • ホスト ファイル
  • メッセージ キュー

この更新プログラムのロールアップがインストールされたら、PowerShell を使用して、これらのプロジェクトの種類ごとに .hidx ファイルを作成できます。 PowerShell を使用してファイルを作成する前に、Visual Studio Designerを使用して .hidx ファイルをビルドする経験があることをお勧めします。

PowerShell を使用するには、ISE (x86) Windows PowerShell 32 ビットを開き、[表示] メニューの [コマンド アドオンの表示] を選択します。 [ コマンド ] タブで、 Microsoft.HostIntegration.Importer.PowerShell モジュールを選択して、使用可能な PowerShell コマンドの一覧を表示します。

使用例

次のタスクを手動で実行するには、次の手順に従います。

  1. WIP hidx オブジェクトを作成します。
  2. GetAccounts という名前のメソッドを追加します。
  3. CustomerName という名前の入力 30 文字の文字列パラメーターを追加します。
  4. AccountNum という名前の入力 6 文字の文字列パラメーターを追加します。
  5. PIC S9(7)V99 である Balance という名前の出力 10 進パラメーターを追加します。
  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 で入手できます。

参考資料

Microsoft がソフトウェア更新プログラムの説明に使用する 用語 について説明します。