ספר ההדרכה / טבלאות נתונים (sdb)

טבלאות נתונים (sdb)

טבלת נתונים היא כל טבלה בצד השרת שהאוטומציות של האפליקציה כותבות אליה בכתיב sdb.tableName[key]. אפשר לצפות ולערוך אותה ישירות מעמוד "נתונים" בדשבורד, בזמן אמת.

היקף (Scope): פרטי מול משותף

  • גלובלי / משותף לכל המבקרים - שורה אחת שכולם רואים ועורכים (למשל מלאי, לוח תוצאות).
  • פרטי למבקר הזה - כל מבקר מקבל שורות משלו באותה טבלה, בלי לראות של אחרים (למשל "ההזמנות שלי").
שימו לב - הבדל חשוב

רכיב לופ דטה תמיד קורא בהיקף גלובלי, ללא קשר להיקף שבו כתבתם עם dbSet. אם כתבתם שורה בהיקף "פרטי" והיא לא מופיעה בלופ - זו הסיבה.

פעולות שחושפות את הטבלאות לאוטומציה

פעולה מה עושה שדות עיקריים
שמירה באחסון השרת (dbSet) כותב שורה אחת. אם ממלאים רשימת "שדות" (name/value) במקום ערך יחיד - הפעולה ממזגת לתוך השורה הקיימת במקום לדרוס אותה, כך שאפשר לעדכן שדה בודד (למשל דגל "נקרא") בלי למחוק שדות אחרים. collection חובה
key חובה
value / fields
scope
קריאה מאחסון השרת (dbGet) קורא שורה אחת אל תוך משתנה. collection חובה
key חובה
scope
יעד (משתנה)
רענון לופ דטה מכריח רכיב לופ-דטה מסוים לקרוא מחדש מהשרת מיד (בנוסף לרענון האוטומטי דרך WebSocket). רכיב היעד חובה
ייצוא טבלה לקובץ CSV מוריד את כל שורות הטבלה כקובץ. collection חובה
טיפ מתקדם

גם collection וגם key ב-dbSet/dbGet יכולים לקבל {{משתנה}} - למשל שם טבלה מחושב כמו contacts_{{myPhone}} נותן לכל מבקר טבלה משלו.

Webhook נכנס

לכל טבלה יש גם כתובת Webhook ייעודית: מערכת חיצונית יכולה לשלוח POST עם JSON בצורת {"key": "...", "value": {...}} וכותרת X-Api-Secret - הכתיבה תמיד תנחת בהיקף המשותף/גלובלי. אפשר לחדש את הסוד (secret) בכל רגע מעמוד "נתונים".

מגבלות אחסון

  • עד 8,000 תווים לכל ערך שמור בשורה.
  • עד 20,000 שורות לכל אפליקציה.
  • כל כתיבה נספרת גם במכסת האחסון הכוללת של המשתמש.