Erstellen und Validieren der Zieldefinition
Diese Seite beschreibt, wie eine Zieldefinition erstellt und validiert wird, um der Onedot Platform die gewünschte Zielstruktur zu onboardenden Produkdaten zu beschreiben.
Seite teilen: https://www.onedot.com/help/setup/target-definition
Was ist eine Zieldefinition?
Die durch Onedot verarbeiteten Produktdaten müssen in Ihr Zielsystem - egal ob ERP, PIM oder MDM - eingespielt werden. Hierzu muss die Onetdot Software wissen, welche Zielattribute es im Export geben soll und wie diese gehandhabt werden müssen.
Sofern Sie Änderungen oder Ergänzungen am gewünschten Zielformat vornehmen, muss auch die Zieldefinition entsprechend geändert oder ergänzt werden.
Attribute
Attribute müssen generell in Bezug auf ID, Name, Beschreibung, Typ, Aggregationen, etc. definiert werden. Hierbei wird zwischen globalen (allgemeinen) und spezifischen Attributen unterschieden:
Allgemeine Attribute finden in allen Artikeln Anwendung. Klassisch sind hier “Artikelbezeichnung” oder “GTIN” zu nennen.
Spezifische Attribute finden nur auf definierte Gruppen von Artikeln eine Anwendung. Je nach Zielsystem wird dies über die Kategorie oder über ein Schema (“Produktfamilien”) gesteuert. Somit kann dann ein Elektrogerät das Attribut “Leistung” haben, ein Handschuh aber nicht.
Im Rahmen der Zieldefinition wird definiert, welche Attribute ausgegeben werden. Es handelt sich also um Zielattribute.
Wertelisten
Wertelisten (Synonyme: Look-up Values, LUV, List of Values, LOV) werden grösstenteils für Drop-Down-Menüs verwendet. Der grosse Vorteil ist, dass man zwar etwas auswählen kann, die Werte jedoch bereits vorgegeben sind. Somit können Fehler bei der manuellen Eingabe in Ihrem Zielsystem effizient vermieden werden. Diese Listen werden in der Zieldefinition ebenfalls spezifiziert.
Kategoriebaum
Ein Export des Ziel-Kategoriebaums im Rahmen des PDM (Produktdatenmodells) wird auf jeden Fall benötigt.
Attribute per Kategorie
In diesem Abschnitt werden ausschliesslich kategoriespezifische Attribute den entsprechenden Kategorien zugewiesen. Ein Attribut kann auch mehreren Kategorien zugewiesen werden und eine Kategorie kann mehrere Attribute haben.
Warum dies so getan wird, ist weiter oben bei “Spezifische Attribute” erklärt.
Wörterbuch für Ziel-Einheiten
Das “Target Unit Dictionary” wird genutzt, um bekannte Angaben und Schreibweisen von vorne herein zu definieren. Wollen Sie lieber € oder EUR haben, ist m2 oder m² Ihre bevorzugte Schreibweise? Dies kann mittels Wörterbuch definiert werden. Weitere Details dazu finden Sie auf der Hilfeseite Mit Wörterbüchern arbeiten
Validierung der Zieldefinition
Onedot erstellt bei der Validierung der Zieldefinition zwei Berichte. Die darin aufgeführten Meldungen weisen auf mögliche Probleme in der Zieldefinition hin. Diese können beim Produktdatenonboarding zu Fehlern führen oder die Qualität der Resultate beinträchtigen.
Die Meldungen in den Validierungsreports sollen genutzt werden, um den Export der Zieldefinition entsprechend den Meldungen zu überarbeiten und zu verbessern.
Bericht validation-report-problems-in-target-files
Meldung in der Spalte “Problem” | Anpassung des Export? | Auswirkungen | |
---|---|---|---|
1 | There are LOV target attributes without any values in the LOV dataset 'lovs' | optional | Die Werte der betroffenen Zielattribute werden nicht normalisieren. |
2 | There are global target attributes in 'target-attributes' that are in 'attributes-per-category' | notwendig | Das PDM ist inkonsistent und kann nicht verwendet werden. |
3 | There are lov-id in the file 'lovs' which are not used for any target attributes | optional | Die betroffenen Wertelisten werden nicht verwendet. |
4 | Target Unit is set, but the attribute type is not 'Quantity'. Set it to 'Quantity' so that normalisations can take place | notwendig | Die Werte der betroffenen Zielattribute werden nicht oder nicht vollständig normalisieren. |
5 | `Keep zeros after decimal?` should be null for Number and Quantity having a null or 0 Rounding Policy | notwendig | Das PDM ist inkonsistent und kann nicht verwendet werden. |
6 | There are category-attributes with a wrong category-id (wrong = not in the category-tree) | optional | Die betroffenen Zielattribute werden nicht verwendet. |
7 | Target Unit should be added to Allowed Units | optional | Keine Auswirkung. Die Werte werden trotzdem normalisiert. |
8 | There are untrimmed values in the LOV dataset 'lovs' | optional | Für die betroffenen Werte kann die Qualität der Vorschläge reduziert sein. |
9 | There are attributes in the file 'attributes-per-category' which do not appear in target-attributes | optional | Die betroffenen Zielattribute werden nicht verwendet. |
10 | `Keep Unit?` should only be filled for attributes with type 'Quantity' | notwendig | Für die betroffenen Zielattribute kann die Qualität der Vorschläge reduziert sein. |
11 | Target Unit is not a valid unit recognized by the engine | optional | Die Werte der betroffenen Zielattribute werden nicht oder nicht vollständig normalisieren. |
Bericht debug-report-unknown-validation-patterns-in-target
Die Spalte key-validation-pattern
enthält ungültige Muster. Muster werden bei beim Schritt Normalisierung genutzt, um sicherzustellen, dass keine ungültigen Werte eingegeben werden können.
Bitte die Meldung in der Spalte Action required
beachten und den Export für die Zieldefinition entsprechend anpassen. Im Anschluss ist eine erneute Validierung notwendig.