Usage et place dans un flux

« Données entrantes API » commence une branche en fournissant le tableau issu d’une requête HTTP acceptée. Ajoutez-le depuis « API : recevoir et publier des données » ou l’onglet des connexions. Sélectionnez une connexion REST API avec la direction « Recevoir des données dans Data Bridge ». Dans un flux, utilisez un bloc de ce type par point d’entrée.

Le bloc n’a pas besoin de tableau d’entrée. Connectez son résultat au nettoyage, à la validation, aux transformations et aux destinations. Une livraison acceptée exécute Production, et non le brouillon ouvert. Si le flux utilise plusieurs sources, combinez-les selon les clés appropriées après avoir obtenu leurs tableaux.

Données ou fichiers

Dans « Recevoir des données », choisissez la détection automatique d’après Content-Type ou JSON, JSON Lines, CSV/TSV ou XML. Pour JSON, définissez si nécessaire un chemin d’enregistrements tel que data.items. Pour CSV, définissez le séparateur et les en-têtes ; pour XML, le chemin des enregistrements et les attributs des ancêtres. Les valeurs imbriquées deviennent des champs tels que customer.id.

Dans « Recevoir des fichiers », sélectionnez les formats XLSX/XLSM, CSV, TXT, JSON et XML acceptés, le nombre de fichiers et les paramètres de lecture. Pour Excel, précisez une feuille et une plage explicite comme A1:Z10000 ; pour un fichier JSON, utilisez un JSON Pointer comme /data/rows. Les lignes de tous les fichiers d’une requête sont réunies. Ajoutez éventuellement une colonne de nom de fichier dont le nom ne reproduit pas celui d’un champ de données.

Champs et politique d’erreur

Saisissez un exemple de test, choisissez son format propre et actualisez les champs. Vérifiez le format de chaque champ : texte, entier, nombre, date, date/heure ou booléen ; marquez les champs obligatoires. La validation ne convertit pas les valeurs : normalisez-les dans les blocs suivants. Ajoutez jusqu’à 20 clés uniques contenant un ou plusieurs champs ; elles vérifient les doublons uniquement dans une même requête.

Un champ déclaré absent peut provoquer un rejet ou une valeur vide. Pour les valeurs invalides, choisissez le rejet de toute la requête avec détails, l’acceptation des seules lignes valides ou le rejet global avec un résumé concis. L’acceptation partielle nécessite un rapprochement ultérieur des lignes rejetées ; lorsqu’aucune ligne valide ne reste, la requête est rejetée.

Simulation et exécution en production

Les données de test servent dans l’aperçu, la validation, la simulation et les exemples de référence. Leur format est indépendant de celui des requêtes. Production ne les substitue jamais aux données réelles. Pour une exécution sans livraison API, choisissez un tableau vide avec les champs déclarés ou un arrêt ; cela évite l’utilisation accidentelle de valeurs de test.

Testez une ligne valide, une valeur obligatoire manquante et une clé dupliquée. Après publication, envoyez une livraison de contrôle et rapprochez le tableau de destination. « Documentation technique » ouvre le contrat du point d’entrée ; « Requêtes API » dans le menu contextuel ouvre son journal. Consultez la configuration de la réception API pour la procédure complète de connexion, signature et suivi.