Skip to main content

Référentiel externe

Un référentiel externe est une liste de valeurs comme un référentiel simple, mais qui est alimenté par une API externe. Cela permet de récupérer des données dynamiques pour personnaliser les jobs.

Pour créer un référentiel externe, il suffit de cliquer sur le bouton Créer un référentiel externe dans le menu "Administration" > "Référentiels externes".

Référentiel externe

Configuration​

  • Nom : Le nom du référentiel externe.
  • URL : L'URL de l'API qui va alimenter le référentiel.
  • Utilisateur : Si renseigné, l'utilisateur HTTP à utiliser pour l'authentification.
  • Mot de passe : Si renseigné, le mot de passe à utiliser pour l'authentification.
  • En tête HTTP : Les en-têtes HTTP à ajouter à la requête.
  • Utiliser le cache : Si activé, le cache sera utilisé pour stocker les données de l'API.
Champ de fusion

Les champs de fusion sont disponibles dans les champs URL, Utilisateur, Mot de passe et En tête HTTP.

Format attendu​

L'API doit retourner un tableau d'objets JSON. Chaque objet doit contenir au moins deux propriétés : value et label.

[
    {
        "value": "1",
        "label": "Option 1"
    },
    {
        "value": "2",
        "label": "Option 2"
    }
]

Il est également possible d'ajouter un champ altLabel, qui sera utilisé pour afficher une supplémentaire à à l'utilisateur :

Référentiel externe