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

إذا كنت على دراية بكتابة البرنامج النصي، يمكنك إضافة برنامج نصي إلى قالب نموذج Microsoft Office InfoPath باستخدام لغة البرمجة النصية Microsoft JScript أو Microsoft Visual Basic Scripting Edition (VBScript). تمكنك إضافة برنامج نصي من تخصيص قالب النموذج الخاص بك بما يتجاوز ما هو متوفر مع القواعد أو الصيغ أو التحقق من صحة البيانات أو التنسيق الشرطي. على سبيل المثال، يمكنك إضافة برنامج نصي يقوم بإنشاء رسالة بريد إلكتروني وإرسالها عندما يقوم مستخدم بتبديل طريقة العرض في نموذج استنادا إلى قالب النموذج الخاص بك. يمكنك تكوين قالب نموذج لإنشاء رسالة بريد إلكتروني وإرسالها فقط باستخدام برنامج نصي.

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

• نظرة عامة
• اعتبارات التوافق
• تعيين لغة البرمجة لقالب النموذج
• عرض رسالة في كل مرة يحدث فيها حدث
• إضافة برنامج نصي يتم تشغيله عندما يحفظ المستخدم بيانات النموذج
• إضافة برنامج نصي يتم تشغيله عندما يرسل المستخدم بيانات النموذج
• إضافة برنامج نصي يتم تشغيله عندما ينقر المستخدم فوق زر
• إضافة برنامج نصي يتم تشغيله عند دمج النماذج الموجودة
• إضافة برنامج نصي لتحديث النماذج الموجودة
• إضافة برنامج نصي للأحداث الأخرى

نظرة عامة

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

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

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

يمكنك بعد ذلك إضافة التعليمات البرمجية في الأماكن المناسبة في معالج الأحداث الذي يحفظ النموذج إلى موقع الشبكة المختلفة. عندما يحفظ مستخدم نموذجا استنادا إلى قالب النموذج هذا، يقوم InfoPath بتشغيل التعليمات البرمجية في معالج أحداث OnSaveRequest .

يضيف InfoPath تلقائيا معالجات الأحداث لجميع الأحداث التالية باستثناء واحد منها.

أعلى الصفحة

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

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

أعلى الصفحة

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

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

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

1. في القائمة أدوات ، انقر فوق خيارات النموذج.

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

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

   ملاحظة

   • بعد تعيين لغة البرمجة النصية وإنشاء معالج أحداث واحد أو أكثر لقالب نموذج، لا يمكنك تغيير لغة البرمجة النصية لقالب النموذج.
   • إذا قمت بتثبيت أدوات Microsoft Visual Studio 2005 للتطبيقات، فإن اللغة الافتراضية هي Microsoft Visual Basic .NET. لا يزال بإمكانك استخدام هذا الإجراء لتغيير لغة البرمجة النصية إلى VBScript.

أعلى الصفحة

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

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

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

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

2. لإضافة تعليمة برمجية في JScript، اكتب XDocument.UI.Alert("حدث اسم الحدث الذي تم تشغيله للتو")؛ استبدل باسم معالج الأحداث الخاص بك. على سبيل المثال، إذا أضفت هذه التعليمة البرمجية إلى معالج أحداث OnValidate ، فستكتب XDocument.UI.Alert("The OnValidate event handler just ran")؛

3. لإضافة تعليمة برمجية في VBScript، اكتب XDocument.UI.Alert("حدث اسم الحدث تم تشغيله للتو") على سبيل المثال، إذا أضفت هذه التعليمة البرمجية إلى معالج أحداث OnSaveRequest ، فستكتب XDocument.UI.Alert("The OnSaveRequest event handler just ran")

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 بالمؤشر في معالج أحداث OnClick لهذا الزر.
   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
• OnContextChange
• Onload
• OnSwitchView
• OnSign
• OnValidate
• في القائمة أدوات ، أشر إلى البرمجة، ثم انقر فوق الحدث لإضافته إلى معالج الحدث. يبدأ Microsoft Script Editor بالمؤشر في معالج الأحداث الذي حددته.
• استبدل التعليق Write your code here بالتعليمات البرمجية الخاصة بك.

أعلى الصفحة