הרשמה

הגדרות חובה:

api_add_0=module=register
api_add_1=list_id=מזהה הרשימה

הגדרת השדות:
יש להגדיר את השדות לרישום, יש להגדיר את השדות במספור רץ בפורמט דלהלן
api_add_x=field1=הגדרות השדה
api_add_x=field2=הגדרות השדה
api_add_x=field3=הגדרות השדה

ישנם 3 הגדרות חובה בהגדרת שדה, את ההגדרות יש לכתוב עם הפרדה של נקודה (.) בינהם
החלק הראשון - שם השדה
יש לכתוב את השם שיופיע בראש כל עמודה בקובץ
החלק השני - סוג הנתון
ישנם 3 סוגי נתונים:
סוג נתון תיאור
read קבלת נתון מהמשתמש באמצעות הקשה או הקלטה
const ערך קבוע, לדוגמא "30" או "רישום מוקדם"
variable ערך משתנה, לדוגמא מספר הטלפון של המתקשר, תאריך או שעה, ועוד
החלק השלישי - מאפייני הנתון
בחלק זו יש להגדיר את מאפייני הנתון, את המאפיינים יש להגדיר בהתאם לסוג הנתון שהוגדר בחלק השני
במידה ויש יותר ממאפיין אחד, יש להפריד בין המאפיינים באמצעות סימן מקף (-)
מאפיינים עבור נתון מסוג read:
יש להגדיר לפחות 2 מאפיינים

1. קובץ להשמעה
   ניתן להגדיר 3 סוגי השמעות:
   פתיח תיאור דוגמא
   f קובץ מהמערכת, יש לציין שם של קובץ מהשלוחה, או מכל נתיב אחר במערכת f:000 או f:/1/2/003
   m הודעת מערכת של ימות המשיח m:1108
   t טקסט להקראה t:אנא הקישו את מספר הטלפון ולאחריו סלומית
2. צורת קבלת הנתון
   ניתן להגדיר 3 צורות לקבלת נתונים:
   צורה תיאור
   text קבלת טקסט באמצעות זיהוי דיבור
   tap קבלת נתון מספרי באמצעות הקשה
   menu בחירת נתון מתוך תפריט, חובה להוסיף מאפיין שלישי של רשימת הערכים
   ניתן להוסיף מאפיינים נוספים בהתאם לצורת קבלת הנתון:
   צורת קבלה מספר מאפיין תיאור ברירת מחדל
   text 3 האם לבקש אישור על הזיהוי דיבור, ניתן להגדיר yes או no yes
   text 4 שפת הדיבור לזיהוי, ניתן להגדיר he לעברית, או en לאנגלית iw-IL
   tap 3 באיזה צורה להשמיע למשתמש את ההקשה, ההגדרות בהתאם לאפשרויות של ימות המשיח
   no
   tap 4 על איזה מקשים ניתן להקיש, ניתן להגביל למקשים מסויימים, לדוגמא 123 יגביל הקשה לספרות 1,2,3 בלבד
   אם לא הוגדר, או שהוגדר ערך ריק, מאפשר הקשה על כל מקש מאפשר הקשה על כל מקש
   tap 5 כמות הקשות מקסימלית, ניתן להגביל לכמות הקשות, לדוגמא 2 לא יתן להקיש יותר מ-2 ספרות
   אם לא הוגדר, או שהוגדר ערך ריק, מאפשר להקיש ללא הגבלה מאפשר להקיש ללא הגבלה
   tap 6 כמות הקשות מינימלית, ניתן לחייב כמות הקשות מינימלית, לדוגמא 6 יחייב להקיש לפחות 6 ספרות
   אם לא הוגדר, או שהוגדר ערך ריק, מאפשר להקיש ללא מינימום הקשות מאפשר להקיש ללא מינימום הקשות
   tap 7 ערך מקסימלי להקשה, לדוגמא אם הוגדר 30 לא יאפשר להקיש ערך הגבוה מ-30
   אם לא הוגדר, או שהוגדר ערך ריק, מאפשר להקיש ללא הגבלה מאפשר להקיש ללא הגבלה
   tap 8 ערך שירשם במידה ולא התקבל נתון (המאזין הקיש על סולמית), ניתן להזין ערך רצוי, או כל ערך משתנה כפי ההגדרות שמופיעות בנתון מסוג variable במידה ורוצים שישמר ערך ריק יש לכתוב empty לא מאפשר לדלג על ההקשה
   menu 3 רשימת הערכים לתפריט, מופסקים באמצעות נקודתיים (:) לדוגמא כן:לא:אולי ערך זה נדרש
   מאפיינים עבור נתון מסוג const:
   יש לכתוב את הערך לשמירה
   מאפיינים עבור נתון מסוג variable:
   ישנם 4 סוגי נתונים משתנים לשמירה
   סוג נתון משתנה תיאור
   phone שומר את מספר הטלפון של המשתמש
   system_dial המספר אליו חייג המאזין
   date שמירת התאריך הלועזי הנוכחי, ניתן להגדיר שמירת תאריך עתידי באמצעות הפרדה של '-' ולאחריו כמות הימים להוספה
   לדוגמא date-3 ישמור את התאריך של עוד 3 ימים
   hebrew_date שמירת התאריך העברי הנוכחי, ניתן להגדיר שמירת תאריך עתידי באמצעות הפרדה של '-' ולאחריו כמות הימים להוספה
   לדוגמא hebrew_date-3 ישמור את התאריך של עוד 3 ימים
   time שמירת השעה הנוכחית
   key מפתח ההרשמה, ראה להלן
   החלק הרביעי - שדה מקושר ברשימת הרשאות
   יש לציין את מספר השדה המקושר ברשימת ההרשאות, לצורך קריאה או כתיבה לרשימה. ראה להלן

