שתף באמצעות

הפקדים 'ערוך טופס' ו'הצג טופס' ב- Power Apps

  • מאמר

הצג, ערוך וצור רשומה במקור נתונים.

תיאור

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

טופס לדוגמה ופקדי תצוגת טופס.

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

בחירת רשומה

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

ניתן גם להגדיר מאפיין Item של טופס באמצעות פקד רשימה נפתחת, כפי שמתואר בנושא הצגה, עריכה או הוספה של רשומה, או פונקציה כגון Lookup או First. לדוגמה, באפשרותך להגדיר את המאפיין Item לאחת מהנוסחאות הללו כדי להציג את הערך Fabrikam בטבלה תיקי לקוחות ב- Microsoft Dataverse:

First(Accounts)

Lookup(Accounts, "Fabrikam" in name)

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

יצירת רשומה

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

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

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

טופס עובר חזרה למצב עריכה אם הפונקציה ResetForm פועלת או אם הפונקציה SubmitForm פועלת בהצלחה.

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

שמירת שינויים

אם אתה יוצר לחצן שמור שינויים כמתואר בסעיף הקודם, המשתמש יכול ליצור או לעדכן רשומה ולאחר מכן לבחור בלחצן זה כדי לשמור את השינויים במקור הנתונים. אפשר, במקום זאת, להגדיר פקד תמונה או פקד אחר לביצוע אותה משימה, כל עוד אתה מגדיר את הפקד באמצעות הפונקציה SubmitForm. בכל מקרה, המאפיינים Error, ErrorKind, OnSuccess ו- OnFailure מספקים משוב על התוצאה.

כאשר הפונקציה SubmitForm פועלת, היא מאמתת תחילה את הנתונים שהמשתמש רוצה להגיש. אם שדה חובה אינו מכיל ערך או שערך אחר אינו תואם לאילוץ אחר, המאפיינים מסוג ErrorKind מוגדרים והנוסחה OnFailure פועלת. ניתן להגדיר את לחצן שמור שינויים או פקד אחר כך שהמשתמש יכול לבחור בו רק אם הנתונים חוקיים (כלומר, אם המאפיין Valid של הטופס הוא true). שים לב שהמשתמש צריך לא רק לתקן את הבעיה, אלא גם לבחור שוב בלחצן שמור שינויים (או לבטל את השינויים על-ידי בחירה בלחצן ביטול, כמתואר קודם לכן) כדי לאפס את המאפיינים Error ו- ErrorKind.

אם הנתונים עוברים אימות, הפונקציה SubmitForm שולחת אותם למקור הנתונים; תהליך זה עשוי להימשך זמן רב, בהתאם להשהיית הרשת.

  • אם השליחה מצליחה, המערכת מנקה את המאפיין Error, המאפיין ErrorKind מוגדר ל- ErrorKind.None והנוסחה OnSuccess פועלת. אם המשתמש יצר רשומה (כלומר, אם הטופס היה בעבר במצב חדש), הטופס עובר למצב עריכה כך שהמשתמש יכול לערוך את הרשומה החדשה שנוצרה, או רשומה אחרת.
  • אם השליחה נכשלה, המאפיין Error מכיל הודעת שגיאה ידידותית למשתמש ממקור הנתונים, שמסבירה את הבעיה. המאפיין ErrorKind מוגדר כהלכה, תלוי בבעיה והנוסחה OnFailure פועלת.

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

עצה

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

פריסה

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

לקבלת מידע נוסף, ראה הכרת פריסת טופס נתונים.

‏‫מאפיינים עיקריים‬

DataSource – מקור הנתונים שמכיל את הרשומה שהמשתמש יציג, יערוך או ייצור.

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

DefaultMode - המצב הראשוני של פקד הטופס. עיין בתיאור של Mode להלן לקבלת הערכים המקובלים והמשמעויות שלהם.

DisplayMode - המצב שבו יש להשתמש בכרטיסי נתונים ובפקדים בתוך פקד הטופס.

נגזר מן המאפיין Mode ואינו ניתן להגדרה באופן עצמאי:

מצב DisplayMode תיאור
FormMode.Edit DisplayMode.Edit כרטיסי נתונים ופקדים ניתנים לעריכה, מוכנים לקבל שינויים ברשומה.
FormMode.New DisplayMode.Edit כרטיסי נתונים ופקדים ניתנים לעריכה, מוכנים לקבל רשומה חדשה.
FormMode.View DisplayMode.View כרטיסי נתונים ופקדים אינם ניתנים לעריכה וממוטבים להצגה.

Error - הודעת שגיאה ידידותית למשתמש להצגה עבור טופס זה כאשר הפונקציה SubmitForm נכשלת.

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

ErrorKind – אם מופיעה שגיאה כאשר הפונקציה SubmitForm פועלת, סוג השגיאה שאירעה.

  • חל על פקד ערוך טופס בלבד.
  • מאפיין זה כולל ספירה דומה לזו של הפונקציה Errors. פקד ערוך טופס יכול להחזיר את הערכים הבאים:
