משתני Power Fx

הערה

Microsoft Power Fx הוא השם החדש של שפת הנוסחה של יישומי בד ציור. מאמרים אלה פועלים כעת כאשר Microsoft את השפה מיאפליקציות בד ציור, משלבים אותה עם מוצרי Microsoft Power Platform אחרים והופכת אותה לזמינה קוד פתוח. התחל עם סקירה כללית של Microsoft Power Fx כדי לערוך היכרות עם השפה.

למד כיצד משתני Power Fx שונים ממשתנים בכלים כגון Visual Basic או JavaScript, ומתי נוסחאות הן בחירה טובה יותר. מאמר זה מסביר כיצד לבחור משתנים כלליים, משתני הקשר או אוספים לניהול ערכים ומדינה של אפליקציות.

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

במקרים מסוימים, עליך להשתמש במשתנים ב- Power Fx. Power Fx מרחיב Excel המודל של המשתמש על-ידי הוספת נוסחאות אופן פעולה. נוסחאות אלה פועלות כאשר, למשל, משתמש בוחר לחצן. בנוסחת אופן פעולה, לעתים קרובות כדאי להגדיר משתנה לשימוש בנוסחאות אחרות.

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

תרגם את Excel לתוך Power Fx

Excel

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

בדוגמה הבאה, תא A3 מוגדר לנוסחה A1+A2. אם A1 או A2 משתנים, A3 מחשב מחדש באופן אוטומטי כדי לשקף את השינוי. אופן פעולה זה לא דורש קידוד מלבד הנוסחה עצמה.

צילום מסך של Excel נוסחה מחושבת מחדש של הסכום לאחר שערך קלט משתנה.

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

Power Fx

לוגיקה שאתה יוצר ב- Power Fx פועלים באופן דומה מאוד ל- Excel. במקום לעדכן תאים, באפשרותך להוסיף פקדים בכל מקום שתרצה על המסך ולהעניק להם שמות כדי שתוכל להשתמש בהם בנוסחאות.

למשל, ב- Power Apps תוכל לשכפל את אופן הפעולה של Excel ביישום על-ידי הוספת פקד תווית בשם Label1ושני פקדי קלט טקסט בשם TextInput1 ו- TextInput2. אם תגדיר לאחר מכן את המאפיין Text של Label1 ל- TextInput1.Text + TextInput2.Text, הוא תמיד מציג את הסכום של המספרים הקיימים ב- TextInput1 וב- TextInput2 באופן אוטומטי.

צילום מסך של שני קלטי טקסט ותווית מחשבת סכום באמצעות נוסחת Power Fx.

שים לב שהפקד Label1 נבחר ומציג את הנוסחה טקסט שלו בשורת הנוסחאות בחלק העליון של המסך. כאן תמצא את הנוסחה TextInput1.Text + TextInput2.Text. הנוסחה הזו יוצרת תלות בין הפקדים האלו, בדיוק כמו שיחסי תלות נוצרים בין תאים בחוברת עבודה של Excel. בואו נשנה את הערך של TextInput1:

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

הנוסחה עבור תווית1 מחושבת מחדש באופן אוטומטי ומציגה את הערך החדש.

ב- Power Fx, אתה יכול להשתמש בנוסחאות כדי לקבוע לא רק את הערך הראשי של הפקד, אלא גם מאפיינים כמו עיצוב. בדוגמה הבאה, נוסחה עבור המאפיין צבע של התווית מציגה באופן אוטומטי ערכים שליליים באדום. הפונקציה If צריכה להיראות מוכרת מ- Excel:

If( Value(Label1.Text) < 0, Color.Red, Color.Black )

צילום מסך של נוסחת Power Fx שמחליף צבע תווית כאשר הערך המחושב שלילי.

