#התחלה מהירה

בואו נגדיר תרשים מאפס, תוך שימוש בתכונות החיוניות בלבד. יכולות אופציונליות נוספות יפורטו בפרקים הבאים.

דרישות קדם:

• מקור נתונים ואוסף (טבלה) הוגדרו, ויש לכם הרשאת קריאה.

#הוספת בלוק תרשים

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

לאחר ההוספה, לחצו על "הגדרות" בפינה הימנית העליונה של הבלוק.

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

#הגדרת שאילתת נתונים

בפאנל "שאילתת נתונים", תוכלו להגדיר את מקור הנתונים, תנאי סינון לשאילתה ועוד.

• ראשית, בחרו מקור נתונים ואוסף

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

• הגדרת מדדים (Measures)

  • בחרו שדה מספרי אחד או יותר כמדדים.
  • הגדירו צבירה (aggregation) לכל מדד: Sum / Count / Avg / Max / Min.

• הגדרת ממדים (Dimensions)

  • בחרו שדה אחד או יותר כממדי קיבוץ (תאריך, קטגוריה, אזור וכדומה).
  • עבור שדות תאריך/שעה, ניתן להגדיר פורמט (לדוגמה, YYYY-MM, YYYY-MM-DD) כדי לשמור על תצוגה אחידה.

אפשרויות נוספות כמו סינון, מיון ועימוד הן אופציונליות.

#הפעלת שאילתה וצפייה בנתונים

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

#הגדרת אפשרויות תרשים

בפאנל "אפשרויות תרשים", תוכלו לבחור את סוג התרשים ולהגדיר את האפשרויות שלו.

• ראשית, בחרו סוג תרשים (קו/שטח, עמודות/ברים, עוגה/טבעת, פיזור וכדומה).
• השלימו את מיפויי השדות המרכזיים:
  • קו/שטח/עמודות/ברים: xField (ממד), yField (מדד), seriesField (סדרה, אופציונלי)
  • עוגה/טבעת: Category (ממד קטגורי), Value (מדד)
  • פיזור: xField, yField (שני מדדים או ממדים)
  • להגדרות תרשים נוספות, עיינו בתיעוד של ECharts: ציר
• לאחר לחיצה על "הפעל שאילתה", מיפויי השדות יושלמו אוטומטית כברירת מחדל. אם תשנו ממדים/מדדים, אנא בדקו מחדש את המיפויים.

#תצוגה מקדימה ושמירה

שינויים בהגדרות יעדכנו אוטומטית את התצוגה המקדימה בזמן אמת, ותוכלו לראות את התרשים בדף משמאל. אך שימו לב שלפני לחיצה על כפתור "שמור", כל השינויים אינם נשמרים בפועל.

תוכלו גם ללחוץ על הכפתורים בתחתית:

• תצוגה מקדימה: שינויים בהגדרות מרעננים אוטומטית את התצוגה המקדימה בזמן אמת, או שתוכלו ללחוץ על כפתור "תצוגה מקדימה" בתחתית כדי להפעיל רענון ידני.
• ביטול: אם אינכם מעוניינים בשינויים הנוכחיים, תוכלו ללחוץ על כפתור "ביטול" בתחתית, או לרענן את הדף, ופעולה זו תבטל את השינויים הנוכחיים ותחזור למצב השמור האחרון.
• שמירה: לחצו על "שמור" כדי לשמור בפועל את כל הגדרות השאילתה והתרשים הנוכחיות במסד הנתונים; הן ייכנסו לתוקף עבור כל המשתמשים.

#נקודות חשובות

• הגדרה מינימלית נדרשת: בחרו אוסף + לפחות מדד אחד; מומלץ להוסיף ממדים לתצוגה מקובצת.
• עבור ממדי תאריך, מומלץ להגדיר פורמט מתאים (לדוגמה, עבור סטטיסטיקה חודשית בחרו YYYY-MM) כדי למנוע ציר X לא רציף או מבולגן.
• אם השאילתה ריקה או שהתרשים אינו מוצג:
  • בדקו את האוסף/הרשאות ומיפויי השדות;
  • ב"הצג נתונים", ודאו ששמות העמודות והסוגים תואמים למיפוי התרשים.
• תצוגה מקדימה היא זמנית: היא מיועדת רק לאימות והתאמות. היא תיכנס לתוקף רשמית רק לאחר שתלחצו על "שמור".