تخصيص قالب نموذج ب# استخدام برنامج نصي

في هذه المقالة

• نظره عامه

• اعتبارات التوافق

• تعيين لغه البرمجه ل# قالب نموذج

• عرض رساله في كل مره يحدث فيها حدث

• اضافه برنامج نصي يعمل عندما يقوم مستخدم ب# حفظ بيانات النموذج

• اضافه برنامج نصي يتم تشغيله عند قيام مستخدم ب# ارسال بيانات النموذج

• اضافه برنامج نصي يتم تشغيله عند قيام مستخدم ب# النقر الزر

• اضافه برنامج نصي يتم تشغيله عند دمج النماذج الموجوده

• اضافه برنامج نصي ل# تحديث النماذج الموجوده

• اضافه برنامج نصي ل# احداث اخري

نظرة عامة

يمكنك تخصيص قالب نموذج InfoPath ب# استخدام القواعد، و# الصيغ و# التحقق من صحه البيانات و# التنسيق الشرطي. علي الرغم من ان هذه الميزات مرنه جدا و# يمكنك التعامل مع مجموعه واسعه من المهام، تكون بعض المهام ب# الاضافه الي قدرات هذه الميزات. علي سبيل المثال، لا يمكنك استخدام القواعد ل# ارسال رساله بريد الكتروني عند قيام مستخدم ب# ادخال قيمه في مربع نص في نموذج. اذا كنت تحتاج الي تخصيص قالب النموذج ب# الطريقه التي يتم تتجاوز امكانيات هذه الميزات و# التي تجيد استخدامها ب# البرمجه النصيه ب# استخدام لغه البرمجه النصيه JScript او VBScript، ف# يمكنك اضافه برنامج نصي يتم تشغيله عند فتح نموذج جديد مستخدم او تعدل ex نموذج إيستينج يستند الي قالب النموذج الخاص بك.

عند اضافه برنامج نصي ل# قالب نموذج، يبدا تشغيل Microsoft Script Editor (MSE)، مما يسمح لك ب# اضافه و# تحريرها و# تصحيح تعليمات برنامج نصي في قالب نموذج InfoPath و# يقوم ب# وضع المؤشر في الحدث الذي تختاره. يقوم InfoPath ب# اضافه معالج احداث ل# البرنامج النصي. معالج احداث هو رمز الداله في قالب نموذج InfoPath يستجيب ل# اجراء مستخدم او تغيير بيانات XML في نموذج. علي سبيل المثال، اذا اردت ان يقوم المستخدمون ب# حفظ النماذج الخاصه بهم الي مواقع متعدده علي الشبكه، يمكنك اضافه برنامج نصي ل# معالج الحدث OnSaveRequest . عند اضافه برنامج نصي ل# تشغيله عند قيام المستخدم ب# حفظ نموذج يستند الي قالب النموذج الخاص بك، يبدا تشغيل محرر البرامج النصيه InfoPath و# يضيف احد الرموز التاليه ل# البرنامج النصي.

//=======
// The following function handler is created by Microsoft Office InfoPath.
// Do not modify the name of the function, or the name and number of arguments.
//=======
function XDocument::OnSaveRequest(eventObj)
{
   // Write the code to be run before saving here.
   eventObj.IsCancelled = eventObj.PerformSaveOperation();
   // Write the code to be run after saving here.
   eventObj.ReturnStatus = true;
}

'=======
' The following function handler is created by Microsoft Office InfoPath.
' Do not modify the name of the function, or the name and number of arguments.
'=======
Sub XDocument_OnSaveRequest(eventObj)
' Write the code to be run before saving here.
eventObj.IsCancelled = eventObj.PerformSaveOperation
' Write the code to be run after saving here.
eventObj.ReturnStatus = True
End Sub

اعتبارات التوافق

لا يمكنك اضافه برنامج نصي ل قالب النموذج المتوافق مع المستعرض. يمكنك اضافه برنامج نصي ل# قالب نموذج تعبئه النماذج الخاصه به في InfoPath فقط. يمكنك تخصيص قالب نموذج متوافق مع المستعرض ب# استخدام تعليمات برمجيه تمت ادارتها فقط.

اعلي الصفحه

تعيين لغة البرمجة لقالب النموذج

ل# تخصيص قالب نموذج ب# استخدام برنامج نصي، يمكنك استخدام اما Microsoft JScript او Microsoft Visual Basic Scripting Edition (VBScript). ب# شكل افتراضي، يتم تكوين InfoPath ل# اضافه برنامج نصي ب# استخدام JScript. اذا كان قالب النموذج الخاص بك لا يحتوي علي اي برنامج نصي او تعليمات برمجيه مداره، و# كنت تفضل استخدام VBScript ك# لغه البرمجه النصيه، يمكنك تغيير لغه البرمجه ل# قالب النموذج الخاص بك الي VBScript. لا يمكنك استخدام كل من لغات البرمجه النصيه في نفس قالب النموذج.

