# AX - Kennzahl

## Übersicht

**AX - Kennzahl** ist eine Experience-Cloud-Komponente, die berechnete Werte aus Salesforce-Datensätzen anzeigt — wie Summen, Durchschnittswerte, Zählungen und andere Aggregationen — auf Experience-Sites-Seiten.

Verwenden Sie sie, um Portalbenutzern wichtige Kennzahlen auf einen Blick anzuzeigen, etwa ihre Gesamtbestellungen, die durchschnittliche Zeit bis zur Falllösung, die Anzahl offener Tickets oder beliebige benutzerdefinierte Berechnungen aus ihren Daten. Konfigurieren Sie das Kennzahlen-Label, das Symbol, die Formatierung und die Datenquelle in Experience Builder ganz ohne Code.

Perfekt für Portal-Dashboards, Kontozusammenfassungen, Leistungsübersichten oder überall dort, wo Portalbenutzer wichtige Kennzahlen zu ihren Datensätzen sehen müssen, ohne Berichte auszuführen.

***

## Erste Schritte

Verwenden Sie dieses einfache Tutorial, um die Grundlagen der Kennzahlenkomponente kennenzulernen und mit der Umsetzung Ihrer Anwendungsfälle zu beginnen.

{% @arcade/embed flowId="SXruKm5NX2h4AYOxH2EQ" url="<https://app.arcade.software/share/SXruKm5NX2h4AYOxH2EQ>" %}

***

## **Konfigurationsoptionen**

### **Bezeichnung**

Geben Sie eine aussagekräftige Bezeichnung für Ihre Kennzahl an (z. B. „Gesamtumsatz“, „Aktive Benutzer“). Diese dient als Titel und gibt dem angezeigten Wert Kontext.

<figure><img src="https://4175360472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fdkdljav9L5OJ4AV8JpZf%2F2024-06-29_07-58-05-22.png?alt=media&#x26;token=d2a5f093-46bb-4de9-b71f-2809b0d92477" alt="" width="563"><figcaption></figcaption></figure>

### **Beschreibung**

Bieten Sie zusätzlichen Kontext oder weitere Einblicke zur Kennzahl. Dies kann eine kurze Erklärung, eine Trendbeschreibung oder unterstützende Informationen sein, um das Verständnis zu verbessern.

### **Wert**

Geben Sie den primären numerischen Wert der Kennzahl ein. Sie haben zwei Optionen:

#### **Manuelle Eingabe**

Geben Sie den Wert direkt ein, wenn er leicht verfügbar ist.

#### **Abfrage**

Nutzen Sie die Leistungsfähigkeit der Salesforce Object Query Language, um den Wert dynamisch aus Ihren Salesforce-Daten abzurufen. Beispielsweise können Sie mithilfe einer Abfrage für das Account-Objekt die Gesamtzahl der in diesem Jahr erstellten Konten berechnen.

<figure><img src="https://4175360472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FOnkkESHduipa4glofK06%2F2024-06-29_07-58-05.png?alt=media&#x26;token=1a89bdd9-6334-4d10-91a9-290555bf167f" alt=""><figcaption><p>Beispiel: Neue Konten zählen, die in diesem Jahr erstellt wurden</p></figcaption></figure>

### **Sekundärwert**

Zeigen Sie eine zusätzliche Kennzahl zum Vergleich oder für weiteren Kontext an. Dies kann der Wert eines vorherigen Zeitraums, ein Zielwert oder ein anderer relevanter sekundärer Datenpunkt sein.

### **Präfix und Suffix**

Fügen Sie Symbole oder Abkürzungen hinzu, um Kontext zu geben. Verwenden Sie zum Beispiel „$“ für Währung, „#“ für Mengen oder „K“ für Tausend.

### **Quickinfo**

Geben Sie beim Darüberfahren weitere Details an. Erklären Sie die Kennzahl kurz oder liefern Sie zusätzliche Einblicke.

### **Avatar**

Stellen Sie die Kennzahl visuell mit einem Bild, Initialen oder Symbol dar. Dadurch wird die Kennzahl besser erkennbar und ansprechender.

### **Formatierung primärer und sekundärer Kennzahlen**

Passen Sie die Anzeige Ihrer Kennzahlenwerte fein an:

* **Formatstil:** Dezimal, Währung, Prozentsatz – wählen Sie das passende Format für Ihre Daten.
* **Vorzeichen des Werts:** Automatisch, positiv, negativ – steuern Sie, wie Vorzeichen angezeigt werden.
* **Ziffern:** Geben Sie die minimale und maximale Anzahl von Ganzzahl- und Dezimalstellen an.
* **Signifikante Ziffern:** Runden Sie zur besseren Lesbarkeit auf eine bestimmte Anzahl von Ziffern.
* **Trendfarbe anzeigen:** Verwenden Sie Farben, um positive (grün) oder negative (rot) Trends sofort anzuzeigen

