> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/experience-components/ax-metric.md).

# AX - Kennzahl

## Übersicht

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

Verwenden Sie es, um Portalbenutzern wichtige Kennzahlen auf einen Blick anzuzeigen, z. B. ihre Gesamtbestellungen, die durchschnittliche Lösungszeit von Fällen, die Anzahl offener Tickets oder jede benutzerdefinierte Berechnung wichtiger Zahlen auf einen Blick, z. B. ihre Gesamtbestellungen, die durchschnittliche Lösungszeit von Fällen, die Anzahl offener Tickets oder jede benutzerdefinierte Berechnung aus ihren Daten. Konfigurieren Sie die Metrikbeschriftung, das Symbol, die Formatierung und die Datenquelle in Experience Builder ohne Code.

Perfekt für Portaldashboards, Kontozusammenfassungen, Leistungs-Scorecards 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 Metrik-Komponente kennenzulernen und mit dem Erstellen Ihrer Anwendungsfälle zu beginnen.

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

## Konfiguration

### **Bezeichnung**

Geben Sie Ihrer Metrik eine beschreibende Bezeichnung (z. B. „Gesamtumsatz“, „Aktive Benutzer“). Dies dient als Titel und gibt dem angezeigten Wert Kontext.

<figure><img src="/files/d4a755852fdf7b9cc3226f52131135e45b3024d5" alt="" width="563"><figcaption></figcaption></figure>

### **Beschreibung**

Bieten Sie zusätzlichen Kontext oder zusätzliche Einblicke im Zusammenhang mit der Metrik. 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 Metrik ein. Sie haben zwei Möglichkeiten:

#### **Manuelle Eingabe**

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

#### **Abfrage**

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

<figure><img src="/files/c4a7fce69d1c72a09635a8646ff226dbd21daa95" alt=""><figcaption><p>Beispiel: Anzahl der in diesem Jahr neu erstellten Konten</p></figcaption></figure>

### **Sekundärwert**

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

### **Präfix & Suffix**

Fügen Sie Symbole oder Abkürzungen hinzu, um Kontext zu geben. Verwenden Sie z. B. „$“ für Währungen, „#“ für Mengen oder „K“ für Tausende. Der Sekundärwert hat sein eigenes **Sekundäres Präfix** und **Sekundäres Suffix**.

### **Tooltip**

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

### **Avatar**

Stellen Sie die Metrik visuell mit einem Bild, Initialen oder Symbol dar. Dadurch wird die Metrik wiedererkennbarer und ansprechender.

### **Formatierung der primären und sekundären Metrik**

Verfeinern Sie, wie Ihre Metrikwerte angezeigt werden:

* **Formatstil:** Dezimal, Währung, Prozent – wählen Sie das beste Format für Ihre Daten.
* **Vorzeichen:** Automatisch, positiv, negativ – steuern Sie, wie Vorzeichen angezeigt werden.
* **Ziffern:** Geben Sie die Mindest- und Höchstanzahl an Ganzzahl- und Dezimalstellen an.
* **Signifikante Ziffern:** Auf eine bestimmte Anzahl von Ziffern runden, um die Lesbarkeit zu verbessern.
* **Trendfarbe anzeigen:** Verwenden Sie Farbe, um positive (grün) oder negative (rot) Trends sofort anzuzeigen

Mit ihrer Flexibilität und den vielfältigen Optionen ermöglicht Ihnen die Avonni-Metrik-Komponente, komplexe Daten auf vereinfachte und wirkungsvolle Weise darzustellen, und ist damit ein wertvolles Asset für jede Experience-Cloud-Site, die ihren Benutzern verwertbare Einblicke bieten möchte.

## Styling

{% tabs %}
{% tab title="Ausrichtung" %}
Legen Sie die **Ausrichtung** und **Sekundäre Ausrichtung** des Metrik-Inhalts.
{% endtab %}

{% tab title="Bezeichnung" %}

* **Farbe / Schriftgröße / Schriftstil / Schriftstärke / Zeilenbegrenzung:** Gestalten Sie den Beschriftungstext.
  {% endtab %}

{% tab title="Beschreibung" %}

