Daten-Import und -Export

Der K3-Konfigurator bietet umfangreiche Import- und Export-Funktionen, mit denen Sie Ihre Konfiguratordaten effizient verwalten können. Diese Funktionen ermöglichen es Ihnen, Daten mit externen Systemen auszutauschen oder Massenupdates durchzuführen.

Voraussetzungen

• Sie haben einen Konfigurator angelegt
• Sie haben Admin-Berechtigungen für Ihren Konfigurator
• Für den Import benötigen Sie eine Excel-Datei im .xlsx oder .xls Format

Daten exportieren

Export-Optionen

Sie können verschiedene Datenbereiche exportieren:

• Artikel und Preise: Alle Artikel mit ihren Preisen und Preislisten
• Regeln: Spezifische Regeln mit ihren Bedingungen und Aktionen
• Merkmalswerte: Werte bestimmter Merkmale mit allen Attributen

tip

Beim Export werden automatisch eindeutige Schlüssel (Keys) für Regeln, Regelzeilen und Werte generiert, falls diese noch nicht vorhanden sind. Diese Keys basieren auf den Labels der Einträge und ermöglichen einen zuverlässigen Re-Import.

Export starten

1. Öffnen Sie Ihren Konfigurator im Editor
2. Wechseln Sie zu Artikel-, Regel- oder Merkmal-Wert-Ansicht, je nachdem, was Sie exportieren möchten (Sie können aber an jeder Stelle alles exportieren).
3. Klicken Sie auf das
   Loading...
   Symbol (Export-Button)
4. Im Dialog können Sie auswählen, welche Daten exportiert werden sollen

Export-Datei

Die exportierte Excel-Datei enthält verschiedene Tabellenblätter:

• Artikel-Preise: Eine Übersicht aller Artikel mit Preisen und Zuordnungen. Die Spalte Sortierung enthält die Reihenfolge aus der Artikelliste, die Spalte inUse? sagt mit "Ja"/"Nein", ob der Artikel im Konfigurator verwendet wird. inUse? dient nur der Information und wird beim Import nicht ausgewertet.
• Regel [Name]: Pro exportierter Regel ein eigenes Blatt mit allen Regelzeilen
• [Merkmal-Name]: Pro exportiertem Merkmal ein Blatt mit allen Werten und Attributen

Die Datei wird automatisch heruntergeladen und trägt einen Zeitstempel im Namen (z.B. app_mein-konfigurator_export_2025-11-21_14-30-00.xlsx).

Daten importieren

Import vorbereiten

1. Exportieren Sie zunächst Ihre aktuellen Daten als Vorlage
2. Bearbeiten Sie die Excel-Datei nach Ihren Wünschen
3. Achten Sie darauf, die Struktur der Datei beizubehalten

Wichtig:

• Ändern Sie nicht die Spaltennamen in der Kopfzeile
• Behalten Sie die Tabellenblatt-Namen bei
• Keys sollten eindeutig und stabil bleiben

Import durchführen

1. Klicken Sie auf das
   Loading...
   Symbol (Import-Button)
2. Wählen Sie Ihre bearbeitete Excel-Datei aus
3. Der Import erfolgt automatisch
4. Sie erhalten eine Bestätigung mit der Anzahl importierter Einträge

Import-Verhalten

Der Import funktioniert nach folgenden Prinzipien:

Artikel und Preise

• Artikel werden anhand ihrer Artikelnummer identifiziert
• Bestehende Artikel werden aktualisiert, neue werden angelegt
• Preise werden pro Preisliste und Artikel gespeichert

Regeln und Regelzeilen

• Regeln werden anhand ihres Schlüssels (Key) identifiziert
• Regelzeilen werden ebenfalls über ihren Key zugeordnet
• Wichtig: Nur die im Excel definierten Spalten werden aktualisiert
• Andere Aktionen und Werte in den Regelzeilen bleiben erhalten
• Neue Regelzeilen benötigen einen eindeutigen Key

Artikelaktionen in Regeln

Eine Regel kann mehrere Artikelaktionen enthalten, etwa wenn eine Auswahl gleichzeitig zwei Positionen in die Stückliste legt. Jede Artikelaktion bekommt im Regelblatt ihr eigenes Spaltentripel:

Aktion	Spalten
1. Artikelaktion	artikel_nummer, artikel_anzahl, artikel_menge
2. Artikelaktion	artikel_nummer_2, artikel_anzahl_2, artikel_menge_2
3. Artikelaktion	artikel_nummer_3, artikel_anzahl_3, artikel_menge_3

• Die erste Aktion behält die bisherigen Spaltennamen. Ältere Dateien lassen sich also unverändert weiter importieren.
• Die Zuordnung der Spalten zu den Aktionen steht zusätzlich in der ersten Zeile des Blattes. Lassen Sie diese Zeile unverändert, sonst geht die Zuordnung verloren und es zählt nur noch die Reihenfolge der Spalten.
• Die Überschriften artikel_... sind reserviert. Trägt ein Merkmal einen solchen Key, bricht der Export mit einer Meldung ab – geben Sie dem Merkmal dann einen anderen Key.