ErrorKind תיאור
ErrorKind.Conflict משתמש אחר שינה את אותה רשומה, כך שנגרמה התנגשות שינויים. הפעל את הפונקציה Refresh כדי לטעון מחדש את הרשומה ולנסות שוב את השינוי.
ErrorKind.None השגיאה היא מסוג לא ידוע.
ErrorKind.Sync מקור הנתונים דיווח על שגיאה. עיין במאפיין Error לקבלת מידע נוסף.
ErrorKind.Validation זוהתה בעיית אימות כללית.

Item - הרשומה ב- DataSource שהמשתמש יציג או יערוך.

LastSubmit – הרשומה האחרונה שנשלחה בהצלחה, כולל כל שדה שנוצר על-ידי שרת.

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

Mode הפקד נמצא במצב עריכה או חדש.

מצב תיאור
FormMode.Edit המשתמש יכול לערוך רשומה באמצעות הטופס. הערכים בכרטיסי הטופס מאוכלסים מראש ברשומה הקיימת, לשינוי על-ידי המשתמש. אם הפונקציה SubmitForm פועלת בהצלחה, רשומה קיימת משתנה.
FormMode.New המשתמש יכול ליצור רשומה באמצעות הטופס. הערכים בפקדי הטופס מאוכלסים מראש בערכי ברירת המחדל עבור רשומה של מקור הנתונים. אם הפונקציה SubmitForm פועלת בהצלחה, רשומה נוצרת.
FormMode.View המשתמש יכול להציג רשומה באמצעות הטופס. הערכים בפקדי הטופס מאוכלסים מראש בערכי ברירת המחדל עבור רשומה של מקור הנתונים.

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

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

OnFailure - פעולות לביצוע כאשר פעולת נתונים לא הצליחה.

  • מאפיין זה חל אך ורק על הפקד ערוך טופס.

OnReset - פעולות לביצוע כאשר הפקד ערוך טופס מתאפס.

  • מאפיין זה חל אך ורק על הפקד ערוך טופס.

OnSuccess - פעולות לביצוע כאשר פעולת נתונים הצליחה.

  • מאפיין זה חל אך ורק על הפקד ערוך טופס.

Unsaved - נכון אם הפקד ערוך טופס מכיל שינויי משתמש שלא נשמרו.

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

Updates - הערכים לכתיבה במקור הנתונים עבור רשומה שנטענה בפקד טופס.

  • מאפיין זה חל אך ורק על הפקד ערוך טופס.
  • השתמש במאפיין זה כדי לחלץ את ערכי השדות מן הכרטיסים שבתוך הפקד. כעת תוכל להשתמש בערכים אלה כדי לעדכן באופן ידני את מקור הנתונים עם קריאת פונקציה Patch או שיטה אחרת שנחשפה על-ידי חיבור. אינך צריך להשתמש במאפיין זה אם אתה משתמש בפונקציה SubmitForm.
  • מאפיין זה מחזיר רשומה של ערכים. לדוגמה, אם פקד הטופס מכיל פקדי כרטיסים עבור השדות שם וכמות וערכי המאפיינים Update עבור אותם כרטיסים מחזירים "רכיב גרפי" ו- 10 בהתאמה, הרי שהמאפיין Updates עבור פקד הטופס יחזיר { ‏Name: "Widget", Quantity: 10 }.

Valid - אם פקד כרטיס או ערוך טופס מכיל ערכים חוקיים, המוכנים לשליחה אל מקור הנתונים.

  • מאפיין זה חל אך ורק על הפקד ערוך טופס.

  • מאפיין Valid של פקד טופס צובר את המאפיינים Valid של כל הפקדים מסוג כרטיס בטופס. מאפיין Valid של טופס הוא true רק אם הנתונים בכל הכרטיסים באותו טופס חוקיים; אחרת, המאפיין Valid של הטופס הוא false.

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

    SubmitButton.DisplayMode = If(IsBlank( Form.Error ) || Form.Valid, DisplayMode.Edit, DisplayMode.Disabled)

מאפיינים נוספים

BorderColor – הצבע של גבול הפקד.

BorderStyle – מציין אם גבול של פקד הוא מלא, מקווקו, מנוקד, או ללא.

BorderThickness – העובי של גבול פקד.

Fill - צבע הרקע בפקד.

Height - המרחק שבין הקצה העליון לקצה התחתון של פקד.

Visible - אם מופיע פקד או שהוא מוסתר.

Width - המרחק שבין הקצה הימני לקצה השמאלי של פקד.

X – המרחק שבין הקצה השמאלי של פקד לקצה השמאלי של הגורם המכיל של האב שלו (מסך אם אין גורם מכיל של אב).

Y – המרחק שבין הקצה העליון של פקד לקצה העליון של הגורם המכיל של האב (מסך אם אין גורם מכיל של אב).

מידע נוסף

הנחיות נגישות

תמיכה בקוראי מסך

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