Le scrutateur de production
- Bertrand Littel
SOMMAIRE
Principe du scrutateur du module Production
Ce traitement permet d'automatiser l'import de données dans Divalto, notamment des données liées à la gestion de production. Dans l'ERP, un certain nombre d'informations peuvent ainsi être « injectées » via un fichier d'intégration.
Une fois lancé, ce traitement en tâche de fond, va analyser l'ensemble des répertoires d'import définis. Dès qu'un nouveau fichier est déposé dans l'un de ces répertoires, le scrutateur l'analysera pour en déterminer le type et chaînera automatiquement vers le programme adéquat.
Le scrutateur n’effectue aucun traitement métier. Il ouvre les fichiers déposés, détermine quel traitement est capable de traiter le contenu, et fait appel à ce dernier en lui indiquant les fichiers reçus
Pour son bon fonctionnement, une arborescence de répertoires windows est imposée, et un minimum de paramétrage est nécessaire
Paramétrage
Le paramétrage principal se fait dans l’onglet PDP-Paramétrage de la fiche dossier Production
Mais le scrutateur traite également le retour de PDF signés dans l’onglet Impression pièces de la fiche dossier Achat-vente
1. Le chemin interface
Le code chemin interface dans la fiche dossier Production est essentiel car il donne le répertoire windows RACINE du scrutateur. Sur un poste local il est initialisé à “/divalto/interfaces”, mais devra être modifié. Préférez un emplacement proche de la lettre lecteur (C:\ ou D:\) pour éviter des problèmes futurs de nom trop long
Le scrutateur devra avoir des droits complets (lecture, écriture, suppression) sur ce répertoire racine et sur ses sous-répertoire pour fonctionner, et ce avant son premier lancement
2. Pour le module Production seul ou les PDF signés
Le scrutateur est utilisé par la fonction Saisie Atelier et le Suivi des temps par bons de regroupement de la gestion de Production, qui va générer des fichiers de manière déportée ou asynchrone afin de les traiter via les scrutateur.
Pour utiliser ces fonctions le scrutateur doit donc être opérationnel.
Le traitement du retour de PDF signés dans le cadre de la dématérialisation client est également dans ce cas. C’est le mode par “dépose fichier” dans ce cas, qui n’est pas l’usage principal avec Docoon car l’usage principal est de récupérer le fichier PDF par appel d’API Web.
3. Pour des échanges de données
En standard, selon les cases à cocher, le scrutateur sait traiter les logiciels complémentaires de types suivants :
MES - SFAO ; outils qui fournissent des pointages de temps ou consommation matières
Configurateur de gamme ; outils qui fournissent des gammes de production
Ordonnancement ; outils de planification d’OF
Cochez les cases en fonction de vos besoins. Pensez à relancer le scrutateur après tout changement
4. Durée de réveil
Le scrutateur est ‘connecté’ à la dépose de fichier dans le répertoire windows, il n’a donc pas de durée d’attente puisque chaque dépose de fichier vient le réveiller.
Il a cependant une durée de réveil, paramétrable dans les paramètres généraux Paramétrage des scrutateurs , qui vient en complément afin de forcer un réveil régulier par sécurité.
Arborescence des fichiers et extensions
Le scrutateur traite au départ des fichiers aux extensions .CSV, .XML et .PDF, puis est susceptible de traiter des fichiers complémentaires si le fichier principal y fait référence
Les répertoires du scrutateur
Divalto crée automatiquement l'arborescence des répertoires à partir de la racine saisie dans le dossier. Ces répertoires peuvent être locaux ou sur un serveur (chemins harmony).
Nom du dossier | Usage | Détails |
|---|---|---|
INTERFACES | RACINE du scrutateur (Niveau 0) | Déterminé dans le Dossier Production, “Chemin interfaces” C’est là qu’on dépose les fichiers, TOUS les fichiers Doit être créé au préalable |
NIVEAU1 |
| (forcément en niveau 1, sous la racine) |
DIVALTO | Sous-répertoire lié aux fonctions du module Production |
|
MES | Sous-répertoire lié à ces traitements externe |
|
CONFIGURATEUR | Sous-répertoire lié à ces traitements externe | |
PREACTOR | Sous-répertoire lié à ces traitements externe | |
NIVEAU2 |
| (forcément en niveau 2, sous l’un des répertoire du niveau 1 traité) |
IMPORT | Sous-répertoire à créer dans chaque répertoire de niveau 1 | Utilisé par le scrutateur, car il traite des import de données |
EXPORT | Sous-répertoire à créer dans chaque répertoire de niveau 1 |
|
NIVEAU3 |
| (forcément en niveau 3, sous IMPORT) |
EN COURS | Sous-répertoire créé automatiquement par le scrutateur lui-même | Lorsque le scrutateur trouve un fichier dans la racine, et détermine le traitement, le fichier est horodaté et déplacé dans ce répertoire EN COURS avant l’appel au traitement métier |
TRAITES | Sous-répertoire créé automatiquement par le scrutateur lui-même | Après traitement métier, s’il le fichier a été accepté par le traitement, le fichier est rangé dans les TRAITES. Cela ne signifie pas qu’il n’y a pas d’erreur. Les erreurs sont en générale dans un fichier généré ou le log, et sont plutôt des erreur métier non détectée lors de l’acceptation du fichier |
REJETES | Sous-répertoire créé automatiquement par le scrutateur lui-même | Après traitement métier, si le fichier n’a pas été accepté par le traitement, le fichier est rangé dans les REJETES. C’est en général un problème de structure du fichier (balise manquante, balise fausse, fichier compagnon manquant) |
(fichiers) | Les fichiers sont ici dans le répertoire IMPORT | C’est un POINT D’ENTREE du scrutateur. Tout fichier déposé ici est ‘vu’ par le scrutateur, traité et déplacé |
Lorsqu'un fichier est placé/créé dans le répertoire « Import », le scrutateur le déplace dans un premier temps dans le répertoire « En cours » et ajoute un nom d’horodatage, puis en fonction du résultat de l'importation, dans le répertoire « Rejetés » ou « Traités ».
Les fichiers traités ou rejetés sont donc suffixés avec la date et heure de l'importation. Ainsi vous pouvez importer toujours des fichiers ayant le même nom : la traçabilité est conservée.
En fonctionnement normal, le répertoire IMPORT est toujours vide, ou doit l'être.
Si des fichiers ayant une extension traitée par scrutateur sont là, c’est que le scrutateur est arrêté, ou entrain de les traiter
Si des fichiers ayant une autre extension sont là, il faut les déplacer pour ne pas ralentir le scrutateur qui est réveillé pour rien
Les fichiers (types, extension) et traitement appelés
Dépôt d’un fichier XML
C’est le mode principale de fonctionnement du scrutateur.
Les fichiers XML traités concernent plusieurs traitements.
Les fichiers XML déposés sont horodatés en SUFFIXE du nom courant
Le fichier XML doit respecter un format descriptif d’entête, afin de pouvoir trouver le traitement approprié
Plus d’informations
EXEMPLE
<?xml version="1.0" encoding="utf-8" ?>
<DIVALTO>
<ENTETE>
<ACTION>GG_DIVALTO_FIN_DE_CYCLE</ACTION>
<DATE>20190227143154</DATE>
<NO>1</NO>
</ENTETE>
<OF>
<DOS>998</DOS>
<FULLPINO> 711</FULLPINO>
<PREFIXE></PREFIXE>
<NUMERO> 711</NUMERO>
<DATE>20190227143154</DATE>
<MOUVEMENTER>1</MOUVEMENTER>
<COMPOSANT>
<SEQUENCE>S00010</SEQUENCE>
<REFERENCE>z_WMSART</REFERENCE>
<SREF1></SREF1>
<SREF2></SREF2>
<ENRNO></ENRNO>
<DEPOT>W1</DEPOT>
<QUANTITE> -1.000</QUANTITE>
</COMPOSANT>
</OF>
</DIVALTO>Dans cet exemple, ce qui est déterminant, ce sont
les balises DIVALTO /DIVALTO ou ERP /ERP qui indiquent que c’est un fichier pour le scrutateur Divalto
les balises de ENTETE à /ENTETE et surtout la balise ACTION qui indique quelle action est attendue.
C’est sur cet entête que le scrutateur détermine le traitement approprié, pour y faire appel. Le reste du fichier XML est spécifique à chaque traitement métier
ACTION | TRAITEMENT | Détails | Compléments |
|---|---|---|---|
GG_TEMPS_IMPORT | Import des temps (GGPP215) | Import temps MES. La case au dossier doit être cochée, sinon rejet | |
GG_IMPORT_ATELIER | Import des temps (GGPP215) | Réservé en interne module production pour la Saisie atelier - saisie temps | |
GG_DIVALTO_TEMPS_BR_M | Import des temps (GGPP215) | Réservé en interne module production pour la saisie temps par BR en saisie manuelle | |
GG_DIVALTO_TEMPS_BR_I | Import des temps (GGPP215) | Réservé en interne module production pour la saisie temps par BR pilotée XML | |
GG_FIN_DE_CYCLE | Fin de cycle (GGPP220) | Import consommation/fabrication sur OF pour MES. La case au dossier doit être cochée | |
GG_DIVALTO_FIN_DE_CYCLE GG_DIVALTO_TNT_FIN_DE_CYCLE | Fin de cycle (GGPP220) | Réservé en interne module production pour la Saisie atelier - consommation matière | |
GG_DATES_ORDO | Import dates OF (GGPP2118) | Import ordonnancement La case au dossier doit être cochée, sinon rejet | |
GG_IMPORT_NOMENCLATURE | Import données techniques (GGPP530) | Import données techniques de configurateur La case au dossier doit être cochée, sinon rejet | |
GG_COMPOSANT_OM | Fin de cycle Maintenance (GGPPMNT220) | Réservé en interne module production pour import consommation/fabrication sur OM pour MES La case au dossier doit être cochée, sinon rejet |
|
CO_MES_IMPORT | Import résultats contrôle (COPPSUI200) | Import résultats contrôle pour MES. La case au dossier doit être cochée, sinon rejet | https://divalto.atlassian.net/wiki/spaces/UDI112/pages/11005193492 |
Dépôt d’un fichier PDF
Les fichiers PDF traités concernent uniquement la dématérialisation des factures, pour la récupération du fichier PDF signé.
Les fichiers PDF déposés sont horodatés en PREFIXE du nom courant
Un fichier .TXT ou .DHUB portant exactement le même nom que le PDF sera déplacé aussi
Traitement appelé : import PDF signé GTPP630, pour joindre le fichier PDF signé en remplacement de la version en cours de signature
Résultat : PDF mis en pièce jointe de la facture
Retour possibles:
Traité : fichier traité. Le fichier PDF peut disparaitre du répertoire scrutateur ou rester présent
Erreur de traitement : voir livre de bord
Rejet
Plus d’information
Dépôt d’un fichier CSV
Les fichiers CSV traités concernent uniquement le retour de dates planifiées pour l’ordonnancement
Les fichiers CSV déposés sont horodatés en SUFFIXE du nom courant
Traitement appelé : import ordo GGPP218, pour mise à jour des dates planifiées
Résultat : mise à jour des dates OF
Retour possibles:
Traité : dates mises à jour
Erreur de traitement : format CSG incorrect
Rejet : si case non cochée au dossier production
Plus d’informations
Lancer et arrêter le scrutateur
Pour une installation locale
Menu : Production / O.F. / Utilitaires / Scrutateur
Une fois que le scrutateur est lancé, Divalto place une icône dans la barre des tâches de windows .
Pour stopper son exécution, vous pouvez cliquer sur cette icône avec le bouton droit de la souris.
Pour un environnement opérationnel
Le scrutateur est, en environnement opérationnel, toujours lancé par service windows
En OnPremise, suivez le guide sur les services Diva https://divalto.atlassian.net/wiki/spaces/PAI/pages/10757472449
En Saas, le scrutateur est prêt à l’emploi, suivez le guide d’administration https://divalto.atlassian.net/wiki/spaces/PAI/pages/10737451029
Technique et surcharge
Informations techniques supplémentaires:
lors de la déposer de fichier ‘un peu gros’ ou via une liaison lente, il est important de transférer le fichier avec une extension différente de son extension finale! Il faut faire le transfert, et une fois le fichier matérialisé dans le dossier scrutateur, le renommer pour changer son extension ; sinon le serveur windows va déclencher le scrutateur qui va tenter de lire et déplacer le fichier alors qu’il est en cours de transfert
L'ouverture “Action_Autre” du GGTT217 permet, lorsque le scrutateur reçoit un fichier XML avec la balise ACTION (similaire à la fin de cycle), d’orienter vers un traitement spécifique. Voir Scrutateur Divalto Production C&L