תוכל להשתמש בנוסחאות למגוון רחב של תרחישים:

  • על-ידי שימוש ב- GPS של המכשיר, פקד מפה יכול להציג את המיקום הנוכחי עם נוסחה שמשתמשת ב- Location.Latitude וב- Location.Longitude. במהלך הניווט, המפה עוקבת באופן אוטומטי אחר המיקום שלך.
  • משתמשים אחרים יכולים לעדכן מקורות נתונים. לדוגמה, אנשים אחרים בצוות שלך עשויים לעדכן פריטים ברשימה של SharePoint. בעת רענון מקור נתונים, כל הנוסחאות התלויות מחושבות מחדש באופן אוטומטי כדי לשקף את הנתונים המעודכנים. אם תמקד את הדוגמה, תוכל להגדיר מאפיין פריטים של גלריה לנוסחה Filter( SharePointList ), המציגה באופן אוטומטי את ערכת הרשומות המסוננים החדשה.

היתרונות של נוסחאות Power Fx

השימוש בנוסחאות לבניית יישומים מציע יתרונות רבים:

  • אם אתה יודע Excel, אתה יודע Power Fx. המודל ושפת הנוסחאות זהים.
  • אם אתה משתמש בכלי תיכנות אחרים, שקול כמה קוד דרוש לך כדי לבצע דוגמאות אלה. ב- Visual Basic, עליך לכתוב מטפל באירועים עבור אירוע השינוי בכל פקד של קלט טקסט. הקוד לביצוע החישוב בכל אחד מהמטפלים באירועים אלה מיותר ו עלול לצאת מהסינכרון, או שעליך לכתוב תroutine משותף. ב- Power Fx, אתה משיג את כל העבודה עם נוסחה חד-קווית אחת.
  • כדי להבין מהיכן מגיע הטקסט של תווית1, אתה יודע בדיוק היכן לחפש: הנוסחה במאפיין טקסט. אין דרך אחרת להשפיע על הטקסט בפקד זה. בכלי תכנות מסורתי, כל מטפל באירועים או רוטינת משנה יכולים לשנות את ערך התווית, מכל מקום בתוכנית. גישה זו יכולה להקל עליך לאתר מתי והיכן משתנה השתנה.
  • אם המשתמש משנה פקד מחוון ולאחר מכן מתחרט, הוא יכול לשנות את המחוון בחזרה לערך המקורי שלו. זה כאילו שום דבר לא השתנה: היישום מציג את אותם ערכי פקדים כפי שהוא השתנה בעבר. אין השלכות להתנסות ולשאול "מה אם", בדיוק כמו שאין ב- Excel.

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

דע מתי להשתמש במשתנים

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

הצג תיאור
צילום מסך של אפליקציית הוספת מחשב עם אפס בסך הכל ו- 77 מוזנים בקלט הטקסט. כשהיישום מופעל, הסכום הצטבר הוא 0.

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

המשתמש בוחר בלחצן הוסף שוב.
צילום מסך של מחשב ההוספה המציג סכום מצטבר של 154 לפני שהמשתמש בוחר באפשרות נקה. 77 מתווסף שוב לסכום המצטבר והתוצאה היא 154.

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

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

לעיתים תזדקק למשתנה כדי שהיישום יפעל כרצוי. אבל לגישה מתלוות אזהרות:

  • עליך לעדכן ידנית את הסכום המצטבר. חישוב מחדש אוטומטי לא יעשה זאת עבורך.
  • לא ניתן לחשב את הסכום הכולל הפועל בהתבסס על הערכים של פקדים אחרים. זה תלוי בכמות הפעמים שהמשתמש בחר בלחצן הוסף ואיזה ערך היה בפקד text input בכל פעם. האם המשתמש הזין 77 ובחר הוסף פעמיים, או שהוא ציין 24 ו- 130 בכל הוספה? אינך יכול בחין בהבדל לאחר שהסכום הכולל מגיע ל- 154.
  • שינויים בסכום יכולים לנבוע מנתיבים שונים. בדוגמה זו, גם לחצן הוסף וגם לחצן נקה יכולים לעדכן את הסכום. אם היישום לא פועל כמצופה, איזה לחצן גורם לבעיה?

