# Analisi personalizzate
{% hint style="warning" %} **`Analisi personalizzate`** è attualmente in **beta**.\
Diventerà una funzione a pagamento dopo il rilascio ufficiale.
{% endhint %}
***
## Punti salienti
* 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.
## Quando usare le analisi personalizzate
La funzione standard **`Report di inventario`** ti offre una rapida panoramica di metriche chiave come la quantità media di stock e il turnover di inventario per un periodo selezionato. Poiché tali report utilizzano formule e campi predefiniti, potrebbero non coprire ogni tipo di analisi di cui il tuo team ha bisogno.
**`Analisi personalizzate`** ti offre maggiore controllo su come esplori i tuoi dati. È particolarmente utile quando:
* Non riesci a trovare i dati di cui hai bisogno nella funzione standard [Report di inventario](https://www.boxhero.io/docs/documentation/it/altre-funzionalita/analytics)
* 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 reportistica o decisioni
***
## Come usare le analisi personalizzate
### 1. Per iniziare
Vai a **`Report`** > **`Analisi personalizzate`**. Si aprirà un nuovo spazio di lavoro in cui puoi creare e gestire le tue query SQL. Quindi, seleziona **`+ Nuovo`** per creare una nuova query.
### 2. Scrivi una query
Le query usano [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction). Puoi scaricare il file **`Prompt AI`** per vedere tutte le tabelle e le colonne disponibili.
{% hint style="success" %}
Se stai usando strumenti **AI** come ChatGPT o Gemini, allegare il file "*Prompt AI"* aiuta a generare SQL accurato.
{% endhint %}
Seleziona **`Esegui`** 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.
Dopo che la query è stata eseguita con successo, puoi esportare i risultati con **`Esporta in Excel`**.
### 3. Salva una query
Se prevedi di riutilizzare una query, seleziona **`Salva`** nell'angolo in alto a destra.
Le query salvate compaiono nella barra laterale sinistra, dove puoi aprirle ed eseguirle in qualsiasi momento.
{% 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 della 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** .
3. Inserisci una parola chiave come *`sweater`* e i risultati mostreranno tutti gli articoli con *“sweater”* nel loro nome.
4. Salva la query se prevedi di usarla di nuovo. Puoi selezionare e caricare le query salvate in qualsiasi momento dal menu a sinistra.
***
## Casi d'uso
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/uscite di stock
* Tendenza mensile degli acquisti e delle vendite
* Ultima data di uscita per articolo
***
## Domande frequenti (FAQ)
### Posso combinare dati provenienti da più team?
No. I dati sono separati per team e puoi analizzare solo i dati del team in cui hai effettuato l'accesso al momento.
### Posso impedire ai membri di usare le analisi personalizzate?
Gli amministratori e i membri possono creare e visualizzare le query. I membri con autorizzazioni personalizzate *non* hanno accesso a questa funzione.
Se devi limitare l'accesso per un membro, assegnagli un [permesso personalizzato](https://www.boxhero.io/docs/documentation/it/impostazioni/members#custom-roles-and-permissions) con **tutte le autorizzazioni selezionate**. Le analisi personalizzate *non* sono incluse nelle opzioni dei permessi personalizzati, quindi anche con tutte le autorizzazioni selezionate il membro non avrà accesso.
