AddColumns, DropColumns, RenameColumns, ופונקציות ShowColumns

חל על: אפליקציות Canvas Copilot Studio Desktop זורמות אפליקציות מונחות מודלים פונקציות Power Platform CLI Dataverse

צורות טבלה או רשומה על-ידי הוספה, שחרור, שינוי שם ובחירה בעמודות שלה.

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

מבט כולל

פונקציות אלה מקשות טבלה או רשומה על-ידי התאמת העמודות שלה:

• הפחת טבלה או רשומה המכילה עמודות מרובות כלפי מטה לעמודה בודדת לשימוש עם פונקציות של עמודה בודדת, כגון Lower או Sqrt.
• הוסף עמודה מחושבת לטבלה או רשומה (לדוגמה, העמודה Total Price המציגה את התוצאות של הכפלת כמותבמחיר יחידה).
• שנה שם עמודה לשם משמעותי יותר, לצורך הצגה למשתמשים או לשימוש בנוסחאות.

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

הערה

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

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

Description

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

הנוסחה מוערכת עבור הרשומה שסופקה, או עבור כל רשומה של הטבלה שסופקה.

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

הפונקציה DropColumns אינה כוללת עמודות בטבלה או ברשומה. כל העמודות האחרות נותרות ללא שינוי. DropColumns לא כולל עמודות וכולל ShowColumns עמודות.

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

הפונקציה ShowColumns כוללת עמודות של טבלה או רשומה ומשחררת את כל העמודות האחרות. באפשרותך להשתמש כדי ShowColumns ליצור טבלה או רשומה בת עמודה בודדת מתוך טבלה או רשומה מרובת עמודות. ShowColumns כוללת עמודות, ולא DropColumns כוללת עמודות.

עבור כל הפונקציות הללו, התוצאה היא טבלה או רשומה חדשה שהוחלה עליה ההמרה. הטבלה או הרשומה המקוריות אינן משתנות. לא ניתן לשנות טבלה או רשומה קיימת עם נוסחה. SharePoint, Microsoft Dataverse, SQL Server ומקורות נתונים אחרים מספקים כלים לשינוי עמודות של רשימות וטבלאות, הנקראות לעתים קרובות הסכימה. הפונקציות בנושא זה מחוללות המרה של טבלת קלט או רשומה בלבד, מבלי לשנות את המקור, לטבלת פלט או רשומה לשימוש נוסף.

הארגומנטים לפונקציות אלה תומכים בהקצאה. לדוגמה, פונקציית Filter משמשת כארגומנט למשיכת חיפושים ברשומות קשורות בכל הרישומים, גם אם מקור הנתונים '[dbo].[AllListings]' מכיל מיליון שורות:

AddColumns( RealEstateAgents,
   Listings,
   Filter(  '[dbo].[AllListings]', ListingAgentName = AgentName )
)

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