שימוש במשתנה כללי

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

כיצד עובדים משתנים כלליים:

  • השתמש בפונקציה Set כדי להגדיר את הערך של המשתנה הכללי. הפונקציה Set( MyVar, 1 ) מגדיר את המשתנה הגלובלי MyVar לערך של 1.
  • השתמש במשתנה הכללי על-ידי הפניה לשם שבו השתמשת עם הפונקציה Set. במקרה זה, MyVar מחזיר1.
  • משתנים כלליים יכולים לאחסן כל ערך, כולל מחזורות, מספרים, רשומות וטבלאות.

בוא נבנה מחדש את מנגנון ההוספה באמצעות משתנה כללי:

  1. הוסף פקד text input, ששמו TextInput1, ושני לחצנים ששמם Button1 ו- Button2.

  2. הגדר את המאפיין טקסט של Button1 בתור "הוסף", והגדר את המאפיין טקסט של Button2 בתור "נקה".

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

    קבוצה (סכום ריצה, סכום ריצה + קלט טקסט1.טקסט)

    עצם קיומה של נוסחה זו מבססת את RunningTotal‎ כמשתנה כללי שמאחסן מספר בגלל האופרטור +. תוכל להפנות אל RunningTotal‎ בכל מקום ביישום. בכל פעם שהמשתמש פותח יישום זה, ל- RunningTotal יש ערך התחלתי של ריק.

    בפעם הראשונה שהמשתמש בוחר בלחצן הוסף ו- Set זמין, RunningTotal מוגדר לערך של RunningTotal + TextInput1.

    צילום מסך של המאפיין 'הוסף לחצן OnSelect' באמצעות האפשרות 'הגדר לעדכון משתנה כללי של Power Fx'.

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

    קבוצה (סכום ריצה, 0)

    צילום מסך של המאפיין 'נקה לחצן OnSelect' באמצעות האפשרות 'הגדר' לאיפוס משתנה כללי של Power Fx.

  5. הוסף פקד תווית והגדר את מאפיין הטקסט ל- RunningTotal.

    נוסחה זו מחושבת מחדש באופן אוטומטי ומציגה למשתמש את הערך של RunningTotal בזמן שהוא משתנה בהתבסס על הלחצנים שהמשתמש בוחר.

    צילום מסך של מאפיין טקסט של תווית המציג את הערך של המשתנה הכללי RunningTotal.

  6. הצג את האפליקציה בתצוגה מקדימה ויש לך את מחשב ההוספה כפי שתואר קודם לכן. הזן מספר בתיבת הטקסט ולחץ על הלחצן הוסף כמה פעמים. כשתהיה מוכן, חזור אל חוויית העריכה באמצעות מקש Esc .

    צילום מסך של הוספת תצוגה מקדימה של מחשב עם ערך קלט והסכום הכולל הפועל המחושב.

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

    צילום מסך של האפשרות 'משתנים כלליים' שנבחרה מתפריט 'קובץ' בעורך היישום.

  8. כדי להציג את כל המקומות שבהם המשתנה מוגדר ונמצא בשימוש, בחר בו.

    צילום מסך של המיקומים שבהם משתנה כללי מוגדר ומשמש באפליקציה.

סוגי משתנים

ל- Power Fx יש שני סוגי משתנים:

סוג משתנה טווח‬ תיאור פונקציות שמבססות
משתנים כלליים יישום פשוט לשימוש. מכילה מספר, מחרוזת טקסט, בוליאני, רשומה, טבלה ועוד. באפשרותך להפנות אליה מכל מקום באפליקציה. מַעֲרֶכֶת
אוספים יישום מכיל טבלה שניתן להפנות בה מכל מקום באפליקציה. באפשרותך לשנות את תוכן הטבלה במקום להגדיר אותו כמשלם. באפשרותך לשמור אותו במכשיר המקומי לשימוש עתידי. לֶאֱסוֹף
קליר קולק

