Summarize دالة

ينطبق على: تدفقات Copilot Studio Desktop لوظائف Power Platform CLI Dataverse

Summarize سجلاتجدول عن طريق التجميع على عمود واحد أو أكثر.

الوصف

استخدم الدالة Summarize لتجميع سجلات جدول وتلخيص الأعمدة في المجموعة.

الوسيطة الأولى هي Summarize الجدول الذي يجب العمل عليه. يمكن أن تكون الوسيطات المتبقية بأي ترتيب وتنقسم إلى فئتين:

• تجميع أسماء الأعمدة. استخدم هذه لتحديد الأعمدة التي تريد تجميعها عليها.
• صيغ التلخيص. استخدم هذه لتلخيص الأعمدة في جدول ThisGroup . ThisGroup هو جدول يحتوي على جميع أعمدة الجدول الأصلي ، ولكنه يقتصر على سجلات مجموعة واحدة فقط في كل مرة استنادا إلى أعمدة المجموعة. يجب تسمية كل صيغة باسم العمود As في جدول النتائج.

جدول عبارة عن قيمة في Power Apps، تمامًا مثل سلسلة أو رقم. يمكنك تحديد جدول كوسيطة لوظيفة، ويمكن للوظيفة إرجاع جدول. Summarize لا يعدل جدولا؛ بدلا من ذلك يأخذ جدولا كوسيطة ويعيد جدولا مختلفا. لمزيد من المعلومات، راجع التعامل مع الجداول

تفويض

Summarize يمكن تفويضها استنادا إلى مصدر البيانات وتعقيد صيغ التلخيص. تتمتع وظائف التجميع الأساسية مثل Sum و Average و Max و Minو CountRows و Concat بفرصة جيدة للتفويض.

إذا لم يكن التفويض الكامل لصيغة ممكنا، تقوم بيئة التأليف بوضع علامة على الجزء الذي لا يمكن تفويضه مع تحذير. إن أمكن، ففكر في تغيير الصيغة لتجنب الوظائف وعوامل التشغيل التي لا يمكن تفويضها.

لمزيد من المعلومات، راجع نظرة عامة على التفويض.

بناء الجملة

Summarize( Table, GroupByColumnName1 [, GroupByColumnName2, ... ] [، SummarizeColumns As SummarizeNames, ...] )

• الجدول - مطلوب. الجدول الذي سيتم تلخيصه.
• GroupByColumnNames - مطلوب واحد على الأقل. أسماء الأعمدة في الجدول الذي يتم فيه تجميع السجلات. تصبح هذه الأعمدة أعمدة في الجدول الناتج.
• تلخيص الأعمدة - اختياري. صيغة تلخيص فوق جدول هذه المجموعة لكل مجموعة.
• تلخيص الأسماء - مطلوب لكل عمود تلخيص. يجب تسمية كل عمود ملخص بشكل صريح لجدول الإخراج.

الأمثلة

مثال بسيط

1. أنشئ جدولا في مضيفك Power Fx باستخدام نموذج البيانات هذا:

Set( CityPopulations,
   Table(
        { City: "London",    Country: "United Kingdom", Population: 8615000},
        { City: "Berlin",    Country: "Germany",        Population: 3562000},
        { City: "Madrid",    Country: "Spain",          Population: 3165000},
        { City: "Rome",      Country: "Italy",          Population: 2874000},
        { City: "Paris",     Country: "France",         Population: 2273000},
        { City: "Hamburg",   Country: "Germany",        Population: 1760000},
        { City: "Barcelona", Country: "Spain",          Population: 1602000},
        { City: "Munich",    Country: "Germany",        Population: 1494000},
        { City: "Milan",     Country: "Italy",          Population: 1344000}
    )
)

2. قيم الصيغة التالية:

Summarize( CityPopulations, Country,
           Sum( ThisGroup, Population ) As 'Total Population',
           Concat( ThisGroup, City, ", " ) As Cities 
)

والنتيجة هي هذا الجدول:

Country/Region	مجموع السكان	المدن
المملكة المتحدة	8615000	لندن
ألمانيا	6816000	برلين، هامبورغ، ميونخ
إسبانيا	4767000	مدريد، برشلونة
إيطاليا	4218000	روما, ميلانو
فرنسا	2273000	باريس

أعمدة مجموعة متعددة

1. أنشئ جدولا في مضيفك Power Fx باستخدام نموذج البيانات هذا:

Set( Inventory, 
   Table(
      {Supplier:"Contoso",  Fruit:"Grapes",  Price:220, Purchase:Date(2015,10,1), Tags: ["Red","Seedless"]},
      {Supplier:"Fabrikam", Fruit:"Lemons",  Price:31,  Purchase:Date(2015,10,1), Tags: ["Colombia"]},
      {Supplier:"Contoso",  Fruit:"Lemons",  Price:29,  Purchase:Date(2015,10,2), Tags: ["Peru"]},
      {Supplier:"Contoso",  Fruit:"Grapes",  Price:210, Purchase:Date(2015,10,2), Tags: ["Green","Seedless"]},
      {Supplier:"Fabrikam", Fruit:"Lemons",  Price:30,  Purchase:Date(2015,10,3), Tags: ["Mexico","Seedless"]},
      {Supplier:"Contoso",  Fruit:"Bananas", Price:12,  Purchase:Date(2015,10,3), Tags: ["Mexico"]}
   )
)

2. قيم الصيغة التالية:

Summarize( Inventory, Supplier, Fruit, Average( ThisGroup, Price ) As 'Average Price' )

فاكهة	مزوّد	متوسط السعر
عنب	Contoso	215
الليمون	Fabrikam	30.5
الليمون	Contoso	29
الموز	Contoso	12