> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.deepmask.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Datensätze auswerten

`salesforce_summarize_records`

Beantwortet Fragen nach „wie viele"/„wie viel". Gruppieren Sie nach einem Feld, einem Zeitraum oder beidem, mit optionalen Filtern wie bei [`salesforce_find_records_smart`](/de/connectors/Salesforce/find-records-smart).

Um die Datensätze selbst aufzulisten, verwenden Sie Finden. Um gültige Feldnamen zu erfahren, verwenden Sie [`salesforce_explore_schema`](/de/connectors/Salesforce/explore-schema).

## Parameter

| Parameter | Typ | Erforderlich | Beschreibung |
| - | - | - | - |
| `object` | string | Ja | Objektbezeichnung oder API-Name. |
| `group_by` | string | Nein | Ein gruppierbares Feld (Bezeichnung oder API-Name). |
| `time_bucket` | `"day"` \| `"week"` \| `"month"` \| `"quarter"` \| `"year"` \| `"fiscal_quarter"` \| `"fiscal_year"` | Nein | Datensätze über `bucket_field` in Zeiträume gruppieren. |
| `bucket_field` | string | Nein | Datums-/Datetime-Feld für `time_bucket`. Standard: `CloseDate` bei Opportunity, sonst `CreatedDate`. |
| `metric_field` | string | Nein | Numerisches Feld für Summe/Mittelwert/Min/Max. Für diese Metriken erforderlich. |
| `metrics` | Array aus `"count"` \| `"sum"` \| `"avg"` \| `"min"` \| `"max"` | Nein | Standard: `["count"]`, oder `["count","sum"]`, wenn `metric_field` gesetzt ist. |
| `name_contains` | string | Nein | Teilstring des Namensfelds des Datensatzes. |
| `field_equals` | object | Nein | Exakte Filter (Bezeichnungen oder API-Namen). |
| `owner` | string | Nein | `"me"`, ein Name oder eine Benutzer-ID. |
| `date_field` | `"modified"` \| `"created"` | Nein | Zeitstempel für den Datumsbereich. |
| `date_from` | string | Nein | Inklusive Untergrenze, `YYYY-MM-DD`. |
| `date_to` | string | Nein | Inklusive Obergrenze, `YYYY-MM-DD`. |
| `top` | Zahl (1–50) | Nein | Max. zurückgegebene Gruppen. Standard: `20`. |
| `sort` | `"metric_desc"` \| `"metric_asc"` \| `"group_asc"` | Nein | Standard: `metric_desc` (`group_asc`, wenn `time_bucket` gesetzt ist). |
| `response_format` | `"markdown"` \| `"json"` | Nein | Standard: `"markdown"`. |

## Rückgabewert

Gruppierte Zeilen mit Metriken und einer Gesamtsumme. Die strukturierten Daten enthalten die Gruppierungsschlüssel und numerischen Werte.

## Beispielverwendung

> „Wie viele offene Opportunitys haben wir nach Phase?"

> „Summiere Amount für meine Opportunitys, die dieses Quartal abschließen, nach Monat."