Dans Paramètres > Connecteurs, activez le connecteur Magnolia CMS.

Choisissez le type d'authentification :
| Mode | Description |
|---|---|
| Anonyme | Aucun identifiant requis. L'instance Magnolia doit autoriser l'accès anonyme à la Delivery API et au servlet DAM. |
| Basic Auth | Renseignez un nom d'utilisateur et un mot de passe. Les identifiants sont envoyés via le header Authorization: Basic sur chaque requête. |

Lors de l'ajout du connecteur Magnolia sur une base de connaissances ou un agent, un dialogue vous demande de renseigner le domaine de votre instance Magnolia.
Format attendu : host:port/context (sans http://)
Exemples :
magnolia.mycompany.com — instance en productionmagnolia.mycompany.com/magnoliaPublic — contenu publié uniquementmagnolia.mycompany.com/magnoliaAuthor — contenu auteur (brouillons inclus)
magnoliaPublic ne retourne que le contenu publié. magnoliaAuthor donne accès à tout le contenu, y compris les brouillons non publiés.
Une fois le connecteur configuré, l'interface de navigation affiche deux dossiers racines :


Si des filtres sont configurés (voir section suivante), les éléments qui ne correspondent pas aux critères apparaissent en opacité réduite et ne peuvent pas être sélectionnés. Les éléments déjà importés avant l'ajout d'un filtre restent sélectionnables.

Les filtres permettent de restreindre les éléments visibles selon leurs propriétés JCR Magnolia. Ils se configurent dans le dialogue de domaine du connecteur.
Chaque filtre se compose de :
| Champ | Description |
|---|---|
| Clé de la propriété | Nom de la propriété JCR à évaluer (ex: name, path, my_type) |
| Type de valeur | String, Long (entier), Double (décimal), Boolean, Date, Array (multi-valeurs) |
| Condition | Opérateur de comparaison (dépend du type, voir ci-dessous) |
| Valeur | Valeur attendue pour la comparaison |
| Mode | Strict (AND) ou Simple (OR) |
| Accepter nullable | Si coché, les éléments qui n'ont pas cette propriété passent le filtre |
| Appliquer sur | Pages, Assets, ou les deux |

| Type | Conditions disponibles |
|---|---|
| String | Égal, Pas égal, Contient, Ne contient pas, Commence par, Finit par |
| Long / Double | Égal, Pas égal, Supérieur, Inférieur, Supérieur ou égal, Inférieur ou égal |
| Boolean | Comparaison directe (true / false) |
| Date | Égal, Pas égal, Après, Avant, Après ou égal, Avant ou égal |
| Array | Contient au moins un, Contient tous |
Les deux modes se combinent : un élément doit passer tous les filtres strict ET au moins un filtre simple (s'il y en a).
| Cas d'usage | Configuration |
|---|---|
| Exclure les pages cachées de la navigation | Clé: hideInNav, Type: Boolean, Valeur: false, Mode: Strict |
| Ne garder que les PDF | Clé: extension, Type: String, Condition: Égal, Valeur: pdf, Mode: Strict, Appliquer sur: Assets |
| Filtrer par catégorie | Clé: categories, Type: Array, Condition: Contient au moins un, Valeur: [uuid-catégorie], Mode: Strict |
Les propriétés utilisées dans les filtres doivent être exposées par la Delivery API Magnolia.
Si vous utilisez des catégories Magnolia dans vos filtres, vous devez renseigner leur identifiant JCR (jcr:uuid) comme valeur de filtre.
Pour récupérer cet identifiant :
jcr:uuid — c'est cette valeur qu'il faut utiliser dans le filtre