Mit seiner Flexibilität und seinen vielfältigen Optionen ermöglicht Ihnen die Avonni-Metrikkomponente, komplexe Daten auf vereinfachte und wirkungsvolle Weise darzustellen, und macht sie zu einem wertvollen Werkzeug für jede Experience-Cloud-Site, die ihren Benutzern umsetzbare Erkenntnisse bieten möchte.

***

## Anwendungsbeispiele

### Beispiel 1: Betrag gewonnener Kontomöglichkeiten

{% @arcade/embed flowId="KEG70at1gkiT4HyGtaBj" url="<https://app.arcade.software/share/KEG70at1gkiT4HyGtaBj>" %}

Stellen Sie den gesamten Umsatz aus abgeschlossenen gewonnenen Deals auf jeder Kontoseite in den Mittelpunkt und geben Sie Partnern einen unmittelbaren Blick auf den Wert der Beziehung, ohne den Datensatz verlassen zu müssen.

***

#### **Was Sie erreichen werden**

* **Gebündelte Umsatzsichtbarkeit:** Zeigen Sie in Echtzeit die Summe aller Beträge gewonnener Chancen an, die mit dem Konto verknüpft sind, und geben Sie Partnern so sofort Einblick in den Kundenwert.

***

#### **So richten Sie es ein**

{% stepper %}
{% step %}

#### **Fügen Sie die Komponente zu Ihrer Seite hinzu**

Ziehen Sie die Komponente AX – Kennzahl in Experience Builder auf Ihrer Detailseite für Konten per Drag-and-drop hinein.
{% endstep %}

{% step %}

#### **Datenquelle konfigurieren**

* Klicken Sie in das Feld Wert und richten Sie eine Abfrage mit den folgenden Einstellungen ein:
  * Objekt-API-Name: `Opportunity`
  * Feld: `Betrag`
  * Aggregationsfunktion: `SUMME`
    {% endstep %}

{% step %}

#### **Filter anwenden**

Beschränken Sie die Abfrage auf das aktuelle Konto und nur gewonnene Deals:

* Konten-ID: `{!Item.Id}`
* Phase: `Abgeschlossen gewonnen`
  {% endstep %}

{% step %}

#### **Anzeige anpassen**

* Setzen Sie die Bezeichnung auf `Gewonnener Betrag`
* Setzen Sie das Avatar-Symbol auf `standard:opportunity`
  {% endstep %}

{% step %}

#### **Vorschau Ihrer Komponente**

* Verwenden Sie die Vorschau in Experience Builder, um zu bestätigen, dass die Kennzahl vor der Veröffentlichung korrekt gerendert wird.
  {% endstep %}
  {% endstepper %}

***

#### **Links**

{% content-ref url="ax-profilkarte" %}
[ax-profilkarte](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/experience-components/ax-profilkarte)
{% endcontent-ref %}

{% content-ref url="ax-datensatzdetail" %}
[ax-datensatzdetail](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/experience-components/ax-datensatzdetail)
{% endcontent-ref %}

***

### Beispiel 2: Offene Kontofälle

{% @arcade/embed flowId="S4TjnIAEL1dUly6hcTtg" url="<https://app.arcade.software/share/S4TjnIAEL1dUly6hcTtg>" %}

Geben Sie Partnern direkt auf der Kontoseite eine Live-Anzahl ungelöster Fälle, damit sie die Support-Auslastung schnell einschätzen und ihre Maßnahmen entsprechend priorisieren können.

***

#### **Was Sie erreichen werden**

* **Anzahl offener Fälle auf einen Blick:** Zeigen Sie die Gesamtzahl der aktiven Fälle an, die mit einem Konto verknüpft sind, damit Partner über den Kundenstatus informiert bleiben, ohne zu einer separaten Liste navigieren zu müssen.

***

#### **So richten Sie es ein**

{% stepper %}
{% step %}

#### **Fügen Sie die Komponente zu Ihrer Seite hinzu**

Ziehen Sie die Komponente AX – Kennzahl in Experience Builder auf Ihrer Detailseite für Konten per Drag-and-drop hinein.
{% endstep %}

{% step %}

#### **Datenquelle konfigurieren**

* Klicken Sie in das Feld Wert und richten Sie eine Abfrage mit den folgenden Einstellungen ein:
  * Objekt-API-Name: `Fall`
  * Feld: `Id`
  * Aggregationsfunktion: `ANZAHL`
    {% endstep %}

{% step %}

#### **Filter anwenden**

* Beschränken Sie die Abfrage auf das aktuelle Konto und nur offene Fälle:
  * Konten-ID: `{!Item.Id}`
  * Geschlossen: `falsch`
    {% endstep %}

{% step %}

#### **Anzeige anpassen**

* Setzen Sie die Bezeichnung auf `Offene Fälle`
  {% endstep %}

{% step %}

#### **Vorschau Ihrer Komponente**

* Verwenden Sie die Vorschau in Experience Builder, um zu bestätigen, dass die Anzahl vor der Veröffentlichung korrekt angezeigt wird.
  {% endstep %}
  {% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/experience-components/ax-kennzahl.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
