Einrichtung

Die Einrichtung des Plugins besteht aus zwei Bereichen: der Plugin-Konfiguration und der Synchronisationskonfiguration.

Plugin-Konfiguration

Es stehen folgende Konfigurationsmöglichkeiten zur Verfügung:

• Position automatisch übernehmen – Wenn diese Einstellung aktiviert ist, wird die Merkmals-Position automatisch beim Anlegen der Eigenschaften übernommen.
• Default Eigenschaften Gruppen ID – Jeder Eigenschaft muss einer Gruppe zugeordnet werden. Hier hinterlegst du die ID der Default Gruppe. Die Gruppe wird beim Anlegen der Eigenschaften automatisch zugeordnet. Diese Einstellung ist Pflicht.
• Präfix für neuer Eigenschaften-Namen – Hier hast Du die Möglichkeit, ein Namenspräfix zu hinterlegen. Das Präfix gilt dann für alle Eigenschaften, die über das Tool angelegt werden. Dadurch kann man diese Eigenschaften eindeutig als synchronisierte Eigenschaften identifizieren.
• Anzahl der gespeicherten Läufe – Jeder Lauf wird in der lokalen Tool-Datenbank gespeichert, um die Wiederherstellung alter Werte bei Bedarf zu ermöglichen. Hier kannst du festlegen, wie viele Läufe gespeichert werden sollen. Alles, was über die konfigurierte Anzahl hinausgeht, wird automatisch gelöscht.
  Bitte beachten: Je mehr Merkmale und Artikel vorhanden sind, desto größer ist der Speicherbedarf für einen Lauf. Überlege daher genau, wie viele Läufe tatsächlich sinnvoll sind.
  Tipp: Die lokale Datenbank befindet sich im Ordner „data„. Du kannst den Ordner überwachen, um den Speicherverbrauch besser im Blick zu behalten.
• Synchronisation-Typ – Du kannst hier festlegen, wie oft die Synchronisation automatisch erfolgen soll. Dazu stehen zwei Optionen zur Verfügung:
  1. Intervall – Die Synchronisation wird alle X-Minuten wiederholt.
  2. Täglich – Die Synchronisation wird einmal pro Tag ausgeführt.
• Synchronisationsintervall in Minuten – Dies gilt für den Synchronisations-Typ Intervall. Hier liegst du fest, nach wie vielen Minuten die Synchronisation wiederholt werden soll. Bitte beachte: Die Zählung beginnt erst nach Abschluss einer laufenden Synchronisation.
• Synchronisation starten, täglich um – Dies gilt für den Synchronisations-Typ „Täglich„. Hier kannst du festlegen, wann die Synchronisation täglich starten soll. Das erwartete Format ist HH:MM (Beispiel: 23:30).
• Synchronisation automatisch starten – Wenn diese Einstellung aktiviert ist, wird die Synchronisation automatisch beim Programmstart gestartet, unter Berücksichtigung der Konfiguration (Synchronisation-Typ). Diese Einstellung ermöglicht es, KJV-Tools automatisch im Hintergrund laufen zu lassen.
• Synchronisation ab Artikel-Änderungsdatum – Es werden nur die zuletzt geänderten Artikel synchronisiert. Hier kannst du das Änderungsdatum anpassen. Wenn du alle Artikel synchronisieren möchtest, lege dieses Datum möglichst weit in der Vergangenheit fest. Der Standardwert ist der 1. Januar 1970. Das Datum wird automatisch nach jedem Lauf aktualisiert.
• Anzahl Wiederholungen bei API-Fehlern – Es kann vorkommen, dass die Plenty-API Fehler ausgibt. Um sicherzustellen, dass die Synchronisation nicht gestört wird, lohnt es sich, den API-Aufruf mehrmals zu wiederholen. Hier kannst du die Anzahl der Wiederholungen festlegen. Wenn der Fehler auch nach den Wiederholungen auftritt, wird der Artikel ignoriert und gegebenenfalls eine E-Mail-Benachrichtigung verschickt. Zusätzlich werden alle Fehler in das Protokoll geschrieben. Der Standardwert beträgt 5 Wiederholungen, was sich als ausreichend bewährt hat.
• Fehlerbericht per Mail zusenden – Wenn diese Einstellung aktiviert ist, wird der Fehlerbericht per E-Mail verschickt. Die Voraussetzung dafür ist eine korrekte E-Mail-Konfiguration.

Synchronisation Konfiguration

Nachdem die Plugin-Konfiguration vollständig ist, muss nur noch die Synchronisationskonfiguration hinterlegt werden. In der Synchronisationskonfiguration bestimmst du, welche Merkmale mit bestehenden bzw. neuen Eigenschaften synchronisiert werden sollen. Öffne dazu den Tab „Konfiguration„:

Beim ersten Öffnen werden die Merkmale und Eigenschaften aus dem Plentysystem geladen. Je nach Anzahl der Daten kann dieser Vorgang mehrere Minuten dauern. Durch Klicken auf den Refresh-Button im Konfiguration-Tab wird das erneute Laden der Daten aus dem System ausgelöst.

Nun hast du die Möglichkeit, entweder die Merkmale mit bestehenden Eigenschaften zu verknüpfen oder neue Eigenschaften durch das Tool anlegen zu lassen und damit implizit zu verknüpfen.

Möglichkeit 1 – mit bestehenden Eigenschaften verknüpfen

Wähle ein Merkmal auf der linken Seite und dazu eine Eigenschaft auf der rechten Seite aus. Klicke dann auf „Zuweisen“. Das Tool merkt sich nun, welches Paar zusammengehört, und überträgt die Merkmale bei der Synchronisation auf die entsprechende Eigenschaft.
Bitte beachte die Typenbeschränkung. Folgende Typen können miteinander verknüpft werden:

Typ Merkmale	Typ Eigenschaften
selection	selection
empty	empty
int	int, float, string
float	float, string
text	text, string, html

Möglichkeit 2 – neue Eigenschaften anlegen

Wähle ein Merkmal auf der linken Seite aus und klicke dann rechts bei den Eigenschaften auf den Eintrag „Als neue Eigenschaft anlegen“. Passe gegebenenfalls die Namen an und klicke anschließend auf „Zuweisen„.

Wenn du eine Eigenschaft vom Typ „selection“ neu anlegst, werden automatisch alle Auswahloptionen übernommen. Du hast auch die Möglichkeit, die Namen und Beschreibungen der Auswahloptionen anzupassen. Bitte beachte: Nach dem Klicken auf „Zuweisen“ erfolgt nicht nur die Zuweisung im Tool, sondern die Eigenschaft wird sofort im Plentysystem angelegt.

Weitere Informationen

Für beide Konfigurationsmöglichkeiten gilt zusätzlich Folgendes:

• Ein Merkmal kann mehreren Eigenschaften zugeordnet werden, jedoch nicht umgekehrt.
• Das „Check – Ikon“ bedeutet, dass bereits eine Zuordnung existiert.
• Sobald ein Merkmal ausgewählt ist, werden nur die Eigenschaften angezeigt, die zugeordnet werden dürfen. Das bedeutet, dass bereits zugewiesene Eigenschaften sowie unzulässige Eigenschaften aufgrund der Typenbeschränkung ausgeblendet werden.
• Die Zuordnung kann entfernt werden, indem du das Merkmal und die Eigenschaft auswählst und auf den Button „Lösen“ klickst.
• Wenn eine Eigenschaft oder ein Merkmal im Plentysystem gelöscht wird, wird die Zuordnung im Tool beim nächsten Synchronisieren automatisch ebenfalls gelöscht.