התאמה אישית של תבנית טופס באמצעות קובץ script

במאמר זה

• מבט כולל

• שיקולי תאימות

• הגדרת שפת ה-scripting עבור תבנית טופס

• הצג הודעה בכל פעם שמתרחש אירוע

• הוספת קובץ script הפועל כאשר משתמש שומר את נתוני טופס

• הוספת קובץ script הפועל כאשר משתמש שולח את נתוני טופס

• הוספת קובץ script הפועל כאשר משתמש לוחץ על לחצן

• הוספת קובץ script המופעל בעת מיזוג טפסים קיימים

• הוספת קובץ script לעדכון הטפסים הקיימים

• הוספת קובץ script עבור אירועים אחרים

מבט כולל

באפשרותך להתאים אישית את תבנית טופס של InfoPath באמצעות כללים, נוסחאות, אימות נתונים ועיצוב מותנה. למרות תכונות אלה הן גמישות מאד באפשרותך לטפל מגוון רחב של משימות, פעילויות מסוימות הן מעבר היכולות של תכונות אלה. לדוגמה, באפשרותך להשתמש בכללים כדי לשלוח הודעת דואר אלקטרוני כאשר משתמש מזין ערך בתיבת טקסט בטופס. אם עליך לבצע התאמה אישית של תבנית הטופס שלך באופן הנמצא מעבר היכולות של תכונות אלו מכירים כתיבת קבצי script באמצעות שפת ה-JScript או VBScript scripting, תוכל להוסיף קובץ script הפועל כאשר משתמש פותח טופס חדש או שינוי של ex isting טופס המבוסס על תבנית הטופס שלך.

בעת הוספת קובץ script לתבנית טופס, InfoPath מפעיל את Microsoft Script Editor (MSE), אשר מאפשר לך להוסיף, לערוך אותו איתור באגים בקובץ script בתבנית טופס ולאחר מציב את הסמן שלך באירוע שבחרת. InfoPath מוסיף באופן אוטומטי מטפל באירועים בקובץ ה-script. מטפל באירועים הוא קוד הפונקציה בתבנית טופס של InfoPath עליהן משיב פעולת משתמש או שינוי נתוני ה-XML בטופס. לדוגמה, אם ברצונך שהמשתמשים שלך ישמרו את הטפסים שלהם במספר מיקומי רשת, באפשרותך להוסיף קובץ script באירועים OnSaveRequest . בעת הוספת קובץ script לפעול כאשר המשתמש שומר טופס המבוסס על תבנית הטופס שלך, InfoPath מתחילה script editor ומוסיף באחד בקודים הבאים בקובץ ה-script.

//=======
// 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

שיקולי תאימות

אין באפשרותך להוסיף קובץ script תבנית טופס תואמת-דפדפן. באפשרותך להוסיף קובץ script רק לתבנית טופס מילוי טפסים שאת יעשה ב- InfoPath. באפשרותך להתאים אישית תבנית טופס המותאמת לשימוש בדפדפן רק באמצעות קוד מנוהל.

לראש הדף

הגדרת שפת ה-scripting עבור תבנית טופס

כדי להתאים אישית תבנית טופס באמצעות קובץ script, באפשרותך להשתמש ב- Microsoft JScript או ב- Microsoft Visual Basic Scripting Edition (VBScript). כברירת מחדל, InfoPath נקבעה כדי להוסיף קובץ script באמצעות JScript. אם תבנית הטופס שלך אינה מכילה script או קוד מנוהל, אתה מעדיף להשתמש VBScript כשפה scripting שלך, באפשרותך לשנות שפת ה-scripting עבור תבנית הטופס שלך ל- VBScript. לא ניתן להשתמש בשני שפות scripting באותה תבנית טופס.

אם תבנית הטופס מכילה כבר script בשפה אחת וברצונך להשתמש בשפה הרצויה, עליך לשמור את קובץ ה-script קיים כך שלא ניתן להמיר בקובץ ה-script לשפה אחרת, הסר את ה-script מתבנית הטופס בין אפשרויות טופס הדו-שיח תיבה ולאחר מכן הוסף את קובץ ה-script שעבר המרה בחזרה לתבנית טופס. InfoPath אין אפשרות להמיר קבצי script שפת scripting חדשה. שינוי שפת ה-script בתיבת הדו-שיח אפשרויות טופס משפיע רק על תבנית טופס זו. תבניות טפסים אחרים תהיה JScript כברירת מחדל שפת ה-scripting.

