> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.boxhero.io/docs/documentation/it/altre-funzionalita/custom-analytics.md).

# Analisi personalizzate

<figure><img src="/files/34ddde2ee0c73545566c35fa4dae06b3e9f5c2d8" alt=""><figcaption></figcaption></figure>

***

## Punti salienti

* Fai domande in linguaggio semplice e l' **Assistente AI** scrive il SQL per te.
* Usa SQL per interrogare i tuoi dati BoxHero.
* Combina condizioni (ad es. articolo, attributo, prezzo, intervallo di date, partner) per definire i dati che vuoi restituire come report personalizzato.
* Salva le query che usi spesso e riaprile in qualsiasi momento.
* Esporta i risultati in Excel per ulteriori analisi o reportistica.

## Casi d'uso

La funzionalità standard <mark style="color:$primary;">`Report di inventario`</mark> ti offre una rapida panoramica delle metriche chiave come la quantità media di stock e il turnover di inventario per un periodo selezionato. Poiché questi report utilizzano formule e campi predefiniti, potrebbero non coprire ogni tipo di analisi di cui il tuo team ha bisogno.

<mark style="color:$primary;">`Analisi personalizzate`</mark> ti offre più controllo su come esplori i tuoi dati. È particolarmente utile quando:

* Non riesci a trovare i dati di cui hai bisogno nella funzionalità standard [Report di inventario](/docs/documentation/it/altre-funzionalita/analytics.md)
* Vuoi filtrare o raggruppare i dati per articolo, fornitore, cliente, membro del team o altre condizioni dettagliate
* Hai bisogno di analisi basate sul tempo come mensili, trimestrali o anno su anno
* Vuoi salvare i report su cui fai affidamento e riutilizzarli
* Hai bisogno di dati flessibili per supportare la reportistica o il processo decisionale

***

## Come utilizzare l'analisi personalizzata

### 1. Per iniziare

Vai a <mark style="color:$primary;">`Report`</mark> > <mark style="color:$primary;">`Analisi personalizzate`</mark>. Questo apre un nuovo spazio di lavoro in cui puoi creare e gestire le tue query SQL. Quindi, seleziona <mark style="color:$primary;">`+ Nuovo`</mark> per creare una nuova query.

<figure><img src="/files/f1e44f9f33c6bc99323efa16bf7c59e89121aacc" alt=""><figcaption></figcaption></figure>

### 2. Scrivi una query

Hai due modi per scrivere query:

1. **Usa l'Assistente AI** per generare SQL da una domanda in linguaggio naturale (consigliato per la maggior parte degli utenti).
2. **Scrivi direttamente SQL** usando [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction).

<figure><img src="/files/91d26eb93b9284748cfae3ef4d59a3235fe2cdea" alt=""><figcaption></figcaption></figure>

#### L'uso dell'Assistente AI

La <mark style="color:$primary;">`Assistente AI`</mark> trasforma le domande in linguaggio naturale in query SQL funzionanti. Non devi conoscere SQL per usarlo.&#x20;

Digita la tua domanda nel pannello dell'assistente e premi Invio. L'assistente genera il SQL, lo applica all'editor ed esegue la query. I risultati appaiono sotto la query.

Puoi modificare il SQL generato prima di salvare, se vuoi apportare qualche modifica.

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/38e5c1fa675d1d7f16b1d9e95a6aabd4/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/38e5c1fa675d1d7f16b1d9e95a6aabd4/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

**Domande di esempio**

* Articoli sotto il livello di scorta di sicurezza
* Cosa non è stato venduto negli ultimi 90 giorni?
* I 10 SKU migliori per unità vendute questo mese
* Ordini di acquisto aperti oltre la data prevista di arrivo
* Livelli di stock per sede&#x20;

#### Creare query riutilizzabili

Puoi chiedere all'assistente di includere filtri regolabili in una query, come intervalli di date o nomi dei partner. L'assistente utilizza le variabili di query, così puoi modificare gli input in seguito senza riscrivere il SQL.

