Aller au contenu principal

Lanceur ERP : exécuter une requête

La page Conexio → Exécution de tâche exécute une requête ERP sans écrire de code ni sortir du portail : la même chaîne que l'API publique (HUB, agent ou API infonuagique), avec un formulaire devant. On s'en sert pour valider une connexion fraîchement configurée, préparer une requête avant de la coder, ou reproduire le problème d'un client avec sa propre requête.

1. S'authentifier sur la licence​

En haut de page, la section Configuration :

  1. Code licence — choisissez la licence.
  2. Deux façons de fournir le credential :
    • Utiliser mon accès — le portail émet une clé d'API à votre nom pour cette licence (voir la clé implicite). Il faut détenir au moins un droit d'appel API sur la licence, sinon le bouton le dira.
    • Clé secrète — saisissez la clé de la licence, puis Valider.
  3. Compagnie — obligatoire : elle devient le COMPANY_CODE de chaque appel. Si la liste est vide, la licence n'a aucune connexion ERP configurée — le lien de la page mène directement à Info Connexion.

Le reste de l'interface n'apparaît qu'une fois authentifié (« ✓ Authentifié » — le bouton Changer permet de basculer de licence).

2. Choisir le mode : Formulaire ou URI brute​

Le formulaire construit la requête ; le mode URI brute rejoue telle quelle une requête déjà écrite (celle d'un client, par exemple).

Mode Formulaire​

Paramètres de la tâche — le Type de tâche (EXTRACT, CREATE, UPDATE, DELETE, EXECUTE) et le Type d'entité (Customer, Product, CustomerInvoice…). Une tâche EXECUTE demande plutôt une Action à exécuter. Des Propriétés étendues (clé/valeur) couvrent les cas particuliers.

Pour une tâche EXTRACT, la section Paramètres de la requête (QuerySettings) reprend les leviers de l'API :

  • Pagination — Top et Skip (Paginer les résultats) ;
  • Filtres — champ, opérateur, valeur, cumulables (Filtrer les résultats) ;
  • Champs à retourner — tous, ou une sélection via Choisir les champs… (le sélecteur montre libellé, nom technique et type de chaque champ de l'entité) ;
  • Paramètres supplémentaires — clés/valeurs additionnelles transmises avec la tâche, comme RETURN_DATA_FORMAT pour les formats de sortie spéciaux.

Pour CREATE et UPDATE, on fournit le corps de la requête (JSON) — le même document que pour l'API (Créer une entité).

L'Aperçu du ERPConnectorTask montre la tâche exactement comme elle partira — utile pour comprendre ce que le formulaire a construit, et pour transposer ensuite la requête dans votre code.

Cliquez Exécuter la tâche.

Mode URI brute​

Collez une requête telle que vous l'avez reçue — l'URL complète, avec son $filter et ses paramètres. Seule la portion qui suit /api/ est conservée : le serveur d'origine est remplacé par celui du portail, et l'authentification par celle de l'étape 1. Choisissez la Méthode (GET, POST…), ajoutez le corps JSON s'il y a lieu, vérifiez l'URL effective affichée, puis Exécuter la requête.

Le réflexe « sa requête ne marche pas »

Un client vous envoie une requête qui échoue chez lui ? Collez-la en URI brute, choisissez sa licence et sa compagnie, exécutez. Même résultat que lui : le problème est dans la requête ou les données — le Sommaire montre l'erreur exacte. Résultat correct chez vous : le problème est de son côté (credential, en-têtes, COMPANY_CODE, environnement). Vous venez de couper le problème en deux, sans rien installer.

Une section Avancé (sysadmin), réservée aux administrateurs système, permet en plus de viser un autre serveur et de poser des en-têtes supplémentaires.

3. Lire les résultats​

Deux onglets sous le bouton d'exécution :

  • Sommaire — succès ou erreur, nombre d'entités retournées, et le détail du problème en cas d'échec. Commencez toujours ici.
  • Résultats — pour une extraction, les données en Grille (triable, pour balayer vite) ou en JSON (la réponse brute, celle que verrait votre code). Pour les autres tâches, la réponse JSON telle quelle.

Chaque exécution laisse une trace dans Conexio → Appels API, l'historique des appels de la licence — pratique pour retrouver un test d'hier ou comparer deux exécutions.

Voir aussi​

Cette page vous a-t-elle été utile ?