> 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-es/experience-components/ax-metric.md).

# AX - Métrica

## Resumen

**AX - Métrica** es un componente de Experience Cloud que muestra valores calculados de registros de Salesforce —como totales, promedios, recuentos y otras agregaciones— en las páginas de Experience Sites.

Úsalo para mostrar a los usuarios del portal métricas clave de un vistazo, como su total de pedidos, el tiempo medio de resolución de casos, el número de tickets abiertos o cualquier cálculo personalizado derivado de sus datos. Configura la etiqueta de la métrica, el icono, el formato y la fuente de datos en Experience Builder sin código.

Perfecto para paneles del portal, resúmenes de cuentas, tarjetas de rendimiento o cualquier lugar donde los usuarios del portal necesiten ver números clave sobre sus registros sin ejecutar informes.

***

## Primeros pasos

Usa este sencillo tutorial para aprender los conceptos básicos del componente Métrica y empezar a crear tus casos de uso.

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

***

## **Opciones de configuración**

### **Etiqueta**

Proporciona una etiqueta descriptiva para tu métrica (por ejemplo, "Ventas totales", "Usuarios activos"). Esto sirve como título y da contexto al valor mostrado.

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

### **Descripción**

Ofrece contexto adicional o información relacionada con la métrica. Puede ser una breve explicación, una descripción de tendencia o información de apoyo para mejorar la comprensión.

### **Valor**

Introduce el valor numérico principal de la métrica. Tienes dos opciones:

#### **Entrada manual**

Introduce directamente el valor si está fácilmente disponible.

#### **Consulta**

Aprovecha el poder de Salesforce Object Query Language para obtener dinámicamente el valor de tus datos de Salesforce. Por ejemplo, puedes calcular el número total de cuentas creadas este año usando una consulta sobre el objeto Account.

<figure><img src="/files/f7860cad66c40234be298fe848e0ecdf863730bf" alt=""><figcaption><p>Ejemplo: contar nuevas cuentas creadas este año</p></figcaption></figure>

### **Valor secundario**

Muestra una métrica adicional para comparación o para dar más contexto. Puede ser el valor de un período anterior, un valor objetivo o cualquier punto de datos secundario relevante.

### **Prefijo y sufijo**

Añade símbolos o abreviaturas para proporcionar contexto. Por ejemplo, usa "$" para moneda, "#" para cantidades o "K" para miles.

### **Información sobre herramientas**

Ofrece más detalles al pasar el cursor por encima. Explica brevemente la métrica o proporciona información adicional.

### **Avatar**

Representa visualmente la métrica con una imagen, iniciales o un icono. Esto hace que la métrica sea más reconocible y atractiva.

### **Formato de la métrica principal y secundaria**

Ajusta cómo se muestran los valores de tu métrica:

* **Estilo de formato:** Decimal, moneda, porcentaje: elige el mejor formato para tus datos.
* **Signo del valor:** Automático, positivo, negativo: controla cómo se muestran los signos.
* **Dígitos:** Especifica el número mínimo y máximo de dígitos enteros y decimales.
* **Dígitos significativos:** Redondea a un número específico de dígitos para facilitar la lectura.
* **Mostrar color de tendencia:** Usa color para indicar al instante tendencias positivas (verde) o negativas (rojo)

Con su flexibilidad y su amplia gama de opciones, el componente Avonni Metric te permite presentar datos complejos de una manera simplificada e impactante, convirtiéndolo en un recurso valioso para cualquier sitio de Experience Cloud que busque ofrecer información accionable a sus usuarios.

***

## Ejemplos de casos de uso

### Ejemplo 1: importe de oportunidades ganadas de la cuenta

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

Sitúa los ingresos totales cerrados como ganados en el centro de cada página de cuenta, ofreciendo a los usuarios asociados una vista inmediata del valor de la relación sin salir del registro.

***

#### **Lo que lograrás**

* **Visibilidad de ingresos acumulados:** Muestra una suma en tiempo real de todos los importes de oportunidades cerradas como ganadas vinculadas a la cuenta, brindando a los socios una visión instantánea del valor del cliente.

***

#### **Cómo configurarlo**

{% stepper %}
{% step %}

#### **Añade el componente a tu página**

Arrastra el componente AX – Metric a Experience Builder en la página de detalles de tu cuenta.
{% endstep %}

{% step %}

#### **Configurar la fuente de datos**

* Haz clic en el campo Valor y configura una consulta con los siguientes ajustes:
  * Nombre de API del objeto: `Opportunity`
  * Campo: `Amount`
  * Función de agregación: `SUM`
    {% endstep %}

{% step %}

#### **Aplicar filtros**

Limita la consulta a la cuenta actual y solo a los tratos ganadores:

* ID de cuenta: `{!Item.Id}`
* Etapa: `Cerrado ganado`
  {% endstep %}

{% step %}

#### **Personaliza la visualización**

* Establece la etiqueta en `Importe ganado`
* Establece el icono del avatar en `standard:opportunity`
  {% endstep %}

{% step %}

#### **Previsualiza tu componente**

* Usa la vista previa de Experience Builder para confirmar que la métrica se renderiza correctamente antes de publicarla.
  {% endstep %}
  {% endstepper %}

***

#### **Enlaces**

{% content-ref url="/pages/df4acbb907e4cf7ef56d5f7f91e15709688f2a5a" %}
[AX - Tarjeta de perfil](/experience-cloud/experience-cloud-es/experience-components/ax-profile-card.md)
{% endcontent-ref %}

{% content-ref url="/pages/6a856c7c8b3637fb27d083fcab206f6a975dee64" %}
[AX - Detalle del registro](/experience-cloud/experience-cloud-es/experience-components/ax-record-detail.md)
{% endcontent-ref %}

***

### Ejemplo 2: casos abiertos de la cuenta

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

Ofrece a los usuarios asociados un recuento en vivo de los casos sin resolver directamente en la página de la cuenta, para que puedan evaluar rápidamente la carga de soporte y priorizar su contacto en consecuencia.

***

#### **Lo que lograrás**

* **Recuento de casos abiertos de un vistazo:** Muestra el número total de casos activos vinculados a una cuenta, ayudando a los socios a mantenerse informados sobre la salud del cliente sin tener que ir a una lista aparte.

***

#### **Cómo configurarlo**

{% stepper %}
{% step %}

#### **Añade el componente a tu página**

Arrastra el componente AX – Metric a Experience Builder en la página de detalles de tu cuenta.
{% endstep %}

{% step %}

#### **Configurar la fuente de datos**

* Haz clic en el campo Valor y configura una consulta con los siguientes ajustes:
  * Nombre de API del objeto: `Caso`
  * Campo: `Id`
  * Función de agregación: `COUNT`
    {% endstep %}

{% step %}

#### **Aplicar filtros**

* Limita la consulta a la cuenta actual y solo a los casos abiertos:
  * ID de cuenta: `{!Item.Id}`
  * Cerrado: `false`
    {% endstep %}

{% step %}

#### **Personaliza la visualización**

* Establece la etiqueta en `Casos abiertos`
  {% endstep %}

{% step %}

#### **Previsualiza tu componente**

* Usa la vista previa de Experience Builder para confirmar que el recuento se renderiza correctamente antes de publicarlo.
  {% 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-es/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.
