Transformation EDI

Traitement

Le module EDI est destiné avant tout à faire de l'échange informatisés avec d'autre système via l'intermédiaire d'un FTP ou d'un SFTP: récupérer des commandes d'un client, lui envoyer la liste des numéros de séries de chaque livraison. 

Le module EDI d'Open-Prod offre aussi des possibilités plus poussées encore avec des méthodes qui permettront de générer des fichiers excel ou csv, d'envoyer des mails avec des pièces jointes extraites d'Open-Prod, de déposer des fichiers sur des serveurs FTP distant pour communiquer avec d'autres ERP, d'agir sur des enregistrements existant via des méthodes du code source, de créer des enregistrements comme des nouvelles commandes, ...

Les EDI se gèrent à l'aide de traitements. Les traitements sont des suites de procédures qui vont permettre la réalisation des fichiers d'échanges ainsi que les échanges qui vont s'effectuer avec le FTP. Ils sont à créer dans le sous-menu Configuration > Transformation EDI > Transformation > Traitement.

Il sera possible d'automatiser ces échanges grâce à des actions planifiées.

Les Traitements

Entête

Nom : nom donné au traitement
Catégorie : champ informatif pour catégoriser le traitement. Permet d'effectuer des filtres et de les retrouver facilement.

Une image contenant texte

Description générée automatiquement

Mail erreur : si la case est cochée, un mail sera envoyé en cas d'erreur
Société : société qui réalise l'échange. Par défaut c'est la société de la base.
Séquence : ordre dans lequel les traitements s'effectueront
En cours : si la case est cochée, le traitement est en train de se réaliser. Permet de vérifier s'il n'y a pas de problème. Par exemple, si le traitement ne s'est pas terminé à cause d'une coupure du serveur.

Onglet Procédures

Présente la liste ordonnée des procédures à exécuter lors du traitement. Exemple : Générer un fichier excel > l'envoyer par mail.

Onglet Crons

Affiche la liste des actions planifiées qui exécuteront le traitement. Il faut souvent la créer ou en utiliser une existante. Exemple : Envoyer un fichier excel par mail une fois par mois.

Onglet Ajouter action

Cet onglet définit l'action à réaliser et une fois crée, elle est ajoutée aux actions de la table dont les données dont à échanger. Il sera donc possible d'effectuer l'échange de donnée sur certains enregistrements en particulier ou au bon vouloir de l'utilisateur. Il contient les champs suivants:

Modèle de l’objet : table à laquelle l'action sera rattachée
Lancer une fois pour tous les IDS: si la case est cochée, l'action sera effectuée pour l'ensemble des éléments définis dans les procédures. L'action effectuera la même procédure qu'un cron.

Le champ %object_ids est renseigné si la case "Lancer une fois pour tous les IDs" est cochée. Sinon, c'est le champ %object_id qui est fourni.

Act serveur : nom de l'action créée. Il se remplit automatiquement lorsque l'action Ajouter action sur la droite est effectuée. Vous retrouverez cette action dans les actions-serveurs.
Télécharger directement : Si cette case est cochée, alors lors de l’execution EDI, le dernier fichier du traitement sera téléchargé sur la session de l’utilisateur en cours.

Les Actions

Plusieurs actions sont présentes à droite de la vue :

Aller à la liste des procédures : permet d'afficher la liste des procédures enregistrées dans l'onglet Procédures.
Tout exécuter : permet de lancer le traitement manuellement depuis le formulaire.
Ajouter action : crée l'action définie dans l'onglet Ajouter action

Procédure

Les traitements des EDI sont un enchaînement de procédures. Le formulaire se compose d'un entête et de quatre onglets: Action, Domaine, Vérification, Administration. Toutes les procédures des traitements sont listées dans le menu Configuration > Transformation EDI > Transformation/Procédure ou directement depuis le traitement. Pour pouvoir être utilisée dans un traitement et exécutée, il faut que la procédure soit active (faire évoluer le workflow à gauche de l'écran).

Entête

Il comprend les champs suivants:

Nom: nom de la procédure.
Séquence: ordre dans lequel elle va se réaliser.
Traitement: traitement auquel elle est rattachée.
Action type: Type de l'action réalisée par la procédure.
SQL: action réalisée à partir d'une requête SQL (extration de données, mise à jour de données, ...). L'onglet « Action » permet alors de configurer la requête à exécuter. 
Méthode: l'onglet « Méthode » est alors visible. Le champ Méthode de cet onglet permet de choisir des méthodes code dans le code source : Vider la liste de fichier, SQL vers CSV, ... Les méthodes sont expliquées en bas de page.

Onglet Action

Visible que si le type de l'action est SQL. Il permet d'effectuer des actions sur les données directement dans la base. Par exemple mettre à jour des données à intervalle régulier.

Le premier cadre permet d'écrire ou copier la requête SQL. Le deuxième cadre se remplira avec le résultat de la requête après l'exécution. Le champ Formater le résultat permet de présenter le résultat de manière plus lisible. Il est coché par défaut.

Onglet Domaine

Visible que si le type de l'action est SQL. Il permet d'effectuer des filtres sur les données de la requête de l'onglet Action. Il ne faut pas oublier dans la requête de l'action d'ajouter le domaine comme indiquer dans l'aide de la syntaxe au dessus du cadre.

Le premier cadre permet d'écrire ou copier la requête SQL. Le deuxième cadre se remplira avec le résultat de la requête après l'exécution. 

Onglet Vérification

Visible que si le type de l'action est SQL. Il permet d'effectuer une vérification sur la requête de l'onglet action. C'est une requête booléenne qui renvoie True ou False. Si le résultat est False il remet à zéro les données comme si la requête n'avait pas été effectuée.

Onglet Administration

Il contient les champs suivants :

Date de dernière exécution (Début) : date à laquelle la première requête a été exécutée.
Dernière date : date à laquelle l'exécution s'est terminée.
Vérification : État de l'exécution de la requête de vérification :

Brouillon : la requête n'a pas été exécuté.
Terminé : la requête a été exécutée et il n'y a pas eu d'erreur.
Erreur : la requête de vérification n'a pas été vérifiée.

Une image contenant texte

Description générée automatiquement

Les actions

Sur la droite plusieurs actions sont possibles :

Tout exécuter : permet d'exécuter l'ensemble des requêtes des trois onglets.
Exécuter action : permet d'exécuter seulement la requête de l'onglet action. Visible que si le type de l'action est SQL.
Exécuter domaine : permet d'exécuter seulement la requête de l'onglet domaine. Visible que si le type de l'action est SQL.
Exécuter vérification : permet d'exécuter seulement la requête de l'onglet vérification. Visible que si le type de l'action est SQL.

Onglet Méthode

Visible seulement si le type de l'action est Méthode. Dans ce cas, il faut sélectionner l'action souhaitée dans la méthode ; la liste en dessous s'adaptera pour le paramétrage de la méthode. Les méthodes suivantes sont disponibles :

Vider la liste des fichiers : Lorsque l'EDI récupère des fichiers pour faire des transferts il les garde en mémoire. Cette méthode permet de les effacer de la mémoire.
SQL vers CSV : Cette méthode va permettre d'exporter dans un fichier CSV le résultat de la requête SQL indiquée. Exporter dans un csv des écritures comptables pour les transférer dans une logiciel comptable. 
Import CSV : Permet d'exporter l'ensemble des éléments d'une table dans un fichier CSV. Exemple : Importer un fichier de commande d'un client
Exécuter méthode : Exécute la méthode indiquée. Par exemple, do_something. Ce sont des méthodes du code source. 
SQL vers Jasper : Cette méthode va permettre d'exporter dans un fichier Jasper le résultat de la requête SQL indiquée. Exemple : Imprimer les bons de livraisons en attente des clients 
Envoyer des fichiers : Permet d'envoyer des fichiers dans le FTP. Exemple : Déposer des fichiers csv ou pdf sur un serveur distant.
SQL vers TXT : Cette méthode va permettre d'exporter dans un fichier texte le résultat de la requête SQL indiquée.
Import texte (largeur fixe) : Permet d'exporter une table en se basant sur un fichier au format txt et donc les colonnes sont délimitées en largeur fixes. Import des ecritures d'un système comptables comme Quadra.
Envoyer un mail : Permet d'envoyer un mail en se basant sur un modèle de mail prédéfini.
Lors de l'envoi de mail, l'EDI doit passer une id au modèle de mail sur l'objet paramétré dans le modèle. Sans cette id, la génération du lieu n'aura pas lieu (message d'erreur). Exemple : si le modèle de mail est sur l"objet partenaire, il faudra passer l'id d'un partenaire existant pour que le mail soit généré. Ce partenaire sera propagé comme enregistrement lié dans le mail.
SQL vers XLS : Cette méthode va permettre d'exporter dans un fichier excel le résultat de la requête SQL indiquée. Cette méthode nécessite un fichier excel modèle, champ Template dans la configuration de la procédure, (avec par exemple le nom de colonne déjà renseigné) à déposer sur le serveur, champ Template name.
Le template doit être renseigné avec son chemin absolu. Le plus simple est de retrouver le fichier en terminal puis de lancer une commande pwd pour obtenir le chemin complet. Exemple de chemin : /home/openprod/filestore/share/openprod/documents/openprod1/Root.
Le template doit nécessairement être au format XLS pour que cette méthode fonctionne.
SQL vers XLSX : Fonctionne de manière similaire à la méthode SQL vers XLS mais exporte et prend un template au format XLSX.
Fichier Zip : Permet de transformer le fichier sélectionné en fichier zip dans le but de l'exporter ensuite sur un serveur distant.

Sauvegarde BDD : Permet d'envoyer le zip de la base de données vers un serveur. Peut faciliter les sauvegardes régulières et automatique de la base de données et du filestore.
Récupération document Openprod : Permet de récupérer des ir_attachements (utilisé, entre autres, pour les exports vers des logiciels comptables).
XML vers objet Openprod : Permet d'importer via import XML.
SQL/EDI vers Action serveur : Permet d'appeler une action serveur en paramètre par son id.
XLSX vers objet Openprod : Permet d'importer via import XLSX.
Calculer les KPI : Permet de mettre à jour les KPI.
Analyses des performance

Récupération de fichier