להלן דוגמא של ההגדרות שהוזכרו לעיל:
type=api
api_link=https://utilitiesphone.com/additives_yemot/phone_sys
api_add_0=module=register
api_add_1=list_id=2
api_add_2=field1=סוג הרשמה.const.טיול לפארק מים
api_add_3=field2=פלאפון.variable.phone
api_add_4=field3=שם.read.m:1108-text
api_add_5=field4=כמות מקומות.read.f:000-tap-Number----10
api_add_6=field5=האם צריך הסעה.read.f:001-menu-כן:לא
api_add_7=field6=תאריך הרשמה.variable.date
api_add_8=field7=שעת הרשמה.variable.time

בדוגמא הנ"ל:
שדה 1- שומר ערך קבוע "טיול לפארק מים" (עבור הרשמות שונות הנשמרות באותו קובץ, ניתן להגדיר שלוחה נוספת שתכתוב ערך אחר בעמודה זו)
שדה 2- שומר את מספר הפלאפון של המשתמש
שדה 3- שומר את שם המשתמש שמומר לטקסט באמצעות זיהוי דיבור
שדה 4- כמות מקומות רצויה, המשתמש יתבקש לאשר את הכמות, הכמות מוגבלת ל-10 להרשמה
שדה 5- האם צריך הסעה או לא, אם המשתמש מקיש 1 ישמר ערך "כן" ואם הקיש 2 ישמר ערך "לא"
שדה 6- שומר את התאריך הנוכחי
שדה 7- שומר את השעה הנוכחית

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

1. קישור לקובץ הרשאות - ניתן להגדיר שההרשמה תהיה מקושרת לקובץ הרשאות, כך ובמידה והמפתח מופיע בקובץ, המערכת תשלוף את נתוני ההרשמה משם, וכן להיפך, במידה והמפתח לא מופיע בקובץ, המפתח יתווסף לקובץ ההרשאות, ההגדרות יפורטו בהמשך
2. ניתן להגביל את ההרשמה לרישום אחד עבור כל מפתח, ההגדרות יפורטו בהמשך
   מפתח מסוג פלאפון
   api_add_x=key=phone

