> 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/fr/autres-fonctionnalites/custom-analytics.md).

# Analyses personnalisées

<figure><img src="/files/6251bc51bd6512918d7bd728b09e4fccaf85c80e" alt=""><figcaption></figcaption></figure>

***

## Points clés

* Posez des questions en langage courant et l' **Assistant IA** rédige le SQL pour vous.
* Utilisez SQL pour interroger vos données BoxHero.
* Combinez des conditions (par ex. article, attribut, prix, plage de dates, partenaire) pour définir les données que vous souhaitez renvoyer dans un rapport personnalisé.
* Enregistrez les requêtes que vous utilisez souvent et rouvrez-les à tout moment.
* Exportez les résultats vers Excel pour une analyse ou un reporting supplémentaires.

## Cas d’utilisation

La fonctionnalité standard <mark style="color:$primary;">`Rapports d’inventaire`</mark> vous offre un aperçu rapide d’indicateurs clés tels que la quantité moyenne en stock et la rotation des stocks pour une période sélectionnée. Comme ces rapports utilisent des formules et des champs prédéfinis, ils peuvent ne pas couvrir tous les types d’analyse dont votre équipe a besoin.

<mark style="color:$primary;">`Analyses personnalisées`</mark> vous donne davantage de contrôle sur la manière dont vous explorez vos données. C’est particulièrement utile lorsque :

* Vous ne trouvez pas les données dont vous avez besoin dans la fonctionnalité standard [Rapports d’inventaire](/docs/documentation/fr/autres-fonctionnalites/analytics.md)
* Vous souhaitez filtrer ou regrouper les données par article, fournisseur, client, membre de l’équipe ou d’autres conditions détaillées
* Vous avez besoin d’une analyse basée sur le temps, comme mensuelle, trimestrielle ou en glissement annuel
* Vous souhaitez enregistrer les rapports sur lesquels vous comptez et les réutiliser
* Vous avez besoin de données flexibles pour soutenir le reporting ou la prise de décision

***

## Comment utiliser les analyses personnalisées

### 1. Pour commencer

Accédez à <mark style="color:$primary;">`Rapports`</mark> > <mark style="color:$primary;">`Analyses personnalisées`</mark>. Cela ouvre un nouvel espace de travail où vous pouvez créer et gérer vos requêtes SQL. Ensuite, sélectionnez <mark style="color:$primary;">`+ Nouveau`</mark> pour créer une nouvelle requête.

<figure><img src="/files/424e89e0b9d6e0512d901c16cfd9b12a70fc9d6e" alt=""><figcaption></figcaption></figure>

### 2. Rédiger une requête

Vous avez deux façons de rédiger des requêtes :

1. **Utilisez l’Assistant IA** pour générer du SQL à partir d’une question en langage courant (recommandé pour la plupart des utilisateurs).
2. **Écrivez directement du SQL** en utilisant [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction).

<figure><img src="/files/0adce81ec3386c4c7957943c12e520eeaf21561d" alt=""><figcaption></figcaption></figure>

#### L’utilisation de l’Assistant IA

Le <mark style="color:$primary;">`Assistant IA`</mark> transforme les questions en langage courant en requêtes SQL fonctionnelles. Vous n’avez pas besoin de connaître SQL pour l’utiliser.&#x20;

Saisissez votre question dans le panneau de l’assistant et appuyez sur Entrée. L’assistant génère le SQL, l’applique à l’éditeur et l’exécute. Les résultats apparaissent sous la requête.

Vous pouvez modifier le SQL généré avant l’enregistrement si vous souhaitez ajuster quelque chose.

