# Analyses personnalisées

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

***

## Points forts

* Posez des questions en langage simple et **l’assistant IA** rédigera 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 obtenir 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

Le <mark style="color:$primary;">`Rapports d’inventaire`</mark> fonctionnalité vous offre un aperçu rapide des indicateurs clés comme 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 ne couvrent pas forcément tous les types d’analyse dont votre équipe a besoin.

<mark style="color:$primary;">`Analytique personnalisée`</mark> vous donne davantage de contrôle sur la façon d’explorer vos données. C’est particulièrement utile lorsque :

* Vous ne trouvez pas les données dont vous avez besoin dans le [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 temporelle, comme mensuelle, trimestrielle ou d’une année sur l’autre
* Vous souhaitez enregistrer les rapports sur lesquels vous comptez et les réutiliser
* Vous avez besoin de données flexibles pour appuyer le reporting ou la prise de décision

***

## Comment utiliser l’analytique personnalisée

### 1. Premiers pas

Allez dans <mark style="color:$primary;">`Rapports`</mark> > <mark style="color:$primary;">`Analytique personnalisée`</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. **Utiliser l’assistant IA** pour générer du SQL à partir d’une question en langage naturel (recommandé pour la plupart des utilisateurs).
2. **Rédiger du SQL directement** en utilisant [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction).

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

#### Utiliser l’assistant IA

L’ <mark style="color:$primary;">`l’assistant IA`</mark> transforme les questions en langage naturel 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 d’enregistrer 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 en retard par rapport à leur date d’arrivée prévue
* 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 partenaires. L’assistant utilise des variables de requête, ce qui vous permet de 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 **précises** **.** \
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 — histogramme, courbe, camembert, barres empilées, 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 automatiquement généré lors de l’exécution de la requête. La valeur saisie dans ce champ est appliquée à la variable dans 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 quand ils en ont besoin.

#### Exemple

1. Pour rechercher des articles contenant 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 *`sweater`* et les résultats afficheront tous les articles avec *« sweater »* 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

L’analytique personnalisée comprend des modèles intégrés que vous pouvez exécuter immédiatement. Consultez un modèle pour comprendre son fonctionnement, puis adaptez-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>

***

**Vous avez d’autres questions ?** Consultez notre FAQ sur l’analytique personnalisée :

{% content-ref url="/spaces/BW1QcHyVqQXH8AhYlZEO/pages/b79e5d3308a945010d943d4f54e3631780fbb410" %}
[Analyses personnalisées](/docs/faq/fr/rapports/analyses-personnalisees.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/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.