Ad esempio, chiedendo *"vendite per articolo per un intervallo di date che posso modificare"* viene generata una query con una variabile di data che richiede un input ogni volta che la query viene eseguita.

<figure><img src="/files/c6dca324b58465f346b94247ee036f46d8ade540" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
L'Assistente AI funziona meglio con **domande** **specifiche**. \
Invece di *"mostrami le vendite,"* prova *"i 10 articoli principali per fatturato questo mese."*
{% endhint %}

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/27509a71c500d77cd43f29409abe0d68/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/27509a71c500d77cd43f29409abe0d68/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

{% hint style="success" %}
Fai clic sul pulsante <mark style="color:$primary;">`Grafico`</mark> per visualizzare i dati — sono supportati grafico a barre, linee, torta, barre impilate, area impilata.
{% endhint %}

### 3. Salva una query

Seleziona <mark style="color:$primary;">`Esegui`</mark> per testare la tua query. Poiché i risultati dipendono dalle condizioni che scrivi, rivedi l'output per confermare che corrisponda a ciò che ti aspetti.

Se prevedi di riutilizzare una query, seleziona <mark style="color:$primary;">`Salva`</mark> nell'angolo in alto a destra. Le query salvate compaiono nella barra laterale sinistra, dove puoi aprirle ed eseguirle in ցանկացած momento.

Dopo che la tua query viene eseguita con successo, puoi esportare i risultati con <mark style="color:$primary;">`Esporta in Excel`</mark>.

<figure><img src="/files/41b81ba067332daa819677478bea7f92232198c1" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
I tuoi dati si sincronizzano automaticamente **una volta al giorno**.\
Per sincronizzare immediatamente, fai clic sull'icona di sincronizzazione (🔄) in fondo alla barra laterale.
{% endhint %}

***

## Variabili di query

Se includi `{{variable_name}}` nella tua query, viene generato automaticamente un campo di input quando la query viene eseguita. Il valore inserito in quel campo viene applicato alla variabile nella tua query SQL.

Quando salvi una query, i membri del tuo team possono inserire i propri valori nel campo della variabile ed eseguire il report ogni volta che ne hanno bisogno.

#### Esempio

1. Per cercare articoli che contengono una parola chiave specifica, inserisci la seguente query:

```sql
select sku, name 
from items 
where name ilike '%' || {{item_name}} || '%';
```

2. Quando esegui la query, appare un campo di input chiamato **item\_name** .

<figure><img src="/files/043013f0d59a420cf0f676312be12adc4758e167" alt=""><figcaption></figcaption></figure>

3. Inserisci una parola chiave come *`maglione`* e i risultati mostreranno tutti gli articoli con *“maglione”* nel loro nome.

<figure><img src="/files/d191d0aa93cf609e8c02806307786c36143cd34e" alt=""><figcaption></figcaption></figure>

4. Salva la query se prevedi di usarla di nuovo. Puoi selezionare e caricare le query salvate in qualsiasi momento dal menu a sinistra.

<figure><img src="/files/2f6416c52ac12e1f5fe4d09085bf0f8f8a17d71a" alt=""><figcaption></figcaption></figure>

***

## Esempi

L'analisi personalizzata include modelli predefiniti che puoi eseguire subito. Esamina un modello per capire come funziona, quindi modificalo o crea una nuova query in base alle tue esigenze.

#### Modelli

* Report settimanale di carico/scarico stock
* Tendenza mensile di acquisti e vendite
* Ultima data di uscita per articolo

<figure><img src="/files/d83fe52791511652732dabaa03f518cc2b08b8c3" alt=""><figcaption></figcaption></figure>

***

## Domande frequenti

**Hai ancora domande?** Dai un'occhiata alle nostre FAQ sull'analisi personalizzata:

{% content-ref url="/spaces/8vFZUNVCZalEJdQuzQlR/pages/a5b3ba81211ff0249495a7a63085b2d96dfb6947" %}
[Analisi personalizzate](/docs/faq/it/reportistica/analisi-personalizzate.md)
{% endcontent-ref %}


---

# 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://www.boxhero.io/docs/documentation/it/altre-funzionalita/custom-analytics.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.