Merkmalswerte

• Werte werden über ihren Key identifiziert
• Fehlt der Key, wird das Label als Key verwendet
• Die Sortierung der Werte wird aus der Zeilenreihenfolge im Excel übernommen
• Alle Attribute (attrs) werden aktualisiert

Berechnungen in Regeln

Berechnungen verweisen intern über die interne Nummer eines Merkmals auf dieses. In der Excel-Datei stehen sie stattdessen mit dem Key des Merkmals:

varId(117838)   →   variable(articleTestNumber)

Damit sind die Berechnungen in Excel lesbar und änderbar.

• Ist der Key kein einfaches Wort (z.B. weil er Leerzeichen enthält), steht er in Anführungszeichen: variable('Breite in mm').
• Statt des Keys können Sie auch den angezeigten Namen des Merkmals verwenden.
• Beim Import wird die Referenz wieder aufgelöst. Findet sich zu einem Key oder Namen kein Merkmal, oder ist er mehrfach vergeben, bricht der Import mit einer Fehlermeldung ab – gespeichert würde sonst eine kaputte Berechnung.
• Ein Merkmalsname ohne variable(...) – also breite * 2 statt variable(breite) * 2 – ist ebenfalls ein Importfehler.
• Verweist eine Berechnung auf ein inzwischen gelöschtes Merkmal, bleibt beim Export die interne Nummer stehen. Der Export scheitert daran nicht.

Mehrsprachige Felder

• Es wird ausschliesslich die gerade eingestellte Inhaltssprache ex- und importiert. Namen und Beschreibungen kommen also in der Sprache in die Datei, die Sie im Editor unter Inhalte: DE eingestellt haben, und werden beim Import auch dorthin zurückgeschrieben.

Anwendungsfälle

Massenaktualisierung von Preisen

1. Exportieren Sie Artikel und Preise
2. Passen Sie die Preise in Excel an
3. Importieren Sie die Datei wieder

Regelwartung

1. Exportieren Sie eine oder mehrere Regeln
2. Bearbeiten Sie die Bedingungen und Aktionen in Excel
3. Importieren Sie die aktualisierten Regeln

Werte-Management

1. Exportieren Sie Merkmalswerte
2. Ergänzen oder ändern Sie Attribute
3. Importieren Sie die Werte mit korrekter Sortierung

Datenübertragung zwischen Systemen

• Nutzen Sie den Export, um Daten aus einem Konfigurator zu holen
• Passen Sie die Keys an das Zielsystem an
• Importieren Sie die Daten in einen anderen Konfigurator

Tipps und Best Practices

• Keys beibehalten: Ändern Sie Keys nur, wenn Sie wissen, was Sie tun
• Inkrementelle Updates: Bei großen Änderungen führen Sie mehrere kleinere Importe durch
• Validierung: Prüfen Sie nach dem Import, ob alle Daten korrekt übernommen wurden
• Versionierung: Nutzen Sie die Veröffentlichungs-Funktion, um Änderungen schrittweise freizugeben

Fehlerbehebung

Import schlägt fehl

• Prüfen Sie, ob die Datei im Excel-Format (.xlsx oder .xls) vorliegt
• Stellen Sie sicher, dass alle Pflichtfelder ausgefüllt sind
• Kontrollieren Sie, ob referenzierte Artikel, Merkmale oder Regeln existieren

Schlägt der Import fehl, nennt die Meldung die häufigsten Fehler mit der Anzahl der betroffenen Zeilen. Über

Loading...

öffnen Sie eine Übersicht, die pro Fehlerart das Tabellenblatt und die fehlerhaften Zeilen mit ihren Zeilennummern auflistet. Die Liste lässt sich vollständig aufklappen und in die Zwischenablage kopieren, sodass Sie die betroffenen Zeilen in Excel direkt anspringen können.

Keys werden nicht gefunden

• Achten Sie darauf, dass Keys bei Regeln und Werten korrekt sind
• Bei neuen Einträgen ohne Key wird automatisch das Label als Key verwendet
• Vermeiden Sie Duplikate bei Keys

Sortierung stimmt nicht

• Die Sortierung von Werten basiert auf der Reihenfolge im Excel
• Stellen Sie sicher, dass die gewünschte Reihenfolge in der Datei korrekt ist
• Die erste Datenzeile (nach der Kopfzeile) erhält Sort-Index 0

Technische Details

Datenformat

Die Excel-Dateien verwenden ein strukturiertes Format:

• Kopfzeile: Definiert die Spalten
• Datenzeilen: Eine Zeile pro Eintrag
• Tabellenblätter: Verschiedene Datentypen sind getrennt

Transaktionssicherheit

• Der Import erfolgt in einer Datenbank-Transaktion
• Bei Fehlern wird der gesamte Import rückgängig gemacht
• Ihre bestehenden Daten bleiben bei fehlerhaften Importen unverändert