Skip to main content

Paramétrage d'une source

Paramétrage d’une source

1. Informations principales
Une source de données associe :

  • un nom unique de source
  • une configuration de connexion
  • une requête SQL de lecture
  • un nom technique de base pour générer le modèle OpenProd

image.png

2. Règles sur la requête SQL
La requête est validée avant exécution. Le module n’accepte que des requêtes de lecture.

  • les requêtes SELECT sont autorisées
  • les requêtes WITH sont acceptées si elles débouchent sur une lecture
  • les mots-clés de modification comme INSERT, UPDATE ou DELETE sont refusés
  • les requêtes multiples sont interdites

image.png

3. Colonne obligatoire
La requête doit obligatoirement exposer une colonne Name.
Cette colonne est transformée en champ x_name dans le modèle généré et sert de base au display_name OpenProd.

4. Variable de date
La variable %date peut être utilisée dans la requête.
Au moment de l’exécution, elle est remplacée par la dernière date de synchronisation connue.

Exemple :
SELECT Name, code, date_modification FROM ma_vue_source WHERE date_modification > %date

5. Prévisualisation
Le bouton Prévisualiser la requête exécute une version limitée de la requête et affiche le résultat directement dans la fiche.
Cette étape sert à contrôler les colonnes retournées et la cohérence du jeu de données avant de générer le modèle.

6. État de la source
Le workflow de la source est volontairement simple :

  • Brouillon : la requête et la structure peuvent être modifiées
  • Modèle et interface chargés : le modèle existe, la requête est verrouillée, seuls les rechargements sont attendus

Pour modifier la structure après génération, il faut utiliser le bouton Brouillon, puis relancer la création ou mise à jour du modèle et de l’interface.

 

Back to top