פונקציה זאת גורמת להופעת מסך הכנסת פרמטרים.
לדוגמא:
מבנה: המבנה הכללי של @prompt הוא :
@Prompt('message','type',[lov],Mono|Multi,free|constrained,persistent|not_persistent,[default_values])
- Message –כותרת ההודעה שתופיע למשתמש
- Type- סוג הנתון שעל המשתמש להכניס. יכול לקבל את הערכים הבאים:
- A-עבור מחרוזת טקסט
- N-עבור ערכים מספריים
- D- עבור ערכים מסוג תאריך
- LOV –מכיל את רשימת הערכים שתופיע למשתמש. במקרה זה יש 2 אפשרויות:
- רשימה מקודדת הננמצאת בתוך {} וכל ערך כלוא בתוך ‘’ ומופרד על ידי ,. לדוגמא :
{‘Baker’,’John’} - רשימת ערכים של אובייקט קיים ע"י class\object בתוך ‘’ . לדוגמא ‘Customer\region’ יתן את רשימת הערכים של אובייקט region מתיקיית customer.
- Mono\multi האם לאפשר למשתמש לבחור ערך יחיד או ערכים רבים.
- Free\ constrained האם המשתמש יקליד ערך בצורה חופשית (free) או להכריח אותו לבחור ערך מתוך רשימת הערכים (constrained).
- persistent|not_persistent החל מגרסא Boxi 3.x , האם לשמור את הערך של ההרצה הקודמת כערך ברירת המחדל בPrompt. שימו לב Persistent גובר על ערך הdefault value שמוסבר בסעיף הבא.
- default_values. החל מגרסא Boxi 3.x, ערך ברירת המחדל שיופיע בprompt. ערך זה צריך להופיע בתוך ‘’ ותחום על ידי {}. לדוגמא : {‘James’}. הערה: אם אנו משתמשים ברשימת הערכים הבנויה מרשימת ערכים של אובייקט. ערך הDefault חייב להיות אחד מרשימה זאת.
שימוש:
פונקציית הPrompt@ היא מאד חשובה לבניית העולמות וDesigners משתמשים בה לעיתים מזומנות.
ביתר פירוט:
- יצירת פילטרים. פונקציית הPrompt@ מאפשרת לDesigners יצירת התניות משוכללות יותר מאשר התניה רגילה שנעשית על ידי המשתמש. לדוגמא, כפיית רשימת הערכים על המשתמש. עקב כך , Designers משתמשים בזה כדי ליצור התניות שלא ניתן לבצע בדרך אחרת.
- Self joins. אנו רוצים ליצור מצב שבכל פעם שבו משתמש יתמש באובייקט הבנוי על טבלה מסויימת ייפתח לו חלון המבקש ממנו להכניס פרמטר. לדוגמא: אם יש לנו עולם המבוסס על מחסן נתונים, לא נרצה שהמשתמש יריץ שאילתא על טבלת הfact המכילה 20 מליון רשומות בלי שיכניס תאריכים. אי לכך, נגדיר self join על הטבלה עם הכנסת תאריכים.
- יצירת אובייקטים. לעתים הDesigner בוחר ליצור אובייקטים שבהם המשתמש מכניס ערכים ורק לאחר מכן האובייקט נוצר.
דוגמאות:
@Prompt('Enter Customer','A',,,) יבקש מהמשתמש להכניס ערך טקסט שיופיע על הPrompt "enter customer".
דוגמא לפילטר:
@Select(Customer\Customer) in ( @Prompt('Enter Customer ','A','Customer\Region',Mono,Constrained,,))
האובייקט של שם האזור יהיה שווה לprompt אשר יבקש להכניס את האזור, מתוך רשימת הערכים של האובייקט ואשר תיתן להכניס ערך בודד.