1. בתפריט כלים, לחץ על ' אפשרויות טופס '.

2. ברשימה קטגוריה, בתיבת הדו-שיח אפשרויות טופס, לחץ על תיכנות.

3. ברשימה שפת קוד של תבנית הטופס, תחת שפת תיכנות, לחץ על VBScript.

   הערות: 

   • לאחר הגדרת שפת ה-scripting, צור מטפלים באירועים אחד או יותר עבור תבנית טופס, לא ניתן לשנות את שפת ה-scripting עבור תבנית הטופס.

   • אם התקנת Microsoft Visual Studio 2005 Tools for Applications, שפת ברירת המחדל היא Microsoft Visual Basic .NET. באפשרותך עדיין להשתמש בהליך זה כדי לשנות את שפת ה-scripting 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. לפני פרסום של תבנית הטופס לאפשר למשתמשים שלך למלא טפסים המבוססים על תבנית טופס זו, מחק את הקוד שבו השתמשת כדי להציג את תיבת ההודעה.

לראש הדף

הוספת קובץ script הפועל כאשר משתמש שומר את נתוני טופס

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. בצע אחת מהפעולות הבאות או את שתיהן:

   • כדי להוסיף קובץ script המופעל לפני InfoPath שומר את הטופס, החלף את ההערה Write the code to be run before saving here.הקוד שלך.

   • כדי להוסיף קובץ script המופעל לאחר InfoPath שומר את הטופס, החלף את ההערה Write the code to be run after saving here. הקוד שלך.

5. כדי לבדוק את השינויים שלך, לחץ על תצוגה מקדימה בסרגל הכלים רגיל או הקש CTRL+SHIFT+B.

   הערה: אם המטפל באירועים יופעל רק לאחר שאתה יוצר טופס המבוסס על תבנית הטופס שלך, פרסם את תבנית הטופס על-ידי לחיצה על ' פרסם ' בתפריט ' קובץ ' ולאחר מכן השלם את אשף הפרסום. לאחר פרסום תבנית הטופס, צור טופס ולאחר מכן בצע פעולה שתפעיל את המטפל באירועים.

לראש הדף

הוספת קובץ script הפועל כאשר משתמש שולח את נתוני טופס

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.

לראש הדף

הוספת קובץ script הפועל כאשר משתמש לוחץ על לחצן

1. הוספת לחצן חדש לתצוגה בתבנית הטופס ולאחר מכן לחץ פעמיים על הלחצן.

   הערה: אם אתה מוסיף קובץ script ללחצן קיים, לחץ פעמיים על לחצן קיים במקום זאת.

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.

לראש הדף

הוספת קובץ script המופעל בעת מיזוג טפסים קיימים

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. כדי לבדוק את הקוד באירוע זה, פרסם את תבנית הטופס, צור מספר טפסים בהתבסס על תבנית טופס זו ולאחר מכן מזג את תבניות הטפסים.

   הערה: חפש קישורים למידע נוסף אודות פרסום תבנית הטופס שלך בסעיף למידע נוסף.

לראש הדף

הוספת קובץ script לעדכון הטפסים הקיימים

אם עדכנת תבנית טופס שפורסם בעבר, וברצונך לעדכן את הטפסים הקיימים המבוססים על תבנית טופס זו, באפשרותך להוסיף קובץ script לתבנית הטופס המעודכנת הפועל כאשר משתמש פותח אחד מהטפסים הקיימים. כאשר משתמש פותח טופס קיים, 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. כדי לבדוק את הקוד באירוע זה, פרסם את תבנית הטופס, צור מספר טפסים בהתבסס על תבנית טופס זו, לשנות ופרסום גירסה מעודכנת של תבנית הטופס ולאחר מכן פתח טופס קיים בהתבסס על הגירסה הישנה של תבנית טופס זו.

   הערה: חפש קישורים למידע נוסף אודות פרסום תבנית הטופס שלך בסעיף למידע נוסף.

לראש הדף

הוספת קובץ script עבור אירועים אחרים

ניתן להשתמש בהליך זה כדי להוסיף את הבאים באירועים תבנית הטופס שלך:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• OnLoad

• OnSwitchView

• OnSign

• OnValidate

• בתפריט כלים, הצבע על תיכנות, ולאחר מכן לחץ על האירוע להוספה באירועים. Microsoft Script Editor מתחילה כאשר הסמן נמצא המטפל באירועים שבחרת.

• החלף את ההערה Write your code here הקוד שלך.

לראש הדף