בעת שימוש Power Apps, אתה רואה סוג שלישי של משתנה:

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

יצירה והסרה של משתנים

אתה יוצר את כל המשתנים באופן משתמע כאשר הם מופיעים בפונקציה Set, UpdateContext, Navigate, Collect או ClearCollect . כדי להצהיר על משתנה ועל הסוג שלו, פשוט כלול אותו בכל אחת מפונקציות אלה בכל מקום באפליקציה. אף אחת מהפונקציות הללו לא יוצרת משתנים; הן רק ממלאות משתנים בערכים. לעולם אינך מצהיר על משתנים במפורש כפי שאתה עשוי לעשות בכלי תכנות אחר, וכל ההקלדה משתמעת מהשימוש.

לדוגמה, ייתכן שיש לך פקד לחצן עם נוסחה OnSelect ששווה ל- Set( X, 1 )‎. נוסחה זו קובעת את X כמשתנה עם סוג מספר. תוכל להשתמש ב- X בנוסחאות כמספר, ולמשתנה זה יש ערך של ריק לאחר פתיחת היישום אך לפני בחירת הלחצן. בעת בחירת הלחצן, אתה מעניק ל- X את הערך 1.

אם תוסיף לחצן נוסף ותגדיר את המאפיין OnSelect שלו ל- Set( X, "Hello"), תתרחש שגיאה מאחר שהסוג (מחרוזת טקסט) אינו תואם לסוג בערכה הקודמת (מספר ). כל ההגדרות המשתמעות של המשתנה חייבות להסכים על הסוג. שוב, כל זה קרה מכיוון שהזכרת X בנוסחאות, לא משום שנוסחאות אלה אינן פועלות בפועל.

הסרת משתנה על-ידי הסרת כל הפונקציות Set,‏ UpdateContext‏, Navigate, ‏Collect או ClearCollect שמבססות באופן משתמע את המשתנה. ללא פונקציות אלה, המשתנה לא קיים. עליך גם להסיר הפניות למשתנה מאחר שהן עשויות לגרום לשגיאה.

אורך חיי משתנה וערך התחלתי

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

תוכל לאחסן את התוכן של משתנה במקור נתונים באמצעות הפונקציה Patch או הפונקציה Collect. תוכל גם לאחסן ערכים באוספים במכשיר המקומי באמצעות הפונקציה SaveData.

כאשר המשתמש פותח את היישום, לכל המשתנים יש ערך התחלתי של ריק.

קריאת משתנים

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

Set( Radius, 12 )

לאחר מכן תוכל פשוט להשתמש ברדיוס בכל מקום שבו תוכל להשתמש במספר, והוא יחליף ב- 12:

Pi() * Power( Radius, 2 )

אם תיתן למשתנה הקשר את אותו השם כמשתנה כללי או אוסף, משתנה ההקשר יקבל קדימות. יחד עם זאת, אתה עדיין יכול להפנות למשתנה כללי או לאוסף אם אתה משתמש באופרטור ההבהרה[@Radius]‎.

השתמש במשתנה הקשר (Power Apps בלבד)

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

כיצד עובדים משתנים הקשר:

  • אתה יוצר ומגדיר משתני הקשר באופן מרומז באמצעות הפונקציה UpdateContext או Navigate. בעת הפעלת היישום, הערך התחלתי של כל משתני ההקשר הוא ריק.
  • אתה מעדכן משתני הקשר עם רשומות. בכלי תכנות אחרים, אתה בדרך כלל משתמש ב- "=" להקצאה, כמו ב- "x = 1". למשתני הקשר, השתמש ב- { x: 1 } במקום זאת. כשאתה משתמש במשתנה הקשר, השתמש בשם באופן ישיר ללא תחביר הרשומה.
  • בנוסף, ניתן להגדיר משתנה הקשר בעת השימוש בפונקציה Navigate כדי להציג מסך. אם אתה חושב על מסך כסוג של הליך או רוטינת משנה, גישה זו גומה להעברת פרמטר בכלי תכנות אחרים.
  • למעט Navigate, משתני הקשר מוגבלים להקשר של מסך יחיד, שממנו הם מקבלים את השם שלהם. אתה לא יכול להשתמש בהם מחוץ להקשר זה.
  • משתני הקשר יכולים לאחסן כל ערך, כולל מחזורות, מספרים, רשומות וטבלאות.

