רכיב Checkbox

מידע

רכיב Checkbox מותקן על סוג אובייקט ב-Fireberry. לכל אובייקט שדות ומקטעים משלו — שדות שיוצרים בלידים לא משותפים לאנשי קשר, למשל.

איך זה עובד

כשמוסיפים שדה סימון חדש, הרכיב יוצר מאחורי הקלעים שדה picklist ב-Fireberry. שם השדה מתחיל ב-pcfpingmee ואחריו מזהה השדה (למשל pcfpingmeeApproved).

כל סימון הוא שדה נפרד על הרשומה:

• מסומן → ערך picklist שמוגדר כפעיל (ברירת מחדל לשדות חדשים: 1)
• לא מסומן → ערך picklist שמוגדר ככבוי (ברירת מחדל: 2)

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

מנוי חינמי

במנוי חינמי של הארגון, רכיב Checkbox זמין עם מגבלה אחת: ניתן לסמן עד שני צ׳קבוקסים בכל רשומה. ביטול סימון עדיין אפשרי. ניסיון לסמן שלישי פותח חלון שדרוג עם קישור להגדרות המנוי — מצב הצ׳קבוקס לא משתנה.

במנוי ניסיון או בתשלום (Active) אין מגבלה לפי רשומה. אם תקופת הניסיון פגה, הרכיב מציג שכבת שדרוג מלאה במקום חוויית המנוי החינמי המוגבלת.

שימוש בשדות picklist קיימים

הרכיב לא מוגבל לשדות שהוא יוצר בעצמו. בפתיחת הגדרות, הוא טוען מ-Fireberry את כל שדות ה-picklist שכבר קיימים על האובייקט — גם אם נוצרו ידנית ב-Object Studio, גם אם יש להם שמות וערכים משלכם.

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

למה צריך להגדיר מסומן ולא מסומן?

שדה picklist ב-Fireberry הוא רשימת אפשרויות — לכל אפשרות יש תווית (למשל כן, VIP, פעיל) וערך מספרי (למשל 1, 10, 20). הרכיב צריך לדעת איזה ערך מהרשימה = סימון ואיזה = אי-סימון כדי לקרוא ולשמור נכון על הרשומה.

• שדות חדשים שיצרתם דרך הרכיב — ברירת המחדל היא כן = 1 ולא = 2.
• שדות קיימים — אתם בוחרים את המיפוי. Fireberry לא יודע מראש מה מסומן ומה כבוי בשבילכם.

איך מגדירים שדה קיים

אם שיניתם את שם השדה ישירות ב-Fireberry, לחצו רענון במסך השדה כדי למשוך את השם העדכני.

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

הגדרות

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

מה יש בכל מסך

מקטעים — יוצרים מקטעים חדשים (חדש), ולוחצים על מקטע כדי:

• לשנות שם
• להגדיר מוצג בחלון זה — בכל רגע רק מקטע אחד מוצג על הרשומה
• לראות תג מוצג בחלון אם המקטע פעיל כרגע
• לקבוע כמה עמודות יש ברשת (1–6)
• להוסיף שדות קיימים או ליצור שדה חדש
• להסיר שדה מהמקטע (הנתונים נשארים)
• למחוק את המקטע (השדות נשארים ברשימה)

שדות — רשימת כל שדות ה-picklist של האובייקט (כולל שדות שהתגלו אוטומטית). לוחצים על שדה כדי:

• לשנות את השם שמוצג במערכת
• ללחוץ רענון כדי למשוך את השם העדכני מ-Fireberry (למשל אחרי שינוי ישירות ב-CRM)
• לראות באילו מקטעים השדה מופיע
• להוסיף אותו למקטע נוסף
• להסיר אותו ממקטע
• להגדיר ערך מסומן וערך לא מסומן מתוך אפשרויות הרשימה (חשוב לשדות קיימים שלא נוצרו דרך הרכיב)
• למחוק לצמיתות שדות שנוצרו דרך הרכיב (pcfpingmee…) — כולל הנתונים ברשומות

שפה — בחירה בין עברית (ברירת מחדל) לאנגלית לתפריטים, כפתורים וטקסטי עזרה.

טוקן — שומרים את טוקן Fireberry. נדרש ליצירה, עדכון ומחיקה של שדות במערכת.

יצירת שדה חדש

בתוך מקטע או מרשימת השדות, יצירת שדה חדש פותחת טופס עם:

• מקטע — אופציונלי; אפשר לבחור ללא מקטע ולשייך מאוחר יותר
• שם במערכת — התווית ב-Fireberry
• מזהה שדה — קצר וקבוע; ניתן לרענן לפני שמירה

תהליך עבודה מומלץ

API

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

{
  "pcfpingmeeApproved": 1,
  "pcfpingmeeContract": 2
}

סינון

מכיוון שכל סימון הוא שדה picklist, אפשר לסנן רשומות בשאילתות Fireberry לפי ערך השדה.

pcfpingmeeApproved = 1

pcfpingmeeContract = 2