Udostępnij przez


Funkcja Summarize

Dotyczy: Funkcje interfejsu wiersza polecenia interfejsu wiersza polecenia programu Copilot Studio Desktop w programie Copilot Studio Desktop

Summarize rekordytabeli , grupując co najmniej jedną kolumnę.

Podpis

Funkcja służy Summarize do grupowania rekordów tabeli i podsumowywania kolumn w grupie.

Pierwszym argumentem jest Summarize tabela do działania. Pozostałe argumenty mogą być w dowolnej kolejności i należeć do dwóch kategorii:

  • Nazwy kolumn grup. Użyj ich, aby określić, według których kolumn chcesz grupować.
  • Formuły podsumowujące. Użyj ich, aby podsumować kolumny w tabeli ThisGroup . Ta grupa to tabela, która zawiera wszystkie kolumny oryginalnej tabeli, ale jest ograniczona tylko do rekordów jednej grupy naraz na podstawie kolumn grupy. Każda formuła musi mieć nazwę kolumny Jak dla w tabeli wynikowej.

Tabela to wartość w usłudze Power Apps, podobnie jak ciąg lub liczba. Tabela może zostać określona jako argument dla funkcji, a funkcja może zwrócić tabelę. Summarize nie modyfikuje tabeli; zamiast tego przyjmuje tabelę jako argument i zwraca inną tabelę. Aby uzyskać więcej szczegółów, zobacz artykuł dotyczący pracy z tabelami.

Delegowanie

Summarize można delegować w zależności od źródła danych i złożoności formuł podsumowania. Podstawowe funkcje agregujące, takie jak Sum, Average, Max, Min, CountRows i Concat , mają duże szanse na delegowanie.

Jeśli pełne delegowanie formuły nie jest możliwe, środowisko tworzenia oznacza ostrzeżeniem część, której nie można delegować. Gdy jest to możliwe, należy rozważyć zmianę formuły, tak aby nie zawierała funkcji i operatorów, których nie można delegować.

Aby uzyskać więcej informacji, zobacz Omówienie delegowania.

Składnia

Summarize( Tabela, GroupByColumnName1 [, GroupByColumnName2, ... ] [, SummarizeColumns as SummarizeNames, ...] )

  • Tabela - Wymagane. Tabela do podsumowania.
  • GroupByColumnNames — co najmniej jedna z nich jest wymagana. Nazwy kolumn w Tabeli, według których grupowane będą rekordy. Te kolumny stają się kolumnami w tabeli wynikowej.
  • SummarizeColumns - Opcjonalne. Formuła podsumowująca na tabeli ThisGroup dla każdej grupy.
  • SummarizeNames — wymagane dla każdej kolumny SummarizeColumn. Każda kolumna podsumowana musi mieć jawną nazwę tabeli wyjściowej.

Przykłady

Prosty przykład

  1. Utwórz tabelę na Power Fx hoście z tymi przykładowymi danymi:
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}
    )
)
  1. Oceń następującą formułę:
Summarize( CityPopulations, Country,
           Sum( ThisGroup, Population ) As 'Total Population',
           Concat( ThisGroup, City, ", " ) As Cities 
)

Wynikiem jest ta tabela:

Country/Region Populacja ogółem Miejscowości
Zjednoczone Królestwo 8615000 Londyn
Niemcy 6816000 Berlin, Hamburg, Monachium
Hiszpania 4767000 Madryt, Barcelona
Włochy 4218000 Rzym, Mediolan
Francja 2273000 Paryż

Wiele kolumn grupowych

  1. Utwórz tabelę na Power Fx hoście z tymi przykładowymi danymi:
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"]}
   )
)
  1. Oceń następującą formułę:
Summarize( Inventory, Supplier, Fruit, Average( ThisGroup, Price ) As 'Average Price' )
Owoc Dostawca Średnia cena
Winogrona Contoso 215
Cytryny Fabrikam 30.5
Cytryny Contoso 29
Banany Contoso 12