CSV Metadata Mapping Item Transformation Service
Mindbreeze InSpire
Copyright ©
Mindbreeze GmbH, A-4020 Linz, 2023.
Alle Rechte vorbehalten. Alle verwendeten Hard- und Softwarenamen sind Handelsnamen und/oder Marken der jeweiligen Hersteller.
Diese Unterlagen sind streng vertraulich. Durch die Übermittlung und Präsentation dieser Unterlagen alleine werden keine Rechte an unserer Software, an unseren Dienstleistungen und Dienstleistungsresultaten oder sonstigen geschützten Rechten begründet. Die Weitergabe, Veröffentlichung oder Vervielfältigung ist nicht gestattet.
Aus Gründen der einfacheren Lesbarkeit wird auf die geschlechtsspezifische Differenzierung, z.B. Benutzer/-innen, verzichtet. Entsprechende Begriffe gelten im Sinne der Gleichbehandlung grundsätzlich für beide Geschlechter.
Einleitung
Mit dem CSV Metadata Mapping Item Transformation Service können Sie eine Zuordnung zwischen einem Set von erstellten Eigenschaften zu einem bestimmten Eigenschaftswert in einer CSV-Konfigurationsdatei definieren.
Konfiguration
Die Konfiguration des CSV Metadata Mapping Item Transformation Service kann mit den folgenden Schritten erfolgen:
Hinzufügen des Item Transformation Services zur Konfiguration
Konfigurieren der Eigenschaftszuordnungen und Erstellen der CSV-Dateien für die konfigurierten Zuordnungen
Aktivieren des Item Transformers für einen bestimmten Index
Erstellen des CSV-Metadaten-Mapping Item Transformation Service
Fügen Sie im Abschnitt "Service" des Konfigurations-Tabs "Indices" einen neuen Service vom Typ ItemTransformationServicePlugin.CSVMetadataMappingItemTransformer
Konfigurieren Sie den Service Bind-Port an einem freien (internen) Port Ihrer Mindbreeze InSpire Appliance. Der Standard-Port ist 6665.
Legen Sie die Anzahl der Threads zur Bearbeitung von Anfragen fest (Default ist 200).
Konfigurieren von Eigenschaftszuordnungen
Fügen Sie im Abschnitt "Property Mappings" der Konfiguration eine Eigenschaftszuordnung hinzu. Jedes Mapping hat ein konfigurierbares "Mapping CSV File Path"-Attribut, das auf eine CSV-Datei mit der Mapping-Definition verweist.
Die CSV-Dateien verwenden ";" als Trennzeichen und haben eine Titelzeile.
Eine Eigenschaftszuordnung hat die folgenden Attribute:
Source Property Name | Name der Eigenschaft, deren Werte dem zu erstellenden Set von Eigenschaften zugeordnet sind. |
Mapping CSV File Path | Pfad der CSV-Datei, die die Zuordnung der Eigenschaftswerte enthält. |
| Regulärer Ausdruck, der den CSV-Spaltennamen entspricht, die als erstellte Eigenschaften verwendet werden. |
List Position | Mögliche Werte: "first", "last", Position (Zahl). Wenn die Quelleigenschaft eine Liste ist, wählt sie den Wert für die Übereinstimmung aus den Werten der Quelleigenschaft wie folgt aus: - "first": der erste Wert wird aus der Liste ausgewählt - "last": der letzte Wert wird aus der Liste ausgewählt - Position: Element von dieser Position wird ausgewählt, falls verfügbar. Wenn die Auswahl nicht durchgeführt werden kann, wird standardmäßig der erste Wert aus einer Liste für die Zuordnung des Ausgangs-Eigenschaftswerts zu den erstellten Eigenschaften in der CSV-Datei verwendet. |
Hierarchy Property Name | Wenn konfiguriert, wird eine hierarchische Eigenschaft mit diesem Namen erstellt, die die übereinstimmenden CSV-Spalten als Elemente enthält. |
| Full: Wenn der Wert der Quell-Eigenschaft gleich einem Wert aus der ersten Spalte in der CSV-Zuordnungsdatei ist, werden die zugeordneten Eigenschaften zu diesem Wert hinzugefügt. Prefix: Wenn die CSV-Zuordnungsdatei einen Präfix des Quelleigenschaftswerts in der ersten Spalte enthält, werden die diesem Präfix zugeordneten Eigenschaften hinzugefügt. |
Beispiel
Mit dem CSV-Datei /data/resources/area.csv:
path;areaname
fabasoft-cloud;Fabasoft Cloud
Für ein Dokument mit der Eigenschaft "path" mit einer Liste von Werten: "en", "products", "fabasoft-cloud", wird die Eigenschaft "areaname" mit dem String-Wert "Fabasoft Cloud" erstellt.
Mit dem CSV-Datei /data/resources/area.csv:
path;areaname
fabasoft;Fabasoft
mit dem Abgleichstyp "Prefix", ein Dokument mit der Eigenschaft "Pfad" mit einer Liste von Werten: "en", "products", "fabasoft-cloud", die Eigenschaft "areaname" wird mit dem String-Wert "Fabasoft" erstellt.
Aktivieren des Item-Transformation Services für einen Index
Navigieren Sie in der Index-Service-Konfiguration zu den "Item Transformation Services".
Wählen Sie den Dienst aus der Dropdown-Liste aus und fügen Sie ihn zur Indexkonfiguration hinzu.
Die generierten Eigenschaften sollten auch als "Aggregated Metadata Keys" in die Konfiguration des Indexdienstes aufgenommen werden.