{% 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>" %}

**Exemples de questions**

* Articles en dessous du niveau de stock de sécurité
* Qu’est-ce qui ne s’est pas vendu au cours des 90 derniers jours ?
* Top 10 des SKU par unités vendues ce mois-ci
* Bons de commande ouverts dont la date d’arrivée prévue est dépassée
* Niveaux de stock par emplacement&#x20;

#### Créer des requêtes réutilisables

Vous pouvez demander à l’assistant d’inclure des filtres ajustables dans une requête, comme des plages de dates ou des noms de partenaire. L’assistant utilise des variables de requête afin que vous puissiez modifier les entrées plus tard sans réécrire le SQL.

Par exemple, demander *"ventes par article pour une plage de dates que je peux modifier"* génère une requête avec une variable de date qui demande une saisie à chaque exécution de la requête.

<figure><img src="/files/3283afc5d20b7e3686f5257a89d0e91bb8151bc8" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
L’Assistant IA fonctionne mieux avec **des questions spécifiques** **en particulier**. \
Au lieu de *"montrez-moi les ventes,"* essayez *"top 10 des articles par chiffre d’affaires ce mois-ci."*
{% 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" %}
Cliquez sur le bouton <mark style="color:$primary;">`Graphique`</mark> pour visualiser les données — diagramme en barres, courbe, camembert, barres empilées et aire empilée pris en charge.
{% endhint %}

### 3. Enregistrer une requête

Sélectionnez <mark style="color:$primary;">`Exécuter`</mark> pour tester votre requête. Comme les résultats dépendent des conditions que vous écrivez, vérifiez la sortie pour confirmer qu’elle correspond à ce que vous attendez.

Si vous prévoyez de réutiliser une requête, sélectionnez <mark style="color:$primary;">`Enregistrer`</mark> dans le coin supérieur droit. Les requêtes enregistrées apparaissent dans la barre latérale gauche, où vous pouvez les ouvrir et les exécuter à tout moment.

Une fois votre requête exécutée avec succès, vous pouvez exporter les résultats avec <mark style="color:$primary;">`Exporter vers Excel`</mark>.

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

{% hint style="info" %}
Vos données se synchronisent automatiquement **une fois par jour**.\
Pour synchroniser immédiatement, cliquez sur l’icône de synchronisation (🔄) en bas de la barre latérale.
{% endhint %}

***

## Variables de requête

Si vous incluez `{{variable_name}}` dans votre requête, un champ de saisie est généré automatiquement lorsque la requête s’exécute. La valeur saisie dans ce champ est appliquée à la variable de votre requête SQL.

Lorsque vous enregistrez une requête, les membres de votre équipe peuvent saisir leurs propres valeurs dans le champ de variable et exécuter le rapport dès qu’ils en ont besoin.

#### Exemple

1. Pour rechercher des articles qui contiennent un mot-clé spécifique, saisissez la requête suivante :

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

2. Lorsque vous exécutez la requête, un champ de saisie nommé **item\_name** apparaît.

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

3. Saisissez un mot-clé tel que *`pull`* et les résultats afficheront tous les articles contenant *« pull »* dans leur nom.

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

4. Enregistrez la requête si vous prévoyez de la réutiliser. Vous pouvez sélectionner et charger des requêtes enregistrées à tout moment depuis le menu de gauche.

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

***

## Exemples

Custom Analytics comprend des modèles intégrés que vous pouvez exécuter immédiatement. Examinez un modèle pour comprendre son fonctionnement, puis ajustez-le ou créez une nouvelle requête selon vos besoins.

#### Modèles

* Rapport hebdomadaire des entrées/sorties de stock
* Tendance mensuelle des achats et des ventes
* Dernière date de sortie par article

<figure><img src="/files/76847088121cc96cbf4ad0fdb8ddc62017fddafa" alt=""><figcaption></figcaption></figure>

***

## Questions fréquemment posées

**Vous avez encore des questions ?** Consultez notre FAQ sur les analyses personnalisées :

{% content-ref url="/spaces/BW1QcHyVqQXH8AhYlZEO/pages/b79e5d3308a945010d943d4f54e3631780fbb410" %}
[Analytique personnalisée](/docs/faq/fr/rapports/analytique-personnalisee.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:

```
GET https://www.boxhero.io/docs/documentation/fr/autres-fonctionnalites/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.