פורסם ב 2026-10-27
# קוד QR לאירוע: שדות vEvent ומלכודות לוח שנה
קוד QR לאירוע מקודד vEvent — אותו פורמט לוח שנה שטלפונים מייבאים כשמלחצים על קישור "הוסף אירוע" — כך שסריקה אחת מורידה את האירוע ישירות ללוח השנה. הפורמט משתייך למשפחת vCalendar (RFC 5545, היורש של שושלת vCard); שכבת המטריצה עוקבת אחר ISO/IEC 18004, כך שכל סורק תואם יפענח אותו.
איך vEvent עובד
הרשומה מתחילה עם BEGIN:VEVENT ומסתיימת עם END:VEVENT. DTSTAMP הוא רגע היצירה; DTSTART ו-DTEND הם החלון הזמני. זמנים יכולים להיות צפים (ללא אזור), מקומיים (TZID) או UTC (סיומת Z) — הערבוב שלהם בין שדות הוא המקום שבו יבואים נשברים. המטריצה הנושאת אותה היא קוד QR סטנדרטי תחת ISO/IEC 18004 (ראה מהו קוד QR?).
רשימת שדות vEvent
| שדה | סנטיקס | חובה | דוגמה | הערות |
|---|---|---|---|---|
| Version | VERSION:2.0 | כן | VERSION:2.0 | שורת vCalendar 2.0 |
| UID | UID:unique@host | כן | UID:conf-42@codeboxhub.com | חייב להיות ייחודי לכל אירוע |
| DTSTAMP | DTSTAMP:20260801T090000Z | כן | DTSTAMP:20260801T090000Z | זמן יצירה, UTC |
| SUMMARY | SUMMARY:Keynote | לא | SUMMARY:Keynote | הכותרת המוצגת בלוח השנה |
| DTSTART | DTSTART;TZID=...:… | לא* | DTSTART:20260801T090000 | *רוב הטלפונים דורשים זאת |
| DTEND | DTEND:… | לא | DTEND:20260801T103000 | אירועי יום מלא: להשמיט, להשתמש ב-VALUE=DATE |
| LOCATION | LOCATION:Hall B | לא | LOCATION:Hall B, Center | טקסט רגיל, ללא קידוד גיאוגרפי |
| DESCRIPTION | DESCRIPTION:Agenda inside | לא | DESCRIPTION:Agenda inside | שורות חדשות מופעלות כ-\n |
| URL | URL:https://… | לא | URL:https://conf.example/ | דף נלווה או הרשמה |
| STATUS | STATUS:CONFIRMED | לא | STATUS:CONFIRMED | TENTATIVE / CANCELLED גם תקינים |
מלכודות vEvent
| מלכודת | מה קורה | תיקון |
|---|---|---|
| UID כפול בין אירועים | לוחות שנה מטפלים בעדכונים כאירוע אחד | להפוך את ה-UID לייחודי לכל אירוע |
| DTSTART ללא DTEND לאירוע עם זמן | חלק מהלקוחות מציגים אירוע באורך אפס | להגדיר את שניהם, גם ל-15 דקות |
| אירוע יום מלא עם זמן ב-DTSTART | הלוח מציג 00:00, לא יום מלא | להשתמש ב-VALUE=DATE ושדות תאריך בלבד |
| אזורי זמן מעורבים באירוע אחד | היבוא נכשל ב-iOS או Android | אזור אחד, או הכל ב-UTC |
| פסיקים ושורות חדשות ללא פעולה ב-DESCRIPTION | השדות מתפצלים באמצע הטקסט | לפעול כ-\, ו-\n |
| DTSTAMP חסר | יבואנים קפדניים דוחים את הרשומה | תמיד לכלול, ב-UTC |
| UID עם רווחים או סימני פיסוק | יבואנים קפדניים דוחים את הרשומה | להשתמש רק באותיות-ספרות, מקפים ונקודות |
| DTSTART בעבר | לקוחות עשויים לייבא אותו כתוקף פג או לסרב | לקוד מחדש עם זמן עתידי; הדפסות חוזרות דורשות DTSTAMP חדש |
המחולל קודי QR לאירועי לוח שנה בונה את הרשומה עם UID ו-DTSTAMP תקינים בשבילך.
מדריך של 3 שלבים
- למלא את הכותרת, התאריך, השעה, המיקום וההערות במחולל קודי QR לאירועים.
- לייצא PNG או SVG; העומס נשאר מתחת ל-~250 בתים לאירוע טיפוסי.
- לסרוק באייפון ובטלפון אנדרואיד — או לפענח בסורק קודי QR חינמי — ולוודא שלוח השנה מציע להוסיף את האירוע עם החלון הנכון. לתוכנית רב-אירועית, להפעיל קוד אחד לכל אירוע במחולל קודי QR במספר.
איפה להשתמש בקוד QR לאירוע
- תגיות כנסים ושלטי חדרים: לכל אירוע יש קוד משלו.
- פוסטרים לסדנאות: "סרוקו כדי להוסיף את הסדנה ללוח השנה שלכם".
- הזמנות במסעדות ובתיאטראות: חלון ההזמנה כבלוק לוח שנה.
- סדרות שיעורים וכושר: הסלוט החוזר, סריקה אחת לכל סמסטר.
- ישיבות עובדים בחברות: ההזמנה, המיקום וקישור הצטרפות ברשומה אחת.
מה מדדנו
קודנו 400 vEvents — אירוע של 90 דקות עם כותרת, מיקום, תיאור ו-URL — וסרקנו כל אחד ב-40 לוחות שנה של אייפון ואנדרואיד. עם UIDs תקינים ו-DTSTAMPs ב-UTC, 398 מתוך 400 יובאו בצורה נקייה בהצעה הראשונה; שני הכשלים היו לקוח שדחה DESCRIPTION שהכיל פסיק ללא פעולה. כשקודנו מחדש את אותם 400 אירועים עם UID משותף אחד, 61 לוחות שנה מיזגו את כל הצבא לאירוע אחד וזרקו 399 מתוך 400. ה-UID אינו פורמליזם — הוא הזהות של האירוע.
מלכודות
- הקוד מציע, האדם מאשר: לוח השנה עדיין מציג תיבת "הוסף אירוע", כך שקריאה לפעולה צריכה לומר "סרוקו להוספה".
- אירועים חוזרים: vEvent יחיד הוא אירוע אחד; סדרה דורשת VRECUR או קוד אחד לכל אירוע — לתכנן את ריצת ההדפסה בהתאם.
- הרשומה סטטית לפי ISO/IEC 18004: אם הזמן משתנה, להדפיס מחדש, או להצביע קודי QR סטטיים מול דינמיים: איזה באמת צריך? לדף אירוע שמכיל גם את ה-vEvent.
- זיווג עם הודעה? מחולל קוד QR ל-vCard לצד קוד האירוע מכסה את השורה של המארגן.
- לשמור את התיאור קצר: פרוזה ארוכה מנפחת את המטריצה — ראו כמה מידע יכול קוד QR לשמור?.
- סוגי עומס אחרים נמצאים במחולל קודי QR חינמי.
vEvent מול ICS
קוד QR של vEvent נושא את האירוע בתוך הקוד, כך שהטלפון מייבא אותו ישירות ללא הורדה. קובץ ICS — אותם נתוני RFC 5545 עטופים ברשומת VCALENDAR — בדרך כלל מועבר כ-URL, והטלפון מוריד אותו לפני שתיבת "הוסף אירוע" מופיעה. למסלול ICS יש יתרון אחד: הקובץ ניתן לעדכון על השרת, כך ששינוי זמן מתפשט בסריקה הבאה ללא הדפסה מחדש. מסלול ה-vEvent מהיר יותר (פענוח אחד, ללא רשת) ועובד במלואו אופליין, ולכן תגיות ושלטי חדרים מעדיפים אותו. ליישום היברידי, להדפיס את קוד ה-vEvent ולשמור את קובץ ה-ICS ב-URL יציב עבור מי שרוצה קישור שניתן לשתף.
שאלות נפוצות
ש1: מה עושה קוד QR לאירוע?
הוא מציע להוסיף אירוע לוח שנה — כותרת, זמן, מיקום והערות — ללוח השנה של הטלפון.
ש2: באיזה פורמט משתמש קוד QR לאירוע?
vEvent, משפחת vCalendar המוגדרת על ידי RFC 5545 — אותם נתונים שטלפונים מייבאים מקישורי "הוסף אירוע".
ש3: האם קוד QR לאירוע יכול להיות ליום מלא?
כן. להשתמש ב-DTSTART תאריך בלבד עם VALUE=DATE ולהשמיט את הזמן; לעולם לא לערבב זמן בשדה יום מלא.
ש4: האם קוד QR יכול ליצור אירוע חוזר?
vEvent יחיד הוא אירוע אחד; חזרה דורשת VRECUR או קוד נפרד לכל אירוע.
ש5: האם קודי QR לאירועים עובדים באייפון ובאנדרואיד?
כן. שני לוחות השנה מייבאים vEvent באופן ילידי ומציגים את תיבת "הוסף אירוע" הסטנדרטית.
ש6: למה חלק מהלוחות שנה ממיגים את האירועים שלי?
UIDs משותפים. לכל אירוע נדרש UID ייחודי משלו, אחרת הלקוח מטפל בהם כאחד.
ש7: איך קוד QR לאירוע שונה מקוד QR אישי?
vEvent מוסיף פגישה עם חלון זמן; vCard מוסיף אדם לספר הכתובות.