Lien de danger
Votre guide d'intégration V5 !
Le point de terminaison d'importation « HazardLink » peut être utilisé pour attribuer rapidement des produits à danger groupes au sein de la traçabilité V5.
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, cela doit toujours être fait via le 'Marchandise' point final.
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 (c’est-à-dire lunettes de sécurité, protections auditives, etc.).
Code_de_marchandise – Le code unique du produit à attribuer au groupe de danger.
3.2. Champs supplémentaires
D'autres options ici que nous pouvons ajouter à partir de la classe de base de données « Hazard » sont :
Texte d'avertissement de danger – Le texte à afficher à l'opérateur du terminal ou du WMS lorsque la marchandise associée à un danger est manipulée. Nécessaire uniquement lors de la création de nouveaux groupes de dangers.
Hazard_TextColor – Permet d'entrer un numéro RVB pour attribuer une couleur au groupe de dangers. Notez que cela doit être le même pour tous les produits au sein du même groupe de dangers. Notez également ici que lors de l'importation de couleurs à l'aide de cette méthode, les numéros RVB n'ont pas besoin d'être séparés 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 :
Cet exemple de fichier JSON 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 : " \SG Control Center\gateway\import\column_defs"
Importer le nom du fichier CSV : « hazardLink-datetime.csv »
Les fichiers CSV à importer doivent être placés dans : " \Centre de contrôle SG\passerelle\importation »
é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 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. 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 que nous n'avons pas besoin des virgules qui séparent normalement les valeurs RVB. Cet exemple de fichier d'importation peut être téléchargé 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é » :
