# 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 desideri restituire come report personalizzato.
* Salva le query che usi spesso e riaprile in ნებისმunque momento.
* Esporta i risultati in Excel per ulteriori analisi o reportistica.

## Casi d’uso

Il <mark style="color:$primary;">`report standard di inventario`</mark> ti offre una rapida panoramica di metriche chiave come la quantità media di stock e il turnover dell’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 dà maggiore controllo su come esplori i tuoi dati. È particolarmente utile quando:

* Non riesci a trovare i dati di cui hai bisogno nei report standard di [report standard 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 usare le analisi personalizzate

### 1. Per iniziare

Vai a <mark style="color:$primary;">`Report`</mark> > <mark style="color:$primary;">`Analisi personalizzate`</mark>. Si aprirà 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 le query:

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

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

#### Usare l’Assistente AI

L’ <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 appariranno sotto la query.

Puoi modificare il SQL generato prima di salvarlo, 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>" %}

**Esempi di domande**

* Articoli sotto il livello di scorta di sicurezza
* Cosa non è stato venduto negli ultimi 90 giorni?
* I 10 SKU principali per unità vendute questo mese
* Ordini di acquisto aperti oltre la data di arrivo prevista
* 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 di partner. L’assistente usa le variabili di query, così puoi cambiare 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 — supportati grafico a barre, a linee, a torta, barre impilate e 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, controlla 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 qualsiasi momento.

Dopo che la tua query è stata eseguita correttamente, 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

Le analisi personalizzate includono modelli predefiniti che puoi eseguire subito. Esamina un modello per capire come funziona, quindi adattalo o crea una nuova query in base alle tue esigenze.

#### Modelli

* Report settimanale di entrate e uscite di magazzino
* Trend mensile degli acquisti e delle vendite
* Ultima data di uscita per articolo

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

***

**Hai altre domande?** Consulta le nostre FAQ sulle analisi personalizzate:

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


---

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