اذا كان يحتوي قالب النموذج ب# الفعل علي البرنامج النصي في لغه واحده و# كنت تريد استخدام لغه اخري، تحتاج الي حفظ البرنامج النصي موجود ب# حيث يمكنك تحويل البرنامج النصي ل# اللغه اخري، ازاله البرنامج النصي من قالب النموذج عبر خيارات النموذج حوار مربع ثم قم ب# اضافه برنامج نصي تم تحويله الي قالب النموذج. يتعذر تحويل InfoPath البرامج النصيه الي لغه البرمجه نصيه جديده. يؤثر تغيير لغه البرمجه النصيه في مربع الحوار خيارات النموذج علي قالب النموذج هذا فقط. سيكون قوالب نماذج اخري JScript ك# لغه البرمجه النصيه.

1. علي القائمه ادوات، انقر فوق " خيارات النموذج ".

2. في القائمه الفئه، في مربع الحوار خيارات النموذج، انقر فوق البرمجه.

3. في القائمه لغه التعليمات البرمجيه ل# قالب النموذج، ضمن لغه البرمجه، انقر فوق VBScript.

   ملاحظات: 

   • بعد تعيين لغه البرمجه و# انشاء معالجات الاحداث واحد او اكثر ل# قالب نموذج، لا يمكنك تغيير لغه البرمجه ل# قالب النموذج.

   • اذا قمت ب# تثبيت Microsoft Visual Studio 2005 Tools for Applications، اللغه الافتراضيه هي Microsoft Visual Basic .NET. سيظل ب# امكانك استخدام هذا الاجراء الي تغيير لغه البرمجه النصيه الي VBScript.

اعلي الصفحه

عرض رساله في كل مره يحدث فيها حدث

اذا اردت التعرف علي معالجات الاحداث تشغيل استجابه ل# اجراء او حدث اخر، يمكنك اضافه رمز المؤقته ل# عرض مربع رساله كلما تشغيل معالج الاحداث. يجب ان استخدم هذا الرمز فقط ل# تحديد عند تشغيل معالج احداث. بعد اضافه هذه التعليمات البرمجيه، يمكنك استخدام معاينه ل# عرض نموذج يستند الي قالب النموذج هذا او ل# نشر قالب النموذج ثم قم ب# انشاء قالب نموذج جديد. تعمل بعض معالجات الحدث فقط اذا قمت ب# انشاء نموذج بعد نشر قالب النموذج. يمكنك تنفيذ اجراء تعتقد انه قد يتم تشغيل معالج الحدث ثم. عندما يتم تشغيل معالج الاحداث، ستري مربع رساله.

بعد ان تحدد الاجراءات او تشغيل احداث معالج الاحداث، ازاله التعليمات البرمجيه و# ثم سيره ذاتيه ب# تصميم قالب النموذج. اذا لا تقم ب# ازاله هذا الرمز و# قمت ب# نشر قالب النموذج، سيشاهد المستخدمون مربع الرساله هذا عند تشغيل معالج الاحداث.

1. اضف معالج الاحداث الخاص بك.

2. ل# اضافه رمز في JScript، اكتب XDocument.UI.Alert ("الحدث ل# التو تم تشغيل اسم")؛ استبدل اسم معالج الاحداث الخاص بك. علي سبيل المثال، اذا اضفت هذا الرمز الي معالج الاحداث OnValidate ، اكتب XDocument.UI.Alert ("OnValidate معالج الاحداث ب# تشغيلها")؛

3. ل# اضافه التعليمات البرمجيه في VBScript، اكتب XDocument.UI.Alert ("الحدث ل# التو تم تشغيل اسم") علي سبيل المثال، اذا قمت ب# اضافه هذا الرمز الي معالج الاحداث OnSaveRequest ، عليك كتابه XDocument.UI.Alert ("OnSaveRequest معالج الاحداث ب# تشغيلها")

4. ل# اختبار التعليمات البرمجيه، انقر فوق معاينه علي القائمه " ملف "، او اضغط علي CTRL + SHIFT + B، و# قم ب# تنفيذ اجراء مستخدم من خلالها بدء الحدث. عند حدوث الحدث ب# استخدام خط التعليمات البرمجيه، يجب ان يعرض مربع رساله رسالتك.

   ملاحظة: قد يتطلب بعض الاحداث ل# نشر قالب النموذج و# قم ب# انشاء نموذج يستند الي قالب النموذج هذا قبل تنفيذ اجراء مستخدم ل# بدء الحدث.

