בסיס נתונים מקומי וספארי
בשלב זה של המדריך, נבנה את תהליכי השמירה של המידע שמזין המשתמש (תאור דירה, מחיר ותמונות). המידע ישמר ב"בסיס נתונים מקומי" - מערכת לשמירה ואחזור של מידע שנמצאת בכל מכשיר אייפון (וגם בכל דפדפן ספארי - הדפדפן של אפל). משלב זה ואילך, רצוי לבדוק את האפליקציה באמצעות ספארי. משתמשי Windows יכולים להוריד את ספארי מהאתר של אפל.
אם ספארי אינו דפדפו ברירת המחדל של מערכת ההפעלה, אפשר להגדיר לטרסוס להשתמש בו ע"י שינוי ההעדפות :
- פתח את חלון ההעדפות ( ב Windows בחר מהתפריט Window->Preferences במק Tersus Studio->Preferences )
- בחלון ההעדפות בחר General/Web Browser, והגדר שם את ספארי כדפדפן החיצוני
בהעדר ספארי (בד"כ בסביבת לינוקס), ניתן לדמות את השימוש בבסיס הנתונים המקומי ע"י שימוש בבסיס הנתונים של שרת האפליקציה (בזמן פיתוח שרת האפליקציה הוא חלק מסביבת הפיתוח):
- מהתפריט הראשי, בחר Window->Show View->Properties
- התמקד בתרשים המערכת (המלבן החיצוני ביותר - Rentals). כדי "לצאת החוצה" מאלמנים פנימיים הקלק פעמיים קרוב לשולי התרשים, או השתמש בכפתור Zoom Out.
- לאחר שבחרת את תרשים המערכת, שנה את התכונה clientSideDatabase מ local ל server.
בניית תהליך שמירת הנתונים
- התמקד בכפתור "OK" של ה Dialog ושנה את שמו ל"Save".
- הוסף Action בשם Save New Apartment
- הוסף reference לDialog (Add Ancestor Reference -> Apartment Dialog)
- הוסף מבנה נתונים של רשומה (מה-Palette בחר Data Types/Database Record) וקרא לרשומה Apartment Record:
- הוסף לרשומה את האלמנטים הבאים:
- Apartment Id (שדה מספרי: מה Palette בחר Data Types/Number)
- Description (שדה טקסטואלי: מה Palette בחר Data Types/Text)
- Price (שדה מספרי)
- חבר חץ מתוך האלמנט <Value> של שדה הקלט Description לתוך השדה Description ברשומה:
- באופן דומה, חבר חץ שייאכלס את שדה המחיר
- הוסף את אבן הבניין Sequence Number כדי לייצר מזהה ייחודי לדירה. קרא לSequence Number "Apartment Id", וחבר את היציאה אל השדה Apartment Id ברשומה
- הוסף את אבן הבנין Insert, וקרא לה Insert Apartment Record. פעולה זו תשמור את נתוני הדירה בבסיס הנתונים המקומי:
- על מנת לשמור את התמונות (אם ישנן), הוסף Action בשם Save Picture. הפוך את ה-Action למרובה (כפתור ימני -> Repetitive ), והוסף שתי כניסות. תן לכניסות את השמות Apartment Id ו Picture (כדי לשנות שם, בחר כניסה ולחץ F2)
- חבר את השדה Apartment Id ואת האלמנט Picture ב Body אל הכניסות המתאימות. בזמן ריצה, הפעולה תופעל מספר פעמים - כמספר התמונות שנאספו.
- השמירה בפועל של כל תמונה תתבצע בתוך Save Picture:
- התמקד ב Save Picture
- הוסף רשומת בסיס נתונים בשם Picture Record
- הוסף לרשומה שדות מספריים שׁPicture Id ו שׁApartment Id ושדה טקסטואלי Data URL
- הוסף Sequence Number בשם Picture Id וחבר את היציאה שלו לשדה המתאים
- הוסף את Picture כ Data Element (Copy ואז Paste (Reuse))
- חבר את הכניסה Picture לאלמנט החדש, ואת השדה <Path> של התמונה אל השדה Data URL ברשומה)
- הוסף Insert (בשם Insert Picture Record) וחבר את הרשומה אל הכניסה של ה Insert
- הוסף ל Save New Apartment "יציאת סיום" (כפתור ימני -> Add Element -> <Done> )
- הוסף לכפתור "Save" את אבן הבנין Close Window (מה-Palette, בקטגוריה Display Actions). אבן בניין זו תסגור את ה Dialog
- הוסף ל Close Window כניסת בקרה (Add Element ->Control) וחבר את היציאה של Save New Apartment לכניסה של Close Window. המשמעות של חיבור זה היא שהפעולה Close Window תופעל רק אחרי שתסתיים פעולת השמירה.
- אם נשמור כעת את השינויים ונפעיל את האפליקציה, הדירה והתמונות ירשמו בבסיס הנתונים אך עדיין לא נוכל לראותם באפליקציה.