Vous pouvez lancer l'exécution d'une interface :
- Depuis le détail de l'interface,
- Depuis le détail d'un système externe : dans ce cas, plusieurs interfaces peuvent être exécutées successivement, en un seul lancement,
- Par un traitement automatique,
- Par l'appel d'un Web Service.
Voir aussi Exemples de fichiers d'échange.
Lancement de l'exécution
Depuis le détail de l'interface
- Dans le menu des actions de la liste
, sélectionnez "Lancer l'exécution de l'interface".
→ L'application affiche une pop up de paramètres à saisir.
Depuis le détail du système externe
- Ouvrez le formulaire de détail du système externe sur lequel sont configurées les interfaces à lancer.
→ La liste des interfaces est affichée.
- Ordonnez l'exécution en utilisant la colonne "Ordre", si nécessaire (voir Système externe [Général]).
- Cochez les interfaces à exécuter. Dans le menu des actions de la liste
, sélectionnez "Lancer l'exécution de l'interface".
→ L'application affiche une pop-up de paramètres à saisir.
Par un traitement automatique
- Créez un traitement automatique, de job :
- EXCHOUTJOB, pour des interfaces d'export.
- EXCHINJOB, pour des interfaces d'import.
Voir Jobs standard.
Par l'appel d'un Web Service
Les méthodes du Web Service à appeler sont :
- processSynchrone pour un import,
- exportSynchrone pour un export.
La description du Web service contenant ces méthodes est disponible à l'adresse :
http://<serveur>:8080/xnet-xnet/ExchangeGatewayServiceImpl?wsdl
où <serveur> est le nom de la machine où est installé CARL Source.
Paramètres de lancement
Interface de sortie
- Cochez "Télécharger le résultat" pour obtenir le ou les fichiers de sortie sur votre poste.
- Cochez "Exécution asynchrone" pour permettre à l'interface de s'exécuter en tâche de fond : vous serez alors informé de la fin du traitement par le biais d'un mémo.
- Pour chaque objet à exporter, choisissez éventuellement parmi les filtres personnalisés de la fonctionnalité, celui à appliquer.
- Vous pouvez, si vous le souhaitez, supprimer des objets de la liste. Ce qui signifie qu'ils ne seront pas traités sur cette exécution de l'interface.
Avant le lancement de l'exécution, si tous les objets ont été supprimés et que la liste est vide, alors un message d'erreur s'affiche indiquant : "L'export n'a pas pu être exécuté pour cause d'erreur : Aucun objet d'intégration présent à l'exécution de l'interface".
- Cliquez sur le bouton "Valider".
→ CARL Source lance l'export de données. Selon le cas, le fichier résultat sera à télécharger, ou généré à l'emplacement indiqué dans le point de connexion de chaque système externe.
Remarques :
- Si l'interface est définie sur des systèmes externes de points de connexion divers, le fichier téléchargé sera un .zip contenant les différents fichiers produits.
- L'exécution avec téléchargement peut être considérée comme une exécution de test : elle ne sera pas consignée dans l'historique des exécutions.
Interface d'entrée
- Choisissez où CARL Source doit aller chercher les données à exporter :
- Par défaut : Utilisation du point de connexion de chaque système externe,
- Point de connexion : Utilisation d'un point de connexion spécifique au test, à sélectionner parmi les points de connexion configurés dans CARL Source,
- Fichier téléchargé : Les données sont dans un fichier que vous sélectionnez en utilisant le bouton "Parcourir..." et que vous transmettez à CARL Source en cliquant sur "Envoyer".
- Cochez "Exécution asynchrone" pour permettre à l'interface de s'exécuter en tâche de fond : vous serez alors informé de la fin du traitement par le biais d'un mémo.
- Pour les fichiers à plat, sélectionnez l'encodage du fichier en entrée pour un traitement correct des caractères spéciaux.
Dans le cas des fichiers xml, l'encodage est renseigné dans l'en-tête du fichier, par exemple : <?xml version="1.0" encoding="UTF-8"?>.
- Cliquez ensuite sur le bouton "Valider".
→ CARL Source lance l'import des données du contenu spécifié.
Résultat de l'exécution
Après exécution, le résultat est affiché dans l'historique des échanges.