Extension WanaPort

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).

Utilisation

Outre l’utilisation directe décrite ci-après, un ou plusieurs « WanaPort » peuvent être associés à une « Feuille comptabilité », une « Feuille article » ou encore une « Feuille activité projet » (Cf. Configuration).
Une action « Import Wanaport » est alors proposée et affichera la listes du/des Wanaport(s) disponible(s) :

PlanificationIndique les jours de la semaine planifiés sous la forme ‘LMMJVSD’.
Fichiers à importer, archivés, exportésLa 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/AfficherVoir ci-après
Ouvrir la pageAffiche les données correspondantes
PlanificateurAffiche le traitement planifié associé (Cf. Fie travaux) et permet de lister à ce niveau l’historique correspondant (« Ecritures journal »).
ImporterPermet de déclencher ponctuellement le traitement sélectionné
ExporterIdem
ConstantesVoir ci-après
Mappage ImportVoir ci-après
Mappage ExportVoir ci-après
JournalVoir ci-après

Journal

Affiche l’historique des traitements :

Configuration

(*) Ces champs ne sont disponibles que pour une installation « On premise »

Section Général 
Type objet, ID Objet Nom objetTraitement concerné (Report, Codeunit ou XMLport).
N° page, Nom de pagePage à 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 champsTabulation, Virgule, Point-virgule
Délimiteur de texteAucun, « 
Section ImportCes 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 importPeut être utilisé pour ne prendre en compte que les nouvelles écritures.
Horodatage dernier importMis à jour en fin de traitement.
Section ExportCes 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 exportPeut être utilisé pour ne prendre en compte que les nouvelles écritures.
Horodatage dernier exportMis à 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.

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 »‘).

Lien Permanent pour cet article : https://www.wanamics.fr/wanaport/