Lien de danger
Votre guide d'intégration V5 !
Le point de terminaison d'importation « HazardLink » peut être utilisé pour affecter rapidement des produits de base à des groupes de dangers dans V5 Traceability.
Ce guide se concentrera sur la façon d'utiliser ce point de terminaison, à la fois via l'importation CSV et en utilisant JSON via l'API V5.
Table des Matières
1. Groupes de risques par défaut
La base de données V5 par défaut contient un certain nombre de groupes de dangers les plus courants, mais ce point de terminaison peut être utilisé pour en créer d'autres si nécessaire. Les groupes de dangers standard inclus sont visibles dans la capture d'écran ci-dessous :
Ce point de terminaison n'est pas destiné à être utilisé pour la création de produits de base ; cette opération doit toujours être effectuée via le point de terminaison « Produit de base ».
2. Liens API
Pour en savoir plus sur les définitions de ce « HazardLink » et les classes de base de données associées, veuillez consulter le lien suivant :
3. Guide pratique HazardLink
3.1. Clés primaires
Pour les deux méthodes d'importation, les clés primaires sont :
Danger_Danger – le nom du groupe de danger (ex. lunettes de sécurité, protections auditives, etc.).
Code_Produit – Le code unique du produit à attribuer au groupe de risque.
3.2. Champs supplémentaires
D'autres options ici que nous pouvons ajouter à partir de la classe de base de données « Hazard » sont :
Hazard_WarningText – Texte à afficher à l'opérateur de terminal ou de WMS lors de la manipulation du produit associé à un danger. Uniquement nécessaire lors de la création de nouveaux groupes de dangers.
Hazard_TextColor – Permet de saisir un nombre RVB pour attribuer une couleur au groupe de danger. Cette couleur doit être identique pour tous les produits appartenant au même groupe. Notez également que lors de l'importation de couleurs avec cette méthode, il n'est pas nécessaire de séparer les nombres RVB par des virgules (par exemple : 219 125 33 au lieu de 219, 125, 33).
Notez que cette option n'est pas disponible pour la méthodologie JSON, sauf si vous créez un nouveau groupe de risques via ce point de terminaison. Si une modification des couleurs de groupe existantes est requise, il est recommandé d'utiliser le point de terminaison CSV.
4. Exemple de jeu de données
Pour cet article, nous examinerons un exemple simple d'ensemble de données comportant deux ingrédients qui pourraient être utilisés pendant la production :
- Alcool benzylique – Masque de sécurité (orange) et gants de sécurité (rouge)
- Propylène glycol – Lunettes de sécurité (bleues) et gants de sécurité (rouges)
5. Méthodologie
5.1. JSON – Importation
Point de terminaison/URI d'importation « HazardLink » –
http://host:port/V5-API/api/integrate/import/hazard_link
échantillons:
En utilisant le point de terminaison « HazardLink », nous pouvons structurer un fichier d’importation pour les ajouts ci-dessus comme suit :
Ce fichier JSON d'exemple peut être téléchargé ici.
Et une fois que nous avons publié cela dans le système, nous pouvons voir que tous nos produits ont été attribués au bon groupe de dangers, dans ce cas, nous pouvons voir les deux produits ajoutés au groupe de dangers « Gants de sécurité ».
5.2. CSV – Importer
Pour les importations CSV, nous devons d’abord construire un fichier d’en-tête pour nos importations.
Nom du fichier de définition d'en-tête/colonne : « hazardLink.csvh »
Les fichiers d'en-tête complétés doivent être placés dans : « <installdir>\SG Control Center\gateway\import\column_defs »
Nom du fichier CSV à importer : « hazardLink-datetime.csv »
Les fichiers CSV à importer doivent être placés dans : « <installdir>\SG Control Center\gateway\import »
échantillons:
En tête de fichier:
Vous trouverez ci-dessous un exemple de fichier d'en-tête. Ici, nous allons attribuer nos produits aux groupes de dangers définis et ajouter également une couleur aux groupes :
Pour plus d'informations sur la structure de ces fichiers, veuillez consulter la page d'intégration principale . Vous pouvez télécharger cet exemple de fichier d'en-tête 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. Notez que cette première ligne peut être ignorée par le Centre de contrôle et peut donc être conservée dans le fichier lors de la soumission pour l'importation. Un exemple d'importation basé sur nos exigences ci-dessus ressemblerait à ceci :
Notez encore une fois que les virgules qui séparent habituellement les valeurs RGB ne sont pas nécessaires. Vous pouvez télécharger cet exemple de fichier d'importation ici.
Nous pouvons ensuite déposer ce fichier dans notre dossier d'importation comme défini ci-dessus, et une fois l'importation terminée, nous pouvons voir que les couleurs du texte du groupe de dangers ont été mises à jour et, comme ci-dessus, les 2 ingrédients sont désormais ajoutés au groupe « Gants de sécurité » :
