AllergèneLink
Votre guide d'intégration V5 !
Le point de terminaison d'importation « AllergenLink » peut être utilisé pour attribuer rapidement des produits à allergène 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 d'allergènes par défaut
La base de données V5 par défaut contient un certain nombre de groupes d'allergènes les plus courants, mais ce point de terminaison peut être utilisé pour en créer d'autres si nécessaire. Les groupes d'allergènes 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 « AllergenLink » et les classes de base de données associées, veuillez consulter le lien suivant :
3. Guide pratique d'AllergenLink
3.1. Clés primaires
Pour les deux méthodes d'importation, les clés primaires sont :
Allergène_Allergène – le nom du groupe d’allergènes (c’est-à-dire blé, gluten, etc.).
Code_de_marchandise – Le code unique du produit à attribuer au groupe d’allergènes.
3.2. Champs supplémentaires
D'autres options ici que nous pouvons ajouter à partir de la classe de base de données « Allergen » sont :
Allergen_TextColor – Permet d'entrer un numéro RVB pour attribuer une couleur au groupe d'allergènes. Notez que cela doit être le même pour tous les produits appartenant au même groupe d'allergènes. 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).
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 :
Nous allons donc ici attribuer les groupes d'allergènes par défaut suivants à ces produits. Pour les importations CSV, nous attribuerons également des couleurs de texte en même temps :
- Farine – Blé (rouge) et gluten (violet)
- Fromage – Produits laitiers (jaune)
- Les œufs – Oeuf (vert)
- Soja – Soja (bleu)
- Amandes – Fruits à coque (orange)
5. Méthodologie
5.1. JSON – Importation
Point de terminaison/URI d'importation « AllergenLink » –
http://host:port/V5-API/api/integrate/import/allergen_link
échantillons:
En utilisant le point de terminaison « AllergenLink », 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 posté cela dans le système, nous pouvons voir que tous nos produits ont été attribués au bon groupe d'allergènes, dans ce cas les amandes sous « Fruits à coque ».
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 : « allergenLink.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 : « allergenLink-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 d'allergènes 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 déjà voir que les couleurs du texte du groupe d'allergènes ont été mises à jour :
Et si nous examinons chaque groupe, nous verrons que nos allergènes souhaités ont été ajoutés :
