הערה
גישה לעמוד זה דורשת אישור. אתה יכול לנסות להיכנס או לשנות תיקיות.
גישה לעמוד זה דורשת אישור. אתה יכול לנסות לשנות מדריכים.
אירועים מפעילים את כל הקוד בצד הלקוח. ביישומים מונחי-דגמים, עליך לשייך פונקציה ספציפית בספריית JavaScript (משאב אינטרנט של Script) להתבצע כאשר מתרחש אירוע. פונקציה זו נקראת מטפל באירועים. כל מטפל באירועים מציין פונקציה בודדת בתוך ספריית JavaScript וכל פרמטר שניתן להעביר לפונקציה.
באפשרותך לשייך מטפלים באירועים לאירועים מסוימים בלבד באמצעות ממשק המשתמש. עבור אירועים שאינם זמינים לשיוך באמצעות ממשק משתמש, Client API מספק שיטות שניתן להשתמש בהן כדי לצרף מטפלים באירועים לאירועים אלה.
הוספה או הסרה של פונקציית המטפל באירועים לאירוע באמצעות ממשק משתמש
השתמש במקטע המטפלים באירועים של תיבת הדו-שיח מאפייני טופס כדי לשייך את קובץ ה- Script לאירוע עבור טפסים ועמודות.
עריכת טפסים בצובר
כברירת מחדל, לא מתבצעת קריאה למטפלים באירועים כאשר טופס נמצא במצב עריכה בצובר.
כדי להפוך מטפל באירועים לזמין במצב עריכה בצובר, שנה את ה- XML event של טופס על-ידי איתור הרכיב הרלוונטי ויצירה/הגדרה של BehaviorInBulkEditForm התכונה ל- Enabled. בשלב זה, אפשרות זו נתמכת רק עבור אירועי OnLoad.
לקבלת מידע נוסף אודות התאמה אישית של XML בטופס, ראה מתי לערוך את קובץ ההתאמות האישיות, התאמה אישית של טפסיםוסכימת XML של טופס.
כדי לקבוע מתי מטפל באירועים נקרא בטופס בפעולת שירות לשימוש במצב עריכה בצובר getFormType .
הוספה או הסרה של פונקציית המטפל באירועים לאירוע באמצעות קוד
השתמש בשיטות הבאות כדי להוסיף ולהסיר מטפל באירועים עבור אירועים שלא ניתן לשייך באמצעות ממשק המשתמש:
| Events | מטפל באירועים |
|---|---|
| תכונה OnChange | פעולות שירות addOnChangeו- removeOnChange |
| טופס OnLoad | פעולות שירות של formContext.ui addOnLoadו- removeOnLoad |
| טופס נטען | formContext.ui addLoaded and removeLoaded methods |
| נתוני טופס ב- OnLoad | פעולות שירות formContext.data addOnLoadו- removeOnLoad |
| טופס בעת שמירה | פעולות שירות addOnSaveו- removeOnSave |
| חיפוש מוקדם של פקד בדיקת מידע | הוספת פעולות שירות שלPreSearchוהסרה של פעולות שירות שלPreSearch |
| פקד kbsearch OnResultOpened | addOnResultOpened ו- removeOnResultOpened שיטות |
| שליטה ב- kbsearch OnSelection | פעולות שירות addOnSelectionו- removeOnSelection |
| חיפוש בפקד kbsearch | addOnPostSearch and removeOnPostSearch methods |
חשוב
הקשר הביצוע מועבר באופן אוטומטי כפרמטר הראשון לפונקציות מוגדרות באמצעות הקוד. מידע נוסף: הקשר ביצוע API של לקוח
צינור אירוע טופס
באפשרותך להגדיר עד 50 מטפלים באירועים עבור כל אירוע. כל מטפל באירועים מבוצע בסדר שבו הוא מוצג במקטע המטפלים באירועים בכרטיסיה אירועים של תיבת הדו-שיח מאפייני טופס.
השתמש בפעולות השירות setSharedVariable וקבל את השיטותSharedVariable כדי להעביר משתנה משותף בין מטפלים באירועים (פונקציות). השתמש בפעולת השירות getDepth של הקשר הביצוע כדי לדעת את הרצף שבו מטפל באירועים מבוצע ביחס למטפלים באירועים אחרים.
מאמרים קשורים
הבנת מודל האובייקטים של API של הלקוח
הקשר ביצוע API של לקוח
אירועים (חומר עזר עבור API של לקוח)