تنشئ وحدة PowerShell النمطية الجديدة برمجيا كائنات Designer في خادم تكامل المضيف

ينطبق على
Host Integration Server 2016

الملخص

يتضمن خادم تكامل المضيف Designer Visual Studio لتمكين إنشاء ملفات .hidx التي تستخدمها مكونات مختلفة من وقت تشغيل HIS للاتصال بالأنظمة الخلفية. يعد إنشاء ملفات .hidx من خلال Studio Designer عملية يدوية بدقة. ومع ذلك، يمكن أن يوفر أتمتة إنشاء ملفات .hidx من خلال PowerShell الوقت طوال عمر المشروع. يتيح التحديث التراكمي 2 إنشاء ملفات .hidx وتعديلها من خلال PowerShell.

لاحظ أنه يجب استخدام إصدار 32 بت من PowerShell لأنه يتم استدعاء مكونات Designer Visual Studio 32 بت. إذا تم استخدام إصدار 64 بت من PowerShell، يتم تسجيل رسالة خطأ تشبه ما يلي:

ملاحظة

قام تهيئة النوع ل 'Microsoft.HostIntegration.Importer.PowerShell.NewHisWipHidxFile' بطرح استثناء.

معلومات إضافية

يتم تضمين هذا التحديث في التحديث التراكمي 2 ل Host Integration Server 2016.

فيما يلي أنواع مشاريع تكامل المضيف التي يمكن إنشاؤها في Visual Studio:

  • تحويل البنية الأساسية لبرنامج ربط العمليات التجارية BizTalk
  • التطبيقات المضيفة
  • ملفات المضيف
  • وضع الرسائل في قائمة الانتظار

بعد تثبيت مجموعة التحديث هذه، يمكنك إنشاء ملفات .hidx لكل نوع من أنواع المشاريع هذه من خلال PowerShell. نوصي بأن يكون لديك بعض الخبرة في إنشاء ملفات .hidx من خلال Visual Studio Designer قبل محاولة استخدام PowerShell لإنشاء الملفات.

لاستخدام PowerShell، افتح Windows PowerShell 32 بت ISE (x86)، ثم حدد إظهار الوظيفة الإضافية للأمر في القائمة عرض. في علامة التبويب الأوامر ، حدد الوحدة النمطية Microsoft.HostIntegration.Importer.PowerShell لعرض قائمة أوامر PowerShell المتوفرة.

مثال

لتنفيذ المهام التالية يدويا، اتبع الخطوات التالية:

  1. إنشاء كائن WIP hidx.
  2. أضف أسلوبا يسمى GetAccounts.
  3. أضف معلمة إدخال سلسلة مكونة من 30 حرفا تسمى CustomerName.
  4. أضف معلمة سلسلة إدخال مكونة من 6 أحرف تسمى AccountNum.
  5. أضف معلمة عشرية للإخراج تسمى Balance وهي 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.

المراجع

تعرف على المصطلحات التي تستخدمها Microsoft لوصف تحديثات البرامج.