הסבר על מודול קבלת נתונים

brochabar

הקרדיט ל @אאד

חלק א' הסבר על המודול (עוד לפני ההגדרות)

קישורים משרשור זה
הקדמה
ההגדרות הבסיסיות של המודול - "קבלת הקלטות ונתונים"
הגדרות נוספות לקבלת "הקלטות" (קבצים 000-049):
עוד הגדרות נוספות ל "קבלת נתונים" (קבצים 050-099):
הודעות מערכת
מיקום שמירת הקבצים המתקבלים:
יציאה במהלך הרישום
קבלת מייל על כל הזמנה/הרשמה
לאחר הרישום - לאן ימשיך

הסבר על המודול:
ראשית נפשט את המילים "הקלטות" ו"נתונים"
וכן מי מקבל אותם? איך? מתי? ולמה?
וכו'

אז ככה: (הקדמה)
לצורך העיניין - נגיד שאנחנו עומדים לארגן כינוס רב משתמשים
לכינוס יבואו אנשים מרחבי הערים בארץ
וכן בכמה שכבות גיל (בחורים/אברכים/מבוגרים)
ואנחנו רוצים להערך בהתאם לכמות האנשים שיבואו
וכן לדעת כמה מהם יהיו בחורים וכמה אברכים
(ע"מ למיין את השולחנות לכל שכבת גיל)
ובנוסף נשמח לדעת את שמות הנרשמים - כך נוכל להכין כיסא עם שם לכל אחד
וואהו - איזה אירוע מכבד...

יש את האפשרות הפרימיטיבית - להושיב כמה מזכירות ו...

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

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

אז כפי שכבר כתבתי למעלה אנחנו צריכים שלושה פרטים
שזה אומר שכשמישהו יתקשר להירשם הוא יתבקש להזין שלושה פרטים
1 - שם (ע"מ לרשום על המקום)
2 - עיר מגוריו (לצורך אינדיקציה)
3 - שכבת גיל (בחור אברך או מבוגר)

יופי, אז עשינו סדר בעניינים, מה עכשיו?
עכשיו אנחנו מקליטים שלושה "שאלות"
1 - "אנא הקליטו את שמכם ושם משפחתכם, ולסיום הקישו סולמית"
2 - "אנא הקליטו את עיר המגורים שלכם, ולסיום הקישו סולמית"
3 - "אנא הקישו את גילכם, (בשתי ספרות)"

יצא ברור? ברוך השם!

עכשיו שימו לב שהדגשתי את "הקליטו" "הקישו"
המערכת צריכה לדעת מתי הנרשם מקליט ומתי הוא מקיש

איך נגדיר את זה?
אז ככה:
שם ההקלטה שהקלטנו הוא זה שיגדיר למערכת אם הנרשם הולך להקליט או להקיש

לא הבנתם, נכון?
לא נורא, אני יסביר:
כשאנחנו 'מעלים' את ההקלטה שהקלטנו "אנא הקליטו..." (מס' 1)
שאז הנרשם צריך להקליט
שם ההקלטה יהיה "000"
ואחריו נעלה עוד הקלטה (מס' 2)
והשם שלו יהיה "001"

עכשיו צריך להעלות את ההקלטה השלישית "אנא הקישו..."
שזה כבר הקשות (ולא הקלטות)
אך איך המערכת תדע שעכשיו אין צורך להקליט?
אז אנחנו נעלה אותה לשלוחה
ונשנה את השם של ההקלטה ל"050"
שכששם ההקלטה הוא מעל חמישים - המערכת יודעת שאין צורך להקליט אלא לתת לנרשם "להקיש"

החילוק בין שניהם זה החילוק בין "הקלטות" ל"נתונים"
כל פעם שאנחנו רוצים שהנרשם יקליט - זה נקרא "קבלת הקלטות"
וכל פעם שאנחנו רוצים שהנרשם יקיש - זה נקרא "קבלת נתונים"

יופי - סוף סוף הבנו מה זה "מודול קבלת הקלטות ונתונים"
עכשיו למעשה...
בהצלחה

brochabar

ההגדרות הבסיסיות של המודול - "קבלת הקלטות ונתונים"

ההגדרה של המודול:

type=recording_and_entering_data

מיקום ההקלטות:
שימו לב! הכוונה להקלטות 1-2-3 שבדוגמה, (ולא הקלטות שמאזינים מקליטים)

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

recording_and_entering_data_folder_to_play=/8

בדוגמה מוגדר שהמערכת תיקח את ההקלטות משלוחה 8 (שתחת תיקיה ראשית)

שמות הקלטות:
שמות הקלטות של "קבלת הקלטות"
(1ו2 בהקדמה), יהיה בין 000-049
הקובץ הראשון חייב להיות בשם 000 וכל השאר עוקבים אחריו

שמות הקלטות של "קבלת נתונים"
(3 בהקדמה), יהיה בין 050-099
הקובץ הראשון חייב להיות בשם 050 וכל השאר עוקבים אחריו

סדר ההקלטות:
ברירת מחדל הוא שקודם מקבל הקלטות ואח"כ מקבל נתונים,
כלומר מתחיל בקבצים 000-049 ולאחר מכן עובר ל 050-099

באם רוצים שיתחיל מקובץ 050 ומעלה,
ורק אח"כ מקובץ 000
כלומר קודם נתונים ואח"כ הקלטות
יש להגדיר:

start_first=data

(ברירת מחדל כאלו מוגדרstart_first=recording)

brochabar

הגדרות נוספות לקבלת "הקלטות" (קבצים 000-049):

מה מגדירים

הסבר על ההגדרות של מאפייני הקובץ

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

לכן אנחנו יכולים להגדיר שאם יש 'שקט' כמה שניות, דהיינו שאף אחד לא מדבר,
אז המערכת תסיים להקליט ותעבור לשלב הבא

אבל זה יעזור רק אם הוא (המקליט-הזקן) נמצא במקום שקט
אך במצב שיש מסביבו רעש או שהוא נושם בקול אז זה לא יעזור - כי אין שניות של שקט

לכן יש אפשרות להגדיר את אורך ההקלטה
דהיינו אנחנו משערים שכדי להקליט את השם הפרטי ואת המשפחה צריך 5 שניות
אנחנו נגדיר 6 שניות (שיהיה קצת סְפֶּר)
ולאחר שש שניות מתחילת ההקלטה - המערכת תפסיק להקליט - ותעבור לשלב הבא.

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

הגדרות ברירת מחדל:
אורך הקלטת כל קטע עם 20 שניות,
באם 2 שניות שקט - כאילו סיים להקליט,

לשינוי זמן ההקלטה או זמן השקט שאחרי ההקלטה, ניתן להכניס ערך בשם:

XXX-option=

כשאת האיקסים מחליפים בשם הקובץ
דהיינו: "שם הקובץ" "מקף" "option" "שווה"

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

000-option=2

בדוגמה מופיע 2 שניות
שזה אומר שאם הנרשם היה בשקט שתי שניות המערכת תפסיק להקליט ותעבור לשלב הבא

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

הגדרה שניה:
מקסימום אורך הקלטה
כפי שהסברתי לעיל - אם אנחנו רוצים להגביל את אורך ההקלטה לכמות שניות מסויימת
נוסיף למה שכבר כתבנו (000-option=2) מקף 6
ככה:

000-option=2-6

בדוגמה מופיע מקסימום 6 שניות

(לזמן הקלטה מקסימלי - דהיינו ללא הגבלת אורך ההקלטה - אפשר לשים את הספרה 0
ואז גם אם ההקלטה תהיה מאוד ארוכה המערכת תמשיך להקליט - עד שהנרשם יקיש סולמית)

הגדרה שלישית:
האם להמיר את ההקלטה לטקסט
ברירת מחדל לא ממיר, אם רוצים שהמערכת תמיר לטקסט - יש להוסיף "מקף STT"
ככה:

000-option=2-6-STT

(שזה ראשי תיבות של Speech to text כלומר דיבור לטקסט)

אם מוגדר להמיר ורוצים "לעזור" למערכת להבין,
דהיינו - אם למשל עכשיו הוא צריך להקליט שם עיר
אז אפשר להכין רשימה של שמות הערים בארץ
ואז אם המערכת לא כל כך הבינה מה הוא אמר
אז המערכת תחפש ברשימה ותתאים את זה למילה הכי דומה
ניתן להכניס קובץ ini מקביל עם הערכים שיכולים להיות, לדוגמא לקובץ 001.wav תכניסו קובץ מקביל של 001.ini

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

הגדרה רביעית
האם להמיר את הטקסט בחזרה לקול של המערכת ולהשמיע ללקוח, ברירת מחדל המערכת רק ממירה ושמה בקובץ אבל לא משמיע ללקוח,
בשביל שישמיע ללקוח את ההמרה של כל הדיבור יש להגדיר TTS ראשי תיבות של
text to Speech כלומר טקסט לדיבור
במקרה שבו הטקסט שיתקבל חזרה אמור להיות מספרים או אותיות באנגלית ניתן להגדיר גם את האפשרויות הבאות:
Number להשמעה בצורת מספר
Digits להשמעה בצורת ספרות
Alpha להשמעת האותיות באנגלית

הגדרה חמישית
האם לשאול את הלקוח אם מה שהוא שמע מהטקסט לדיבור זה בסדר או שרוצה להקליט את עצמו מחדש,
ברירת מחדל המערכת לא שואלת, אם רוצים שהמערכת תשאל אז יש צורך להגדיר ask

לדוגמה : לעריכת מאפייני קובץ 000 יש להכניס ערך

000-option=6-40

או

001-option=6-40-STT-TTS-ask

או

002-option=--STT

כפי שרואים בדוגמאות לא חייב לשים את כל הערכים,
ניתן לדלג על ערכים 1 ו2 (שאר כברירת מחדל) ולהפעיל רק את אפשרות 3 , או 3 ו4 , או 3 ו 4 ו 5

לאחר ההודעה, ברירת מחדל שיש תפריט המאפשר אישור ההקלטה, שמיעת ההקלטה, והקלטה מחודשת
לדילוג על התפריט שלאחר הקלטת ההודעה
שלא יושמע התפריט הנ"ל, יש להגדיר:

record_ok=#

brochabar

הגדרות נוספות ל "קבלת נתונים" (קבצים 050-099):

הגדרות ברירת מחדל

מספר ספרות מקסימלי - ללא הגבלה,
מספר ספרות מינימלי -לפחות סיפרה אחת,
זמן (בשניות) להמתנה עד להודעה "לא הוקשה בחירה - 10 שניות
משמיע את המספר שהקישו בצורת מספר (Number) כלומר 22 יהיה "עשרים ושתים"
ניתן לשנות את ההגדרה להשמעה בצורת ספרות (Digits) כלומר 22 המערכת תשמיע "שתים שתים"
ניתן גם להגדיר SayFile. פירוט בהמשך.
כמו כן ניתן להגדיר No ואז הלקוח לא ישמע את הספרות בכלל אלא יתקדם לתפריט האישור.
ברירת מחדל לאחר שהלקוח מקיש את הספרות, הוא משמיע את הספרות ללקוח ומבקש אישור, אם רוצים שלא יבקש אישור אלא מיד ידלג כאלו הלקוח אישר, יש להכניס בערך החמישי AskNo

אם רוצים לשנות הגדרות ברירת מחדל יש להכניס בקובץ

XXX-option=

כאשר XXX = מספר הקובץ של ההשמעה, לדוגמא 050 או 051 וכו'
דוגמא לעריכת קובץ 052
למה שבתוך קובץ

052-option=9-3-7-Digits-AskNo

המשמעות של הדוגמא היא
מקסימום 9 ספרות, לפחות 3 ספרות, לחכות 7 שניות, להשמיע את ההקשה בצורת ספרות,לא לשאול את הלקוח בקשת אישור אלא מיד להתקדם כאלו הלקוח כבר אישר.

SayFile - בערך הרביעי מאפשר לפתוח תיקיה כשם המוצר ובתוכו הקבצים להשמעה ואז המערכת במקום להשמיע ספרות או מספר המערכת תשמיע את הקובץ
מספר הספרות של הקובץ הוא 3 ספרות. גם באם האדם הקיש סיפרה אחת או שתים המערכת תשלים אפסים ל 3 ספרות.

כך שאם רוצים למשל בקובץ 053 לדוגמא במידה והלקוח הקיש 1 להשמיע
"מלפפונים" ובמקש 2 "עבניות"

יש להגדיר בערך הרביעי "SayFile" וכן ליצור תיקית 053 , ובפנים להכניס קובץ 001.wav שבו יושמע "מלפפונים" ובמקש 002.wav יושמע "עגבניות"
במידה ואין קובץ תואם אז ישמיע את הקשת הלקוח בצורת "ספרות"

brochabar

הודעות מערכת

ניתן להכניס קובץ שיושמע בהתחלה

M0000.wav

וכן קובץ שיושמע לאחר קבלת האישור נתונים

M0099.wav

או במקום הודעה

M0099

את קובץ M1447 - נרשמת בהצלחה

הקבצים השייכים

M1001 המקש שֶהוֹקַש שגוי
M1002 לא הוקשה בחירה
M1034 לאישור הקישו 1, להקשה מחודשת 2.
M1035 לא הקּשתּם את מינימום הספרות הנדרשות
M1056 להלן הפרטים שנקלטו
M1057 לאישור הקישו 1 לשמיעה חוזרת 2 להקלטה מחדש הקישו 3
M1340 נרשמת בהצלחה, אישור מספר
M1341 "לסיום הקישו 1.
לשמיעת מספר האישור פעם נוספת הקישו 2."
M1347 אין נתונים להשמעה
M1348 הרשמה זו התמלאה והסתיימה. שלום ותודה.

brochabar

מיקום שמירת הקבצים המתקבלים:

ההקלטות נשמרות בתוך תיקית Record שבתוך התיקיה, בשם הקובץ נמצאים כל הפרטים שהוקשו. ובתוך הקובץ עצמו כל הפרטים שהוקלטו.
בנוסף יש בתוך התיקיה קובץ בשם LogRecordingAndEnteringData.html
ובו כל הפעולות שהלקוח ביצע והכניס - שלב אחר שלב.

וכן בנוסף כל הפעולות שהסתיימו בהצלחה וקיבלו מספר אישור נרשמים בקובץ ApprovalAll.html בתיקיה.

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

recording_and_entering_data_copy_to_folder=8/6

בדוגמא כאן רואים שהקובץ ישוכפל גם לתיקיה 8/6 שתחת התיקיה הראשית של הלקוח

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

באם רוצים שיעתיק את הקובץ לתיקית היעד בתור הקובץ הגבוה באותה תיקיה יש לסמן בנוסף

recording_and_entering_data_copy_to_folder_type=next_file_number

brochabar

יציאה במהלך הרישום

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

skip_key=0
save_and_exit=0

בדוגמה רואים שע"י מקש 0 יוכל לסיים את הרישום

שימו לב! יש לציין בהקלטת השאלה - שאם רוצים לסיים את הרישום או שהשאלה הבאה לא רלוונטית לנשאל - יש להקיש .. וסולמית.
ואז הנרשם יועבר לשמיעת הודעת הסיום של הרישום
_______________

brochabar

קבלת מייל על כל הזמנה/הרשמה

אם רוצים שכל פעם שמאזין מסיים הזנת פרטים - ישלח אליכם מייל עם הפרטים

set_ok_send_mail=yes

במייל יגיע ההקלטה שהנרשם הקליט + קובץ ApprovalAll.html

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

set_ok_send_mail_special=yes

אם רוצים לקבל במייל גם את ההקלטות שלא הסתיימו בהצלחה, יש להגדיר:

set_temp_send_mail=yes

האיימיל שאליו נשלח - לכתובת ברירת המחדל של המערכת (כלומר מה שכתוב בכרטסת "הגדרות משתמש")
אם רוצים לשנות את הכתובת מייל
ניתן להגדיר זאת ע"י הערך הבא:

recording_and_entering_data_email_address=AAA@gmail.com

כאשר במקום AAA@gmail.com
אתם רושמים את הכתובת שאליו ישלח המייל

brochabar

לאחר הרישום - לאן ימשיך

ניתן להגדיר לעבור אחרי הרישום - לשלוחה אחרת, לדוגמא

recording_and_entering_data_end_goto=/8

באם רוצים שהשיחה תתנתק ניתן להגדיר

recording_and_entering_data_end_goto=hangup

ניתן להגדיר שמידה והלקוח לא סיים והלקוח ביקש לצאת / אין נתונים בכלל לקבלה
אז יעבור לאיפה שתגדירו

recording_and_entering_data_error_goto=/8

באם רוצים שהשיחה תתנתק ניתן להגדיר

recording_and_entering_data_error_goto=hangup

לכל ההגדרות הנוספות לחצו כאן