Cet article a pour objectif de vous guider à travers :
1) Structure des fichiers JSON ;
2) Importer des données de Plugnotes vers BC (via le formulaire de plug-in XX14) ;
3) Importer des données de BC vers Plugnotes (via notre formulaire de plug-in XX13).
Les échanges se font via des fichiers JSON. La spécificité de Plugnotes est que tous les échanges sont paramétrés (et contrôlés) via 2 plugforms spécifiques :
- XX13 Appels depuis : Pour envoyer des données à Plugnotes ;
- XX14 Appels vers : Pour envoyer des données de Plugnotes à.
1) Structure des fichiers JSON
Remarque : Chaque fiche (feuille)
- Reçoit à sa création un numéro unique dans tout l'environnement d'un utilisateur (exemple 1-669) ;
- Appartient à un seul plugform qui possède lui-même une clé PF unique (visible) en plus du hash non visible de son propriétaire (1-A002) ;
- Comprend un maximum de 15 champs (Fx) dont certains peuvent être des tableaux (Tx) ;
- S'il s'agit d'un champ tableau, il y a aussi derrière le format et le numéro du champ (T4), 1 position des données qui est définie par le numéro de ligne (L1) et le numéro de colonne (C3) ;
- Chaque appendice est inclus dans une section Attachments et son contenu est traduit en base64 dans le JSON.
Ceci explique comment la structure de base de chaque fichier JSON reste simple quel que soit le plugform d'origine. Pour connaître l'objet de chaque ligne du fichier JSON (à l'exception des lignes 3 et 5), vous pouvez consulter une note de plugform dans Plugnotes.
JSON complet
2) Importer des données de Plugnotes vers le Business Center (via le plugform XX14)
- Dans Plugnotes : vous devez créer une plugnote spécifique dans le XX14 qui identifie quel plugform est concerné par quel service Web (14xx).
Connecteur : Vous devez disposer des informations suivantes pour connecter le compte Business Center de l'utilisateur à son compte Plugnotes. Ces données seront renseignées dans chaque plugnote du XX14.
Services Web disponibles (certains ne sont pas disponibles avec tous les connecteurs) :
- Dans Business Central : les fichiers JSON envoyés par Plugnotes sont stockés dans une table tampon spécifique qui est ensuite traitée via le développement :
- Une table de paramètres de mappage doit également être créée pour permettre de connaître les programmes à lancer en fonction du code plugform reçu de Plugnotes dans le fichier JSON :
- Donc du côté BC, nous devons faire du développement pour traiter les fichiers reçus de Plugnotes.
3) Importer des données de BC vers Plugnotes (via notre Plugform XX13)
- Dans Business Central : Création d'une table de configuration Plugnotes dans laquelle doivent être placées les données correspondant à celles créées dans Plugnotes.
Pour la création ou la modification d'une plugnote, le développement spécifique pour générer le bon fichier JSON est réalisé dans BC :
- Dans les Plugnotes : Il est nécessaire de créer dans le XX13 une Plugnote spécifique pour chaque Plugform susceptible de recevoir un JSON et de préciser l'action attendue :
--
Customer Success
Si vous avez des questions, veuillez contacter notre équipe de Customer Success Team