מפתח מסוג תעודת זהות, יש להוסיף כניסת enter_id על פי מספר זהות:
api_add_x=key=teudat_zehut
enter_id=yes
enter_id_type=teudat_zehut

מומלץ לבטל את הקלטת השם, והקראת השם בהתחברות
api_add_3=key=teudat_zehut
enter_id=yes
enter_id_type=teudat_zehut
record_name=no
say_name=no

קישור לקובץ הרשאות:
ניתן להגדיר שהרישום יהיה מקושר לקובץ הרשאות, באמצעות קישור הקובץ ניתן לקרוא ולכתוב נתונים מקובץ ההרשאות
לדוגמא, במידה ובקובץ ההרשאות מופיע השם והכתובת של הנרשם, הערכים ישאבו משם והוא לא יצטרך להזינם שוב בעת הרישום
כמו"כ, במידה והנרשם לא מופיע בקובץ ההרשאות, הוא יתווסף לקובץ בסיום הרישום
כדי להשתמש באפשרות זו חובה להגדיר רישום באמצעות מפתח, וכן יש להזין את מאפייני קובץ ההרשאות
להלן הגדרות החובה:
api_add_x=key=phone
api_add_x=link_list_id=מזהה קובץ ההרשאות
api_add_x=link_column=העמודה בה יש לחפש את המפתח

ניתן להגדיר חיפוש מפתח ב-2 עמודות בקובץ ההרשאות, יש להפריד בין העמודות עם (:)
api_add_x=link_column=2:3

בנוסף, עבור כל שדה שרוצים לקשר לקובץ ההרשאות, יש לציין בהגדרות השדה (החלק הרביעי, ראה לעיל) את מספר השדה המקושר בקובץ ההרשאות
דוגמא:
api_add_x=field1=תעודת זהות.variable.key.1
api_add_x=field2=פלאפון.variable.phone.3
api_add_x=field3=שם.read.m:1108-text.2

בדוגמא, שדה 1 מקושר לשדה 1, שדה 2 מקושר לשדה 3 , ושדה 3 מקושר לשדה 2 בקובץ ההרשאות
לתשומת לב, אפשר לקשר רק את השדות הרלוונטים, אין צורך לקשר את כל שדות ההרשמה
סוגי קישור:
ברירת מחדל הקישור הוא דו צדדי, כלומר, במידה והנרשם קיים, הנתונים מתקבלים מקובץ ההרשאות, במידה והנרשם לא קיים, הנתונים נשלחים לקובץ ההרשאות
ניתן להגדיר שהקישור יהיה רק חד צדדי, כלומר רק לקבל או רק לרשום
; קבלת נתונים בלבד
api_add_x=type_link=get
; רישום נתונים בלבד
api_add_x=type_link=put

הקראת שם מתוך קובץ ההרשאות
ניתן להגדיר, שבמידה ונמצא קישור לקובץ ההרשאות, המערכת תקריא בעת הכניסה לשלוחה את השם של הנרשם מתוך עמודה כל שהיא בקובץ
api_add_x=link_name_column=2

במידה והשם רשום ב-2 עמודות נפרדות, ניתן לציין את 2 העמודות עם הפרדה של נקודתיים (:)
api_add_x=link_name_column=2:3

להלן דוגמא לשימוש בהרשמה עם קישור לקובץ הרשאות
type=api
api_link=https://utilitiesphone.com/additives_yemot/phone_sys
api_add_0=module=register
api_add_1=list_id=2
api_add_2=key=teudat_zehut
api_add_3=field1=סוג הרשמה.const.הרשמה לקורס
api_add_4=field2=תעודת זהות.variable.key.1
api_add_5=field3=פלאפון.variable.phone.2
api_add_6=field4=שם פרטי.read.f:000-text.3
api_add_7=field5=שם משפחה.read.f:001-text.4
api_add_8=field6=כתובת.read.f:002-text.5
api_add_9=field7=צורת השתתפות.read.f:004-menu-זום:פיזי:טלפוני
api_add_10=field8=תאריך הרשמה.variable.date

api_add_11=link_list_id=1
api_add_12=link_column=1
api_add_13=link_name_column=3:4

enter_id=yes
enter_id_type=teudat_zehut
record_name=no
say_name=no            

התניית הרשמה בתשלום:
ניתן להגדיר שהרישום לא יושלם עד שיתבצע תשלום באמצעות סליקת אשראי
המודל תומך בסליקת אשראי באמצעות 'נדרים פלוס'
להלן ההגדרות הנצרכות להתחברות למנוע סליקה בסיום הרישום
api_add_x=credit_card_type=nedarim_plus
credit_card_terminal_number=מספר מוסד

כמו"כ יש להגדיר את הסכום לחיוב
api_add_x=billing_amount=סכום לחיוב

ניתן להגדיר שהסכום לחיוב יהיה מכפלה של נתון שהוקש באחד השדות הקודמים
לדוגמא, ניתן להגדיר שהסכום לחיוב יהיה 50 * שדה 5 שבו הוזן מספר הכרטיסים לרכישה
api_add_x=billing_amount=20~field5

במידה והוגדר קישור לקובץ הרשאות, ניתן להגדיר סכום אחר לחיוב עבור מפתח רישום שמופיע בקובץ ההרשאות
api_add_x=exist_key_billing_amount=סכום לחיוב

ברירת מחדל הסכום הוא שקלי, ניתן להגדיר תשלום בדולרים
api_add_x=billing_currency=2

ניתן להגדיר קטגוריה בנדרים פלוס אליה תשוייך העסקה
credit_card_category_nedarim_plus=שם הקטגוריה

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

1. הגבלה לפי מפתח
   api_add_x=limit_by_key=2

בדוגמא, יחפש אם המפתח קיים כבר בעמודה מספר 2, אם קיים - לא יאפשר להירשם שוב כמובן שיש צורך להגדיר רישום באמצעות מפתח, ראה לעיל
2. הגבלה לפי כמות נרשמים
api_add_x=limit_by_rows=50

בדוגמא יסגור את ההרשמה אחרי 50 נרשמים
3. הגבלה לפי סכום ערכי עמודה
ניתן להגדיר שלא יתן להירשם אחרי שהסכום הכולל של עמודה מסויימת עבר את המגבלה
api_add_x=limit_by_sum=100-3

בדוגמא לא מאפשר להירשם אחרי שהסכום הכולל של עמודה מספר 3 עבר את ה-100
4. הגבלה לפי תאריך ושעה
ניתן להגדיר שלא יתן להירשם אחרי תאריך ושעה מסויימים
api_add_x=limit_by_date=10/08/2024 12:30

בדוגמא לא מאפשר להירשם אחרי שהסכום הכולל של עמודה מספר 3 עבר את ה-100
מעבר לשלוחה אחרת בסיום ההרשמה:
ברירת מחדל, בסיום ההרשמה משמיע קובץ M3411 ומנתק את השיחה
ניתן להגדיר שיעבור לשלוחה אחרת
api_add_x=end_go_to=שלוחה

שליחת מייל בסיום ההרשמה:
ניתן להגדיר שבכל סיום הרשמה ישלח מייל עם פרטי ההרשמה, וקובץ ההרשמה העדכני
api_add_x=send_register_to_email=כתובת המייל לשליחה

ניתן לשלוח לכתובת מייל נוספת
api_add_x=send_register_to_email_cc=כתובת המייל לשליחה

ניתן לקבוע את שם השולח
api_add_x=from_address=מערכת רישום קורסים