5. قبل نشر قالب النموذج و# تمكين المستخدمين من تعبئه النماذج التي تستند الي قالب النموذج، احذف التعليمه البرمجيه التي يمكنك استخدامها ل# عرض مربع الرساله.

اعلي الصفحه

اضافه برنامج نصي يعمل عندما يقوم مستخدم ب# حفظ بيانات النموذج

1. علي القائمه ادوات، انقر فوق " خيارات النموذج ".

2. في القائمه الفئه، في مربع الحوار خيارات النموذج، انقر فوق فتح و# حفظ.

3. ضمن سلوك الحفظ، حدد خانه الاختيار حفظ استخدام تعليمات برمجيه مخصصه، و# من ثم انقر فوق تحرير. Microsoft Script Editor يبدا ب# وضع المؤشر في معالج الاحداث OnSaveRequest .

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnSaveRequest(eventObj)
   {
      // Write the code to be run before saving here.
      eventObj.IsCancelled = eventObj.PerformSaveOperation();
      // Write the code to be run after saving here.
      eventObj.ReturnStatus = true;
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnSaveRequest(eventObj)
   ' Write the code to be run before saving here.
   eventObj.IsCancelled = eventObj.PerformSaveOperation
   ' Write the code to be run after saving here.
   eventObj.ReturnStatus = True
   End Sub
   

4. قم بتنفيذ أحد الإجراءين التاليين أو كليهما:

   • ل# اضافه برنامج نصي يعمل قبل ان يقوم InfoPath ب# حفظ النموذج، استبدل تعليق Write the code to be run before saving here.التعليمات البرمجيه الخاصه بك.

   • ل# اضافه برنامج نصي يعمل بعد حفظ InfoPath النموذج، استبدل تعليق Write the code to be run after saving here. التعليمات البرمجيه الخاصه بك.

5. لاختبار التغييرات، انقر فوق معاينة على شريط الأدوات قياسي، أو اضغط على CTRL+SHIFT+B.

   ملاحظة: في حاله تشغيل معالج الاحداث فقط بعد انشاء نموذج يستند الي قالب النموذج الخاص بك، نشر قالب النموذج عن طريق النقر فوق " نشر " في القائمه ملف، و# من ثم اكمال "معالج النشر". بعد نشر قالب النموذج، قم ب# انشاء نموذج ثم قم ب# تنفيذ اجراء ل# تشغيل معالج الاحداث.

اعلي الصفحه

اضافه برنامج نصي يتم تشغيله عند قيام مستخدم ب# ارسال بيانات النموذج

1. علي القائمه ادوات، انقر فوق خيارات الارسال.

2. في مربع الحوار خيارات الارسال، حدد خانه الاختيار السماح ل# المستخدمين ب# ارسال هذا النموذج.

3. انقر فوق تنفيذ اجراء مخصص ب# استخدام التعليمات البرمجيه، و# من ثم انقر فوق تحرير التعليمات البرمجيه. Microsoft Script Editor يبدا ب# وضع المؤشر في معالج الاحداث OnSubmitRequest .

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnSubmitRequest(eventObj)
   {
      // If the submit operation is successful, set
      // eventObj.ReturnStatus = true;
      // Write your code here
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnSubmitRequest(eventObj)
   ' If the submit operation is successful, set
   ' eventObj.ReturnStatus = True
   ' Write your code here
   End Sub
   

4. استبدل التعليق If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here التعليمات البرمجيه الخاصه بك.

5. لاختبار التغييرات، انقر فوق معاينة على شريط الأدوات قياسي، أو اضغط على CTRL+SHIFT+B.

اعلي الصفحه

اضافه برنامج نصي يتم تشغيله عند قيام مستخدم ب# النقر الزر

1. اضافه زر جديد الي طريقه عرض في قالب النموذج، و# من ثم انقر نقرا مزدوجا فوق الزر.

   ملاحظة: اذا كنت تقوم ب# اضافه برنامج نصي الي زر موجود، انقر نقرا مزدوجا فوق الزر الموجود بدلا من ذلك.

2. انقر فوق علامة التبويب عام.

3. انقر فوق تحرير التعليمات البرمجيه ل# النموذج. Microsoft Script Editor يبدا ب# وضع المؤشر في معالج الاحداث عند _ النقر ل# هذا الزر.

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function Button Name::OnClick(eventObj)
   {
   // Write your code here
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub Button Name_OnClick(eventObj)
   ' Write your code here
   End Sub
   

4. استبدل التعليق Write your code here التعليمات البرمجيه الخاصه بك.

5. لاختبار التغييرات، انقر فوق معاينة على شريط الأدوات قياسي، أو اضغط على CTRL+SHIFT+B.

اعلي الصفحه

اضافه برنامج نصي يتم تشغيله عند دمج النماذج الموجوده

1. علي القائمه ادوات، انقر فوق " خيارات النموذج ".

2. في القائمه الفئه، في مربع الحوار خيارات النموذج، انقر فوق خيارات متقدمه.

3. ضمن دمج النماذج، حدد خانه الاختيار تمكين دمج النماذج.

4. حدد خانه الاختيار دمج استخدام تعليمات برمجيه مخصصه، و# من ثم انقر فوق تحرير. Microsoft Script Editor يبدا ب# وضع المؤشر في معالج الحدث OnMergeRequest .

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnMergeRequest(eventObj)
   {
   // Write the code that handles each form being merged here.
   XDocument.ImportDOM(eventObj.DOM);
   eventObj.ReturnStatus = true;
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnMergeRequest(eventObj)
   ' Write the code that handles each form being merged here.
   XDocument.ImportDOM(eventObj.DOM)
   eventObj.ReturnStatus = True
   End Sub
   

5. استبدل التعليق Write the code that handles each form being merged here. التعليمات البرمجيه الخاصه بك.

6. ل# اختبار التعليمه البرمجيه في هذا الحدث، نشر قالب النموذج و# انشاء نماذج متعدده تستند الي قالب النموذج و# قم ب# دمج قوالب النماذج.

   ملاحظة: توجد ارتباطات تؤدي الي مزيد من المعلومات حول نشر قالب النموذج الخاص بك في القسم انظر ايضا.

اعلي الصفحه

اضافه برنامج نصي ل# تحديث النماذج الموجوده

اذا قمت ب# تحديث قالب نموذج سبق ان تم نشرها، و# كنت تريد تحديث النماذج الموجوده يستند الي قالب النموذج، ف# يمكنك اضافه برنامج نصي ل# قالب النموذج المحدث يتم تشغيله عند قيام مستخدم ب# فتح احد النماذج الموجوده. عند قيام مستخدم ب# فتح نموذج موجود، يتحقق InfoPath رقم اصدار قالب النموذج علي موقع النشر. اذا كان رقم اصدار قالب النموذج علي موقع النشر احدث من رقم اصدار في النموذج الموجود، تشير الي انه قد تم تحديث، InfoPath ب# تشغيل التعليمه البرمجيه ل# هذا الحدث الي تحديث النموذج الموجود.

1. علي القائمه ادوات، انقر فوق " خيارات النموذج ".

2. في القائمه الفئه، في مربع الحوار خيارات النموذج، انقر فوق تعيين الاصدار.

3. في القائمه عند ترقيه الاصدار، انقر فوق استخدام حدث مخصص، و# من ثم انقر فوق تحرير. Microsoft Script Editor يبدا ب# وضع المؤشر في معالج الحدث OnVersionUpgrade .

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnVersionUpgrade(eventObj)
   {
   // Write your code here
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnVersionUpgrade(eventObj)
   ' Write your code here
   End Sub
   

4. استبدل التعليق Write your code here التعليمات البرمجيه الخاصه بك.

5. ل# اختبار التعليمه البرمجيه في هذا الحدث، و# نشر قالب النموذج، و# انشاء نماذج متعدده تستند الي قالب النموذج و# تعديلها و# نشر اصدار محدث من قالب النموذج و# قم ب# فتح نموذج استنادا الي الاصدار القديم من قالب النموذج.

   ملاحظة: توجد ارتباطات تؤدي الي مزيد من المعلومات حول نشر قالب النموذج الخاص بك في القسم انظر ايضا.

اعلي الصفحه

اضافه برنامج نصي ل# احداث اخري

يمكنك استخدام هذا الاجراء ل# اضافه معالجات الاحداث التاليه الي قالب النموذج الخاص بك:

• OnAfterChange

• OnBeforeChange

• أونكونتيكستشانجي

• عند _ التحميل

• أونسويتشفيو

• OnSign

• OnValidate

• علي القائمه ادوات، اشر الي البرمجه، و# من ثم انقر فوق الحدث ل# اضافته الي معالج الاحداث. Microsoft Script Editor يبدا ب# وضع المؤشر في معالج الاحداث التي حددتها.

• استبدل التعليق Write your code here التعليمات البرمجيه الخاصه بك.

اعلي الصفحه