בוא נבנה מחדש את מנגנון ההוספה באמצעות משתנה הקשר:

  1. הוסף פקד text input, ששמו TextInput1, ושני לחצנים ששמם Button1 ו- Button2.

  2. הגדר את המאפיין טקסט של Button1 בתור "הוסף", והגדר את המאפיין טקסט של Button2 בתור "נקה".

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

    UpdateContext( { סכום ריצה: סכום ריצה + TextInput1.Text } )

    עצם קיומה של נוסחה זו מבססת את RunningTotal‎ כמשתנה הקשר שמאחסן מספר בגלל האופרטור +. תוכל להפנות אל RunningTotal‎ בכל מקום במסך זה. בכל פעם שהמשתמש פותח יישום זה, ל- RunningTotal יש ערך התחלתי של ריק.

    בפעם הראשונה שהמשתמש בוחר בלחצן הוסף ו- UpdateContext זמין, RunningTotal מוגדר לערך של RunningTotal + TextInput1.

    צילום מסך של המאפיין 'הוסף לחצן OnSelect' המעדכן את משתנה ההקשר RunningTotal.

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

    עדכון הקשר ( { סה"כ פועל: 0 } )

    שוב, UpdateContext נמצא בשימוש בנוסחה UpdateContext( { RunningTotal: 0 } ).

    צילום מסך של המאפיין לחצן נקה OnSelect המאפס את משתנה ההקשר RunningTotal.

  5. הוסף פקד תווית והגדר את מאפיין הטקסט ל- RunningTotal.

    נוסחה זו מחושבת מחדש באופן אוטומטי ומציגה למשתמש את הערך של RunningTotal בזמן שהוא משתנה בהתבסס על הלחצנים שהמשתמש בוחר.

    צילום מסך של מאפיין טקסט של תווית המציג את ערך משתנה ההקשר RunningTotal.

  6. הצג את האפליקציה בתצוגה מקדימה ויש לך את מחשב ההוספה כפי שתואר קודם לכן. הזן מספר בתיבת הטקסט ולחץ על הלחצן הוסף כמה פעמים. כשתהיה מוכן, חזור אל חוויית העריכה באמצעות מקש Esc .

    צילום מסך של התצוגה המקדימה של היישום עם ערך קלט טקסט ומשתנה תלוי הקשר המפעיל סכום.

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

    ניווט (מסך1, ללא, { סה"כ פועל: -1000 } )

    צילום מסך של מאפיין OnSelect של לחצן באמצעות ניווט כדי להעביר משתנה הקשר ל- Screen1.

    החזק את מקש Alt לחוץ בעת בחירת לחצן זה כדי להציג את Screen1 ולהגדיר את משתנה ההקשר RunningTotal ל- -1000.

    צילום מסך של Screen1 לאחר ניווט מגדיר את משתנה ההקשר RunningTotal ל- 1000 שלילי.

  8. כדי להציג את הערך של משתנה ההקשר, בחר בתפריט קובץ ולאחר מכן בחר משתנים בחלונית הימנית.

    צילום מסך של האפשרות 'משתנים' תלוית ההקשר שנבחרה מתפריט 'קובץ' בעורך היישום.

  9. בחר את משתנה ההקשר כדי לראות היכן הוא מוגדר ומשמש.

    צילום מסך של המיקומים שבהם משתנה הקשר מוגדר ומשמש באפליקציה.

שימוש באוסף

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

כיצד אוספים עובדים:

  • השתמש בפונקציה ClearCollect כדי ליצור ולהגדיר אוספים. באפשרותך להשתמש בפונקציה Collect במקום זאת, אך היא דורשת באופן יעיל משתנה אחר במקום להחליף את הישן.
  • אוסף הוא סוג של מקור נתונים, ולפיכך גם טבלה. כדי לגשת לערך יחיד באוסף, השתמש בפונקציה First וחלץ שדה אחד מהרשומה שהתקבלה. אם אתה משתמש בערך יחיד עם ClearCollect, ערך זה הוא השדה ערך , כמו בדוגמה הבאה:
    ערך ראשון (שם משתנה).

בוא ניצור מחדש את מנגנון ההוספה על-ידי שימוש באוסף:

  1. הוסף פקד text input ששמו TextInput1, ושני לחצנים ששמם Button1 ו- Button2.

  2. הגדר את המאפיין טקסט של Button1 בתור "הוסף", והגדר את המאפיין טקסט של Button2 בתור "נקה".

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

    איסוף (PaperTape, TextInput1.Text)

    עצם הקיום של הנוסחה הזו מבסס את PaperTape כאוסף שמאחסן טבלה בעלת עמודה יחידה של מחרוזות הטקסט. תוכל להפנות אל PaperTape‎ בכל מקום ביישום. בכל פעם שמשתמש פותח יישום זה, PaperTape הוא טבלה ריקה.

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

    צילום מסך של המאפיין 'הוסף לחצן OnSelect' שאוסף ערך קלט ב- PaperTape.

  4. כדי לנקות את הדבק כשהמשתמש בוחר בלחצן נקה, הגדר את המאפיין OnSelect שלו לנוסחה:

    שקוף (ניירטייפ)

    צילום מסך של המאפיין 'נקה לחצן OnSelect' המנקה את כל הערכים מ- PaperTape.

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

    סכום (סרט נייר, ערך)

    צילום מסך של מאפיין טקסט של תווית המשתמש ב- Sum כדי לחשב את הסכום הכולל המצטבר של PaperTape.

  6. להפעלת מנגנון ההוספה, הקש על F5 כדי לפתוח תצוגה מקדימה, הזן מספרים בפקד text input ובחר לחצנים.

    צילום מסך של מכונת ההוספה מבוססת האוסף עם ערך קלט וסכום מצטבר.

  7. כדי לחזור לסביבת העבודה המהווה ברירת מחדל, הקש על מקש Esc.

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

    ניירטייפ

    בחלונית השמאלית, בחר ערוך שדות ולאחר מכן בחר הוסף שדה, בחר בעמודה ערך ולאחר מכן בחר הוסף כדי להציג אותה.

    צילום מסך של טבלת נתונים המציגה את הערכים שנוספו לאוסף PaperTape.

  9. כדי לראות את הערכים באוסף שלך, בחר אוספים בתפריט קובץ.

    צילום מסך של התצוגה 'אוספים' המציגה את הערכים המאוחסנים באוסף PaperTape.

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

    נקה(ניירטייפ); טען נתונים(ניירטייפ, "ניירטייפ מאוחסן", אמת)

    אתה צריך לנקות את האוסף הראשון מכיוון ש- LoadData יצרף את הערכים המאוחסנים לסוף האוסף.

    צילום מסך של המאפיין 'טען לחצן OnSelect' ניקוי וטעינה של אוסף PaperTape.

  11. הגדר את המאפיין OnSelect של לחצן שמור לנוסחה:

    שמור נתונים (קלטת נייר, "קלטתנייר מאוחסנת")

    צילום מסך של לחצן 'שמור' במאפיין OnSelect שומר את אוסף PaperTape באופן מקומי.

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