Ringkasan
Host Integration Server menyertakan Designer Visual Studio untuk mengaktifkan pembuatan file .hidx yang digunakan oleh berbagai komponen runtime HIS untuk berkomunikasi dengan sistem back-end. Pembuatan file .hidx melalui Studio Designer benar-benar merupakan operasi manual. Namun, mengotomatisasi pembuatan file .hidx melalui PowerShell dapat menghemat waktu selama masa pakai proyek. Pembaruan Kumulatif 2 memungkinkan pembuatan dan modifikasi file .hidx melalui PowerShell.
Perhatikan bahwa PowerShell versi 32-bit harus digunakan karena komponen visual Studio 32-bit Designer disebut. Jika PowerShell versi 64-bit digunakan, pesan kesalahan yang menyerupai berikut ini dicatat:
Catatan
Tipe inisializer untuk 'Microsoft.HostIntegration.Importer.PowerShell.NewHisWipHidxFile' melempar pengecualian.
Informasi selengkapnya
Pembaruan ini disertakan dalam Pembaruan Kumulatif 2 untuk Server Integrasi Host 2016.
Berikut ini adalah jenis Proyek Integrasi Host yang dapat dibuat di Visual Studio:
- Konversi saluran BizTalk
- Aplikasi host
- File host
- Antrean pesan
Setelah rollup pembaruan ini diinstal, Anda bisa membuat file .hidx untuk setiap tipe proyek ini melalui PowerShell. Kami menyarankan Agar Anda memiliki pengalaman dalam menyusun file .hidx melalui Visual Studio Designer sebelum mencoba menggunakan PowerShell untuk membuat file.
Untuk menggunakan PowerShell, buka ISE Windows PowerShell 32-bit (x86), lalu pilih Perlihatkan Add-on Perintah pada menu Tampilan. Pada tab Perintah , pilih modul Microsoft.HostIntegration.Importer.PowerShell untuk menampilkan daftar perintah PowerShell yang tersedia.
Contoh
Untuk melakukan tugas berikut secara manual, ikuti langkah-langkah ini:
- Membuat objek hidx WIP.
- Tambahkan metode yang bernama GetAccounts.
- Tambahkan parameter input 30-character-string yang bernama CustomerName.
- Tambahkan parameter string input 6 karakter yang bernama AccountNum.
- Tambahkan parameter desimal output yang dinamai Saldo yaitu PIC S9(7)V99.
- Simpan objek hidx WIP sebagai file. File hidx disimpan di C:\Lab. Ketahuilah bahwa folder harus ada agar dapat membuat objek $WIPhidx.
Untuk mengotomatisasi tugas ini, jalankan skrip berikut di 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()
Catatan Contoh tambahan skrip PowerShell tersedia di GitHub.
Referensi
Pelajari tentang terminologi yang digunakan Microsoft untuk menjelaskan pembaruan perangkat lunak.