אם אתה משתמש AddColumns באופן זה, על המסנן לבצע שיחות נפרדות למקור הנתונים עבור כל אחת מהרשומות הראשונות הללו ב- RealEstateAgents, דבר הגורם לפטפוטים רבים ברשת. אם [dbo](.[AllListings] קטן מספיק ואינו משתנה לעתים קרובות. אתה יכול לקרוא לפונקציה Collect ב- OnStart כדי לשמור את מקור הנתונים באפליקציה שלך כאשר היא מתחילה. כאפשרות חלופית, אתה יכול לבנות מחדש את היישום שלך כך שתמשוך את הרשומות הקשורות רק כאשר המשתמש יבקש אותן.

הערה

ב- Power Apps לפני גרסה 3.24042, שמות העמודות צוינו עם מחרוזת טקסט באמצעות מרכאות כפולות, ואם מחוברים למקור נתונים הם גם צריכים להיות שמות לוגיים. לדוגמה, השם הלוגי "cr43e_name" עם מרכאות כפולות שימש במקום שם תצוגה שם ללא מרכאות. עבור מקורות נתונים של SharePoint ו-Excel המכילים שמות עמודות עם רווחים, כל רווח צוין עם "_x0020_", למשל "שם העמודה" כמו "Column_x0020_Name". אחרי גרסה זו, כל האפליקציות עודכנו אוטומטית לתחביר החדש המתואר במאמר זה.

תחביר

AddColumns( TableOrRecord, ColumnName1, Formula1 [, ColumnName2, Formula2, ... ] )

• TableOrRecord - נדרש. טבלה או רשומה תפעל.
• ColumnNames - חובה. שמות העמודות שיש להוסיף.
• נוסחאות - חובה. הנוסחאות להערכה עבור כל רשומה. התוצאה מתווספת כערך העמודה החדשה המתאימה. באפשרותך להפנות לעמודות אחרות של הטבלה או הרשומה בנוסחה זו.

DropColumns( TableOrRecord, ColumnName1 [, ColumnName2, ... ] )

• TableOrRecord - נדרש. טבלה או רשומה תפעל.
• ColumnNames - חובה. שמות העמודות שיש לשחרר.

RenameColumns( TableOrRecord, OldColumnName1, NewColumnName1 [, OldColumnName2, NewColumnName2, ... ] )

• TableOrRecord - נדרש. טבלה או רשומה תפעל.
• OldColumnNames - חובה. שמות העמודות לשינוי שם מהטבלה או הרשומה המקורית. רכיב זה מופיע ראשון בצמד הארגומנטים (או ראשון בכל צמד ארגומנטים אם הנוסחה כוללת יותר מצמד אחד).
• NewColumnNames - חובה. שמות חלופיים. רכיב זה מופיע אחרון בצמד הארגומנטים (או אחרון בכל צמד ארגומנטים אם הנוסחה כוללת יותר מצמד אחד).

ShowColumns( TableOrRecord, ColumnName1 [, ColumnName2, ... ] )

• TableOrRecord - נדרש. טבלה או רשומה תפעל.
• ColumnNames - חובה. שמות העמודות שיש לכלול.

דוגמאות

הדוגמאות במקטע זה משתמשות במקור הנתונים IceCreamSales, המכיל את הנתונים בטבלה זו:

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

נוסחה	Description	תוצאה
AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold )	מוסיפה עמודת הכנסות לתוצאה. עבור כל רשומה, מתבצעת הערכה של מחיר יחידה * כמות שנמכרה והתוצאה מוצבת בעמודה החדשה.
DropColumns( IceCreamSales, UnitPrice )	לא כוללת את העמודה מחיר יחידה בתוצאה. השתמש בפונקציה זו כדי לא לכלול עמודות, והשתמש בה ShowColumns כדי לכלול אותן.
ShowColumns(גלידה, טעם)	כוללת רק את העמודה טעם בתוצאה. השתמש בפונקציה זו כדי לכלול עמודות והשתמש בה DropColumns כדי לא לכלול אותן.
RenameColumns(IceCreamSales, UnitPrice, Price)	משנה את שם העמודה מחיר יחידה בתוצאה.
RenameColumns( IceCreamSales, UnitPrice, Price, QuantitySold, Number)	משנה את שם העמודות מחיר יחידה וכמות שנמכרה בתוצאה.
DropColumns( RenameColumns( AddColumns(IceCreamSales, Revenue, UnitPrice * QuantitySold ), מחיר ליחידה, מחיר ), כמות )	מבצעת את השינויים הבאים בטבלה לפי הסדר, החל מהחלק הפנימי של הנוסחה: מוסיפה עמודת הכנסות לפי החישוב לכל רשומה של מחיר יחידה * כמות. משנה את שם מחיר יחידה למחיר. לא כוללת את העמודה כמות. הסדר חשוב, לדוגמה, לא ניתן לחשב עם מחיר יחידה לאחר ששם העמודה השתנה.

שלב אחר שלב

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

1. צור אוסף על-ידי הוספת פקד Button והגדרת מאפיין OnSelect שלו לנוסחה זו:

   ClearCollect( IceCreamSales,
      Table(
          { Flavor: "Strawberry", UnitPrice: 1.99, QuantitySold: 20 },
          { Flavor: "Chocolate", UnitPrice: 2.99, QuantitySold: 45 },
          { Flavor: "Vanilla", UnitPrice: 1.50, QuantitySold: 35 }
      )
   )
   

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

3. הוסף פקד Button‎ שני, הגדר את מאפיין OnSelect שלו לנוסחה זו והפעל אותו:

   ClearCollect( FirstExample,
      AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold )
   )
   

4. בתפריט קובץ, בחר אוספים ולאחר מכן בחר IceCreamSales כדי להציג את האוסף.

   כפי שמראה האיור, הנוסחה השנייה לא שינתה את האוסף. הפונקציה AddColumnsהשתמשה ב- IceCreamSales כארגומנט לקריאה בלבד; הפונקציה לא שנתה את הטבלה שאליה מפנה ארגומנט זה.

   

5. בחר דוגמה ראשונה.

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

   

מיפוי עמודות ברכיב

ראה מיפוי עמודות.