הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
קבלת פקד בטופס.
הערה
getControl פועל רק בפקדים בגוף הטופס ובכותרת העליונה. הוא אינו נתמך עבור פקדים במקום אחר בעמוד, גם אם הם מפנים לאותה עמודה.
- עבור פקדים בתוך זרימות תהליכים עסקיים, עיין בהם באמצעות הקידומת
header_process_. - פקדים בתוך פקדים אחרים , כגון ברשתות משנהופקדי ציר זמן, אינם נתמכים.
תחביר
formContext.getControl(arg);
פעולת השירות formContext.getControl(arg) היא שיטת קיצור לגישה אל formContext.ui.controls.get.
פרמטר
arg: אופציונלי. באפשרותך לגשת לפקד בטופס על-ידי העברת ארגומנט כשם או כערך האינדקס של הפקד בטופס. לדוגמה: formContext.getControl("firstname") או formContext.getControl(0) אם השם arg מאוית באופן שגוי ולא מופיע בטופס, הוא מחזיר ערך Null.
arg כאשר הערך אינו מסופק, הוא מחזיר מערך של כל הפקדים בטופס.
ערך החזרה
סוג: אוסף אובייקטים, אובייקט או Null.
תיאור: אוסף אובייקטים אם אתה משתמש בפעולת השירות ללא פרמטרים. אובייקט או Null אם אתה משתמש בפעולת השירות עם פרמטר. אם אתה משתמש בשם בפרמטר וישנם פקדים מרובים עבור אותה עמודה, מוחזר רק הפקד הראשון.
עצה
אם ברצונך לשנות את כל הפקדים המאוגדים לעמודה בטופס, השתמש באוסף הפקדים שבתוך סוג העמודה.
לדוגמה, כדי להוסיף הודעה לכל פקד המאוגד לעמודה name , באפשרותך לבצע את הפעולות הבאות:
const notification = {
messages: ['Sample Notification on Name Controls'],
notificationLevel: 'RECOMMENDATION',
uniqueId: 'my_unique_id'};
formContext.getAttribute("name").controls.forEach(control => control.addNotification(notification));