* **Farbe / Schriftgröße / Schriftstil / Schriftstärke / Zeilenbegrenzung:** Gestalten Sie den Beschreibungstext.
  {% endtab %}

{% tab title="Wert" %}

* **Farbe / Schriftgröße / Schriftstil / Schriftstärke / Zeilenhöhe:** Gestalten Sie den primären Wert.
  {% endtab %}

{% tab title="Präfix & Suffix" %}

* **Farbe / Schriftgröße / Schriftstil / Schriftstärke:** Gestalten Sie das primäre Präfix und Suffix.
  {% endtab %}

{% tab title="Sekundärwert" %}

* **Farbe / Schriftgröße / Schriftstil / Schriftstärke:** Gestalten Sie den sekundären Wert, das Präfix und das Suffix.
  {% endtab %}

{% tab title="Trend" %}

* **Farbe für negativ / neutral / positiv:** Legen Sie die Trendfarben für den primären Wert fest.
* **Sekundärer Trend:** Legen Sie die Farbe, die Hintergrundfarbe und den Radius für negative, neutrale und positive sekundäre Trends fest.
  {% endtab %}

{% tab title="Avatar" %}

* **Symbolhintergrund- / Vordergrundfarbe, Rahmen, Initialen, vertikale Ausrichtung:** Gestalten Sie den Metrik-Avatar.
  {% endtab %}
  {% endtabs %}

## Anwendungsfälle

### Beispiel 1: Betrag der gewonnenen Opportunity auf dem Konto

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

Stellen Sie den gesamten abgeschlossenen und gewonnenen Umsatz auf jeder Kontoseite in den Mittelpunkt und geben Sie Partnerbenutzern einen sofortigen Überblick über den Wert der Beziehung, ohne den Datensatz zu verlassen.

***

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

* **Einblick in den zusammengefassten Umsatz:** Zeigen Sie eine Echtzeit-Summe aller mit dem Konto verknüpften, abgeschlossenen und gewonnenen Opportunity-Beträge an und geben Sie Partnern sofort Einblick in den Kundenwert.

***

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

{% stepper %}
{% step %}

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

Ziehen Sie die AX – Metrik-Komponente in Experience Builder auf Ihrer Kontodetailseite.
{% 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: `Amount`
  * Aggregatfunktion: `SUM`
    {% endstep %}

{% step %}

#### **Filter anwenden**

Beschränken Sie die Abfrage nur auf das aktuelle Konto und gewonnene Abschlüsse:

* Konto-ID: `{!Item.Id}`
* Phase: `Geschlossen gewonnen`
  {% endstep %}

{% step %}

#### **Anzeige anpassen**

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

{% step %}

#### **Zeigen Sie eine Vorschau Ihrer Komponente an**

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

***

#### **Links**

{% content-ref url="/pages/54b24d7f0e3f517b74a9f5f342e0be72bcd75108" %}
[AX - Profilkarte](/experience-cloud/experience-cloud-de/experience-components/ax-profile-card.md)
{% endcontent-ref %}

{% content-ref url="/pages/a253f06b22ccd6ec4f2fe11cd4ee49a608cc1dce" %}
[AX - Datensatzdetail](/experience-cloud/experience-cloud-de/experience-components/ax-record-detail.md)
{% endcontent-ref %}

***

### Beispiel 2: Offene Fälle auf dem Konto

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

Geben Sie Partnerbenutzern direkt auf der Kontoseite eine Live-Zählung offener Fälle, damit sie die Supportlast schnell einschätzen und ihre Kontaktaufnahme entsprechend priorisieren können.

***

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

* **Offene-Fälle-Zählung auf einen Blick:** Zeigen Sie die Gesamtzahl der mit einem Konto verknüpften aktiven Fälle an und helfen Sie Partnern, über den Kundenstatus informiert zu 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 AX – Metrik-Komponente in Experience Builder auf Ihrer Kontodetailseite.
{% 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`
  * Aggregatfunktion: `COUNT`
    {% endstep %}

{% step %}

#### **Filter anwenden**

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

{% step %}

#### **Anzeige anpassen**

* Legen Sie die Beschriftung auf `Offene Fälle`
  {% endstep %}

{% step %}

#### **Zeigen Sie eine Vorschau Ihrer Komponente an**

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
