> For the complete documentation index, see [llms.txt](https://documentation.efalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.efalia.com/produit/efalia-process/developpeurs/syntaxes-json-jsonpath.md).

# Syntaxes JSON et JSONPath

Ce guide de référence couvre les deux formats utilisés dans les configurations des connecteurs et dans le traitement des réponses d'API dans Efalia Process.

## Syntaxe du JSON

**JSON** signifie **JavaScript Object Notation** : c'est un format de données, une façon de stocker des informations, un peu comme dans un fichier XML.

JSON est un format de données consistant en paires de nom/valeur (ou clé/valeur) ayant la forme de chaînes de caractères. Les noms et valeurs sont séparés par deux-points, et chaque paire est séparée de la suivante par une virgule.

Certains caractères permettent de structurer les données dans un fichier :

* `{...}` : les **accolades** définissent un objet.
* Les **guillemets** (double-quotes) et les **deux-points** définissent un couple clé:valeur, ou propriété:valeur, ou attribut:valeur (on parle aussi de membre, ex : `"nom":"Jean-Pierre"`).
* `[...]` : les **crochets** définissent un tableau (ou *array* en anglais).
* `{"id":1, "nom":"Jean-Pierre", "age":25}` : les **virgules** permettent de séparer les membres d'un tableau ou, comme ici, d'un objet. À noter : pas de virgule pour le dernier membre d'un objet, sinon il ne sera pas valide et vous aurez des erreurs lors de l'analyse du fichier.

Il est possible de combiner les objets et les tableaux. Exemple d'un objet JSON contenant un tableau :

```json
{
    "id": 1,
    "nom": "Jean-Pierre",
    "age": 25,
    "auteur": true,
    "enfants": [
        "Julie",
        "Marius",
        "Romain"
    ]
}
```

Exemple d'un tableau JSON contenant des objets :

```json
[
    {
        "id": 1,
        "nom": "Jean-Pierre"
    },
    {
        "id": 2,
        "nom": "Caroline"
    },
    {
        "id": 3,
        "nom": "Noah"
    }
]
```

La valeur d'une paire peut être du texte, un nombre ou un booléen (`true` ou `false`).

Pour une meilleure lisibilité du fichier, il est préférable d'indenter le contenu en fonction du niveau d'introspection dans la structure de données, comme en XML.

## Syntaxe du JSONPath

Une expression JSONPath est une chaîne de caractères qui décrit une requête au sein d'un document JSON pour cibler une donnée désirée.

Par exemple, pour le JSON suivant :

```json
{
    "id": 12,
    "firstname": "Joe",
    "lastname": "Dee",
    "address": {
        "city": "Paris",
        "street": "43 av. Junot",
        "zipcode": "75018"
    }
}
```

l'expression JSONPath `$.address.city` renvoie la valeur `Paris`.

{% hint style="info" %}
Dans Efalia Process, les données ciblées ne peuvent être que des primitives : `string`, `number`, `boolean` ou `date` au format ISO-8601 (`2025-02-16T10:58:44.965071Z` ou `2025-02-16T10:58:44+02:00`). Il est aussi possible de récupérer des tableaux de valeurs primitives dans des champs multivalués.
{% endhint %}

Le caractère `$` représente la racine du document JSON, et les points permettent de séparer les niveaux d'introspection jusqu'à la valeur.

Il est possible d'accéder aux occurrences d'un tableau, par exemple :

* `$.products.books[0].author` renvoie l'auteur du premier livre.
* `$.products.books[*].author` renvoie la liste de tous les auteurs.

| Expression | Description                          |
| ---------- | ------------------------------------ |
| `[0]`      | Premier élément                      |
| `[-1]`     | Dernier élément                      |
| `[0:2]`    | Tranche (slice), ici éléments 0 et 1 |
| `[*]`      | Tous les éléments                    |

Il est aussi possible de spécifier des filtres sur des tableaux :

`$.articles[?(@.prix > 20)]` renvoie tous les articles dont le prix est strictement supérieur à 20. Lors du filtrage, le caractère `@` représente l'élément courant de parcours.

| Expression             | Description                           |
| ---------------------- | ------------------------------------- |
| `[?(@.prix < 10)]`     | Filtre les éléments dont le prix < 10 |
| `[?(@.dispo == true)]` | Filtre avec condition booléenne       |

Les opérateurs supportés dans les filtres sont `==`, `!=`, `<`, `<=`, `>` et `>=`.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://documentation.efalia.com/produit/efalia-process/developpeurs/syntaxes-json-jsonpath.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
