Travaux/ordres de production
Votre guide d'intégration V5 !
L'intégration des travaux/ordres de production entre V5 Traçabilité et le système ERP d'un client permet de planifier les ordres de travail pour les formules de lots et de produits dans V5 Traçabilité. Ces détails permettront ensuite à ces travaux d'être traités par le Terminal V5.
Table des Matières
1. Disposition du centre de contrôle
En ce qui concerne la façon dont nous pouvons relier les détails du travail à ce que nous voyons dans le centre de contrôle, nous utiliserons l'API V5 principalement pour remplir le panneau supérieur « Tâche » afin d'importer et d'exporter ces détails, avec des informations dans le panneau inférieur « Ligne de travail ». étant automatiquement renseigné en fonction de la configuration de la formule/recette.
En utilisant la passerelle V5, nous pouvons facilement remplir les données ici en utilisant le ‘Job’ point final. Cependant, une approche plus avancée peut être adoptée, utilisant les ‘PreBatch’ point final. Nous examinerons l’utilisation de ces deux éléments ci-dessous.
2. Liens API
3. Modèle d'intégration
Le modèle d'intégration pour les Jobs/Ordres de Fabrication peut être téléchargé ici.
4. Guide de terrain des travaux/ordres de production
4.1. Clés primaires
Les clés primaires sont l'identifiant unique de chaque table dans l'API V5. Pour Job, ceux-ci sont:
jobNumber - Le code d'identification unique du travail.
formula.commodity.code – Le code identifiant unique de la formule à programmer.
Pour PreBatch, les clés primaires sont :
jobLine.job.jobNumber - Comme ci-dessus, le code d'identification unique du travail.
BatchSeq – La séquence de production du lot pour cette ligne de travail particulière.
4.2. Champs obligatoires
D'autres champs sont requis par SG pour remplir une ligne de travail valide dans Control Center. Pour Job, c'est:
products - Le nombre de produits requis (lié à l'UdM de base de la formule) par lot par la ligne supérieure (de travail) de ce travail.
Pour PreBatch, c'est:
products - Le nombre de produits que le lot individuel doit produire.
4.3. Champs préférés
Les champs préférés servent à ajouter plus d'informations sur la tâche en question et, bien qu'ils ne soient pas obligatoires, sont utiles lorsqu'il s'agit d'ajouter des fonctionnalités dans V5 Traçabilité. Pour Job, ceux-ci pourraient inclure :
batchesRequired - Le nombre de lots requis pour le travail. Si ce n'est pas le cas, le système utilisera la quantité de produits (décrite ci-dessus) et la taille de base + produits min/max pour calculer le nombre de lots à produire.
status - Le statut avec lequel le travail sera importé (0 = En attente, 1 = Planifié, 2 = En cours, 3 = Terminé, 4 = Test, 5 = En attente), les travaux seront généralement importés avec le statut « 1 », à moins qu'ils ne soient programmés manuellement à une date ultérieure et qu'ils puissent donc être importés avec le statut « 0 ».
Ces champs pourraient également s'appliquer à PreBatch une fois que nous avons accédé à l'objet de travail dans l'API.
4.4. Champs supplémentaires
Des champs supplémentaires peuvent également être inclus pour le Job point final, tel que :
productionDate - Date à laquelle le travail doit être produit. Sera importé en tant que vide s'il n'est pas présent, permettant aux travaux d'être vus par les terminaux à tout moment.
Pour PreBatch, nous pouvons traverser vers ce même champ sous jobLine.job.productionDate. Cependant, on peut aussi utiliser le jobLine.productionDate champ pour affecter la date de production de chaque ligne de travail individuelle plutôt que l'ensemble du travail lui-même, ce qui nous permet un contrôle plus strict sur notre processus de production.
5. Méthodologie
Selon la méthode utilisée pour notre intégration, nous pouvons utiliser les points de terminaison suivants pour faciliter les importations. Cela peut être soit :
- ‘Job’ or ‘Prebatch’ points de terminaison pour l’intégration JSON.
- ‘Job’ point de terminaison pour l’intégration du partage de fichiers CSV.
Les exportations peuvent être traitées de différentes manières, que nous examinerons toutes ci-dessous.
5.1. JSON – Importation
Job:
Nous pouvons utiliser le ‘Job’ point final pour créer de nouveaux emplois pour la production dans la traçabilité V5.
‘Job’ importer le point de terminaison/URI –
http://host:port/V5-API/api/integrate/import/job
Pour cet exemple d'importation à l'aide du ‘Job’ point final, nous pouvons structurer un fichier d'importation de base pour une seule tâche comme ci-dessous :
Cet exemple de fichier JSON peut être téléchargé ici.
En utilisant le manuel de l'API, nous pouvons voir ici que nous utilisons plusieurs points de données dans le ‘Job’ classe pour structurer ce fichier. Cependant, pour rappeler correctement le code de formule que nous voulons produire, nous devons d'abord passer au ‘Formula’ classe, puis utilisez le ‘Commodity’ classe pour définir le ‘Code’ point de données que nous pouvons utiliser, puis l'imbriquer dans le fichier JSON de manière appropriée, comme nous pouvons le voir ci-dessus.
Nous pouvons voir un résumé de ce processus de flux de données ci-dessous :
Si nous exécutons le fichier JSON ci-dessus, nous verrons que notre travail est désormais visible dans l'onglet 'Production' du Control Center.
Vous remarquerez que cela a automatiquement créé les lignes de travail dans le panneau inférieur. Le ‘Job’ le point final le fera automatiquement en fonction du structure de la formule.
Pré-lot :
Nous pouvons voir ci-dessus que nous pouvons utiliser le ‘Job’ point final pour saisir des tâches simples dans le plan de production dans V5 Traçabilité. Cependant, si nous souhaitons un contrôle plus précis sur la configuration de notre tâche, nous pouvons utiliser le ‘PreBatch’ URI à la place. Cela nous permet de spécifier des détails tels que la taille du lot individuel, le nombre de produits et le lieu de production.
‘PreBatch’ importer le point de terminaison/URI –
http://host:port/V5-API/api/integrate/import/pre_batch
Pour cet exemple d'importation à l'aide du ‘PreBatch’ point final, nous pouvons structurer un fichier d'importation de base pour un seul travail avec plusieurs lots comme ci-dessous
Cet exemple de fichier JSON peut être téléchargé ici.
Nous pouvons donc voir en examinant ce fichier que nous créons un nouveau travail (Job-111) avec 2 lots d'une formule 'Basic Bread Pâte', un pour 30lbs, à fabriquer dans la fabrication 1, et un pour 50lbs, à fabriquer. fabriqué en fabrication 2. Si nous regardons le manuel API pour le ‘PreBatch’ classe, nous pouvons alors voir une méthode de parcours similaire en jeu ici pour construire notre fichier.
Si nous exécutons le fichier JSON ci-dessus, nous verrons ce nouveau travail créé, puis si nous examinons la vue par lots, nous verrons les différences dans les tailles de lots/emplacements de production, ainsi que notre personnalisation prédéfinie. numéros de lots. Le séquençage par lots peut également être inclus ici si vous le souhaitez.
5.2. JSON – Exporter
En termes de réception de fichiers relatifs aux tâches de l'API V5, il existe quelques options différentes des classes IntegrationExport et ExportTransaction que nous pouvons utiliser, que nous examinerons ici.
Job:
Point de terminaison/URI d’exportation de tâches individuelles –
http://host:port/V5-API/api/integrate/export/job/{jobNumber}
Ce point de terminaison exportera un fichier JSON avec toutes les informations associées à la tâche spécifiée. Si nous exécutons cette requête en utilisant le numéro de travail du travail que nous venons d'importer, nous obtiendrons un fichier qui ressemble à ceci :
Un exemple de fichier JSON de ce type peut être téléchargé ici.
Tous les emplois :
Exporter le point de terminaison/URI de toutes les tâches
http://host:port/V5-API/api/integrate/export/jobs
Ce point de terminaison exportera un fichier JSON qui inclut une liste de tous infection tâches dans le système, définies comme des tâches qui ont un statut autre que « terminé » ou qui ont été supprimées du Control Center.
Si nous exécutons cette requête, nous recevrons un fichier JSON de retour qui est structuré de la même manière que l'exportation ci-dessus pour une tâche unique, mais comme mentionné, il inclura toutes les tâches actives.
Un exemple de fichiers JSON de ce type peut être téléchargé ici.
Nous pouvons également utiliser points de terminaison transactionnels et de journalisation pour récupérer des informations plus pertinentes sur les tâches et les ordres de fabrication.
Pour Journal du système points finaux, ce sont :
5.3. CSV – Importer
Nom du fichier de définition d'en-tête/colonne : “job.csvh”
Les fichiers d'en-tête complétés doivent être placés dans : “<installdir>\SG Control Center\gateway\import\column_defs”
Importer le nom du fichier CSV : “job-datetime.csv”
Les fichiers CSV à importer doivent être placés dans : “<installdir>\SG Control Center\gateway\import”
En tête de fichier:
Les fichiers d'en-tête seront généralement compilés par SG Systems avant les intégrations CSV, mais nous pouvons voir un exemple de base de celui que nous pouvons utiliser pour les tâches, en utilisant le fichier précédemment défini définitions de classe, au dessous de:
Pour plus d'informations sur la manière dont nous structurons ces fichiers, veuillez consulter le page d'intégration principale. Cet exemple de fichier d'en-tête peut être téléchargé ici.
Fichier d'importation CSV :
Nous pouvons ensuite utiliser l'ordre défini des points de données dans l'en-tête pour structurer notre fichier d'importation. SG Systems peut fournir un fichier modèle pour cela, répertoriant les points de données pour chaque colonne afin de clarifier les choses lors du remplissage de la liste. Notez que cette première ligne peut être ignorée par Control Center et peut donc être conservée dans le fichier lors de la soumission pour importation.
Un exemple de fichier d'importation CSV pour les tâches pourrait ressembler à ceci :
Cet exemple de fichier d'importation peut être téléchargé ici.
Une fois l'importation terminée, nous pouvons voir que ces tâches supplémentaires ont été ajoutées au Control Center aux côtés de la tâche que nous avons créée à l'aide de l'importation JSON ci-dessus.
5.4. CSV – Exporter
Comme pour les exportations JSON, nous proposons ici plusieurs options différentes. Nous pouvons commencer par simplement exporter une liste de tâches au sein du système :
Emplois/horaire :
Exporter le nom du fichier CSV : “job.csvh”
Les fichiers d'en-tête complétés doivent être placés dans : “<installdir>\SG Control Center\gateway\export/order”
Exporter le nom du fichier CSV : “job-datetime.csv”
Les CSV pour les exportations seront générés dans : “<installdir>\SG Control Center\gateway\export”
Nous pouvons utiliser les définitions de classe précédemment définies pour structurer un fichier d'en-tête afin de définir les données que nous récupérerons.
Cette exportation devra être activée dans la section Passerelle du Control Center. Nous pouvons choisir ici d'exporter 'Schedule'.
En tête de fichier:
Dans ce cas, utilisons simplement le même fichier d'en-tête que celui utilisé ci-dessus pour l'importation :
Fichier d'exportation CSV :
Nous obtiendrions un fichier CSV de retour qui ressemblerait à ceci :
Un exemple de ce type de fichier peut être téléchargé ici. Notez que si un fichier d'en-tête n'est pas présent dans le dossier indiqué, alors un CSV sera exporté contenant tous les points de données du dossier. ‘Job’ classe.
Bien que ce point de terminaison exporte uniquement une liste de tâches, nous pouvons utiliser plusieurs points de terminaison différents pour récupérer des informations plus détaillées relatives à la consommation et à la production.
Journaux de lots :
Exporter le nom du fichier CSV : “BatchLog-datetime.csv”
Les CSV pour les exportations seront générés dans : “<installdir>\SG Control Center\gateway\export”
Le moyen le plus simple de récupérer les données de production des travaux à partir de V5 Traceability sous la forme d'un CSV consiste simplement à utiliser et à traiter des « journaux de lots ».
Encore une fois, cette exportation devra également être activée dans la section Passerelle du Control Center. Nous pouvons choisir ici d'exporter les 'Batch Logs'.
Fichier d'exportation CSV :
Nous n'aurions pas besoin de créer un fichier d'en-tête ici car la passerelle V5 remplira par défaut une liste définie de points de données. Avec cette exportation activée, le système exportera un ‘BatchLog’ fichier chaque fois qu'un lot d'un travail est terminé par le système. Un exemple de base est présenté ci-dessous :
Un exemple de ce type de fichier peut être téléchargé ici.
Journal du système:
Si nous souhaitons recevoir des données de production de travaux plus personnalisées ou détaillées (‘CONSUMED’/’PRODUCE’) de retour de la traçabilité V5, nous pouvons utiliser le ‘SystemLog’ point final pour ce faire.
Nom du fichier de définition d'en-tête/colonne : “SystemLog.csvh”
Les fichiers d'en-tête complétés doivent être placés dans : “<installdir>\SG Control Center\gateway\export\order”
Exporter le nom du fichier CSV : “SystemLog-datetime.csv”
Les CSV pour les exportations seront générés dans : “<installdir>\SG Control Center\gateway\export”
Pour ce type d'export utilisant ce point de terminaison, nous structurerions notre en-tête en utilisant le ‘SystemLog’ définitions de classe de base de données.
Comme pour les autres exemples ci-dessus, cette exportation devra être activée dans la section Passerelle du Control Center :
En tête de fichier:
À partir de là, nous pouvons structurer notre en-tête en fonction des données transactionnelles liées aux tâches que nous souhaitons renvoyer à l'ERP. Pour nos besoins ici, cela pourrait ressembler à ceci :
Cet exemple de fichier d'en-tête peut être téléchargé ici.
Fichier d'exportation CSV :
Si nous exécutons ensuite un simple lot, l'exportation du journal système ressemblera à ceci :
Cet exemple d'exportation peut être téléchargé ici.
