אוסף פקדים (חומר עזר עבור API של לקוח)

השתמש באוסף controls כדי לגשת לפקדים המשויכים לעמודות.

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

לדוגמה, כדי להוסיף הודעה לכל פקד המאוגד לעמודה name , השתמש בקוד הבא:

const notification = {
    messages: ['Sample Notification on Name Controls'],
    notificationLevel: 'RECOMMENDATION',
    uniqueId: 'my_unique_id'
 };
 
formContext.getAttribute("name").controls.forEach(control =>
    control.addNotification(notification)
 );

מאחר שכל עמודה עשויה להופיע יותר מפעם אחת בדף, אוסף הפקדים מספק גישה לכל הפקדים המייצגים עמודה זו. אם העמודה מיוצגת על-ידי פקד אחד בלבד בדף, האורך של אוסף זה הוא 1.

בעת שימוש בפעולת השירות getName של הפקד, שם הפקד הראשון תואם לשם העמודה. המופע השני של פקד עבור עמודה זו הוא <columnName>1. <columnName>+N התבנית ממשיכה עבור כל פקד נוסף שנוסף לטופס עבור עמודה ספציפית.

כאשר טופס מציג פקד זרימת תהליך עסקי בכותרת העליונה, הוא מוסיף פקדים עבור כל עמודה שמופיעה בזרימת התהליך העסקי. לפקדים אלה יש שם ייחודי, כגון: header_process_<column name>.

עמודות (חומר עזר עבור API של לקוח)