La mise en œuvre d’échanges de données entre applications (interfaces) suppose définir d’une part le contenu (format…) et d’autre par les modalités de transfert.
Le présent document définit un ensemble de méthodes et outils qui pourront être utilisés pour différents échanges, qu’il s’agisse de transfert de fichiers (environnement « On Premise » uniquement) ou d’APIs.
Ces échanges pourront être planifiés par les fonctions prévues à cet effet (« File travaux »).
La description des données échangées relève des spécifications propres à chaque échange.
WanaPort n’est que l’une des extensions gracieusement mises à votre disposition (voir Extensions).
Vous pouvez donc en disposer librement dans le cadre de la licence open source qui vous est accordée (voir Licence).
Naviguer
Utilisation
Outre l’utilisation directe décrite ci-après, un « WanaPort » peut être associé à une « Feuille comptabilité », une « Feuille article » ou encore une « Feuille activité projet » (Cf. Configuration).
Une action « Import Wanaport » est alors proposée :
Configuration
| Planification | Indique les jours de la semaine planifiés sous la forme ‘LMMJVSD’. |
| Fichiers à importer, archivés, exportés | La liste correspondante peut être visualisée et le contenu des fichiers correspondants peut alors être affiché (si les paramètres du navigateur l’autorise). |
| Actions | |
| Modifier/Afficher | Voir ci-après |
| Ouvrir la page | Affiche les données correspondantes |
| Planificateur | Affiche le traitement planifié associé (Cf. Fie travaux) et permet de lister à ce niveau l’historique correspondant (« Ecritures journal »). |
| Importer | Permet de déclencher ponctuellement le traitement sélectionné |
| Exporter | Idem |
| Constantes | Voir ci-après |
| Mappage Import | Voir ci-après |
| Mappage Export | Voir ci-après |
| Journal | Voir ci-après |
(*) Ces champs ne sont disponibles que pour une installation « On premise »
| Section Général | |
| Type objet, ID Objet Nom objet | Traitement concerné (Report, Codeunit ou XMLport). |
| N° page, Nom de page | Page à afficher (Cf. action « Ouvrir la page »). L’association à la « Feuille comptabilité » (N° page 39), la « Feuille article » (N° page 40) ou la « Feuille activité projet » (N° page 201) propose l’action « Import WanaPort » sur la page concernée. |
| Séparateur de champs | Tabulation, Virgule, Point-virgule |
| Délimiteur de texte | Aucun, « |
| Section Import | Ces paramètres peuvent être exploités par le traitement. |
| Dossier import (*) | Cf. Dossiers ci-après |
| Filtre nom de fichier (*) | |
| Dossier archive (*) | En fin de traitement, les fichiers pris en compte sont déplacés dans ce dossier (à prendre en compte dans le traitement d’import). |
| Modèle nom fichier archive (*) | |
| Dernier N° séquence import | Peut être utilisé pour ne prendre en compte que les nouvelles écritures. |
| Horodatage dernier import | Mis à jour en fin de traitement. |
| Section Export | Ces paramètres peuvent être exploités par le traitement. |
| Dossier export (*) | Cf. Dossiers ci-après |
| Modèle nom de fichier export (*) | %1 sera remplacé par le « Dernier N° fichier utilisé » (préalablement incrémenté). %2 sera remplacé par l’horodatage (aaaammjjhhmmss) |
| Dernier N° fichier utilisé (*) | Peut être utilisé pour incrémenter le nom du fichier généré (paramètre %1 ci-dessus). |
| Dern. N° séquence export | Peut être utilisé pour ne prendre en compte que les nouvelles écritures. |
| Horodatage dernier export | Mis à jour en fin de traitement. |
Dossiers
Attention, les dossiers sont à configurer tels que définis sur le serveur d’application et non tels que vus du poste utilisateur.
En particulier, veillez à ne pas utiliser les lettres de lecteurs réseaux mais mentionner le nom complet du dossier (ex : nomduserveur://…).
Constantes
Permet de définir des valeurs associées à différents éléments (selon spécification du traitement concerné) qui permettront d’initialiser des valeurs non présentes parmi les données traitées:
Mappage import
Permet de définir des tables de correspondance (selon spécification du traitement concerné) :
Le « N° origine » est libre mais doit être unique, la « Valeur cible » doit exister.
Mappage Export
Idem mais dans l’autre sens.
Le code origine (celui de Business Central) doit être unique, le « Code destinataire » est libre.
Journal
Affiche l’historique des traitements :
Supervision de la file travaux
Voir https://www.wanamics.fr/planifier-un-traitement-recurrent/
Un même traitement (ici « WanaPort Export » ou « WanaPort Import » peut être planifié pour chaque échange de données.
La « Chaîne de paramètres » détermine le traitement concerné (exemple XMLport:: »My interface »‘).
Commentaires récents