Schlüssel-Wert-Paare
Schlüssel-Wert-Paare sind ein wichtiger Bestandteil von FrachtPilot und ermöglichen es dir, individuelle Felder anzulegen. Dadurch hast du die maximale Kontrolle und kannst Daten erfassen, die in der aktuellen Datenstruktur von FrachtPilot kein eigenes Eingabefeld haben.
Schlüssel-Wert-Paare kürzen wir technisch mit "KVP" ab (engl.: "Key-Value-Pair").
Mit der Funktion Schlüssel-Wert-Paare geben wir dir und allen anderen Nutzer*innen von FrachtPilot die Möglichkeit, durch kreative Lösungswege für individuelle Anforderungen zu finden.
Funktionsweise
Schlüssel-Wert-Paare werden zum einen zur Konfiguration verschiedener Funktionen verwendet (Wiegekassen-Setup, Stücklistenauflösung, QR-Code-Rechnungen). Zum anderen eignen sich Schlüssel-Wert-Paare zur Anpassung verschiedenster Dokumente. Zur Erläuterung ein Beispiel:
Es gibt eine Vereinbarung mit einigen Kunden, dass sie immer das längste MHD-Datum geliefert kriegen. Die Kommissionierung läuft per Packliste.
- Du setzt Kundenprofilen den Schlüssel NOTIZ_PACKLISTE mit dem Wert "Längstes MHD nehmen"
- In der Packlistenvorlage setzt du den Schlüssel $NOTIZ_PACKLISTE$ in einer größeren Schrift.
Ergebnis: Auf Packlisten für Kunden mit Schlüssel-Wert-Paar NOTIZ_PACKLISTE erscheint eine groß geschriebene Notiz.
Viele Probleme lassen sich mit Schlüssel-Wert-Paaren kreativ lösen. Wenn Sie eine Anpassung von Informationen auf FrachtPilot-Dokumenten wünschen, können Schlüssel-Wert-Paare für verschiedenste Zwecke eingesetzt werden.
- Dokumente Wiedergabe von Text oder anderen Informationen
- Objekte
Wir geben zu: Das Thema kann etwas technische Affinität voraussetzen. Die Funktionsweise ist dabei aber so simpel wie der Name es schon sagt.
Der Name ist Programm
Wenn du ein Schlüssel-Wert-Paar setzt, wird eine Information in FrachtPilot gespeichert. Enthält ein Dokument den entsprechenden Schlüssel, wird der gesetzte Wert automatisch wiedergegeben.
In deinem Firmenprofil wird er groß und deutlich dargestellt. Auf Lieferscheinen und Rechnungen erscheint er ebenfalls standardmäßig: Dein Firmenname erscheint in jedem Dokument, das den Schlüssel $MY_NAME$ referenziert.
MY_NAME ist natürlich ein fest definierter Schlüssel, der von FrachtPilot bereits vorgegeben ist.
Konfiguration
Bei der Verwendung von Schlüssel-Wert-Paaren unterscheiden wir prinzipiell zwischen Anlegen und Referenzieren.
Anlegen von Schlüssel-Wert-Paaren
KVPs können bei der
Bearbeitung folgender Objekte vergeben werden:- Firmenprofil
- Kunden
- Kundengruppen
- Produkte
- Produktgruppen
- Lieferanten
In FrachtPilot sieht folgendermaßen aus:
Regeln für das Anlegen von Schlüssel-Wert-Paaren
- Keine Leerzeichen zwischen Wörtern
- Begriffe mit Unterstrich- oder Bindestrich trennen
INFO HALTUNGSFORMINFO_HALTUNGSFORM - Immer in GROSSBUCHSTABEN
Referenzieren von Schlüssel-Wert-Paaren
Schlüssel-Wert-Paare werden in Vorlagen referenziert. Die allgemeingültigen Vorlagen findest du in den Firmeneinstellungen.
An verschiedenen Stellen lassen sich abweichende Vorlagen erstellen. Hier findest du mehr Informationen darüber.
Regeln für die Referenzierung von Schlüssel-Wert-Paaren
- Immer in GROSSBUCHSTABEN
- Am Anfang und Ende steht immer ein $
- Keine Leerzeichen vor oder nach den Dollarzeichen
$ SCHLÜSSEL $$SCHLÜSSEL$
Beispiele für Use-Cases
Schlüssel-Wert-Paare können an folgenden Stellen über den Button
gesetzt werden.Firmenprofil editieren
Im Firmenprofil können prinzipiell Schlüssel-Wert-Paare gesetzt werden, die mit Firmeninformationen zusammenhängen. Wenn dein ganzer Betrieb beispielsweise Bio-Zertifiziert ist, kannst du hier den Schlüssel BIO-ZERTIFIKAT setzen und als Wert deine Nummer "Bio-123456z" angeben.
Produkte
Am häufigsten werden Schlüssel-Wert-Paare für Produkte verwendet. Hier eine kleine Liste:
- KAT-Zertifizierung für Eier
- Erzeugercodes
- Externe Referenznummern wie die Artikelnummer bei Lieferant XYZ
- Konfiguration für Wiegekassen Hier findest du mehr Informationen dazu
Kundenkonto
- Qualitätssiegel-Zertifizierungsnummer
- Individuelle Anweisungen für Kommissionierung / Auslieferung / Rechnungsstellung
Produktgruppen und Kundengruppen
Den Zweck von Schlüssel-Wert-Paare in Produkt- und Kundengruppen erklären wir kurz anhand folgenden Beispiels:
Der Kundengruppe "Supermarkt" sind insgesamt 50 Kunden zugeordnet. Die Vorschriften zur Kommissionierung sind identisch und sollen auf allen Packlisten erscheinen. Anstatt das Schlüssel-Wert-Paar "KOMMISSIONIERUNGSVORSCHRIFTEN" in jedem der 50 Kundenprofile einzeln zu setzen, kannst du es einfach in der Kundengruppe setzen. Besonders unter dem Gesichtspunkt, dass zukünftig jede kleinste Änderung der Vorschriften in 50 einzelnen Profilen geändert werden müsste, wird die Handhabung per Gruppe viel einfacher.
Merke: Wenn identische Informationen oder Daten für viele verschiedene Kunden oder Produkte gültig sind, setzt du das Schlüssel-Wert-Paar direkt in der Kunden- oder Produktgruppe.
Lieferanten
- Neue Informationen, die in den normalen Lieferantenprofilen nicht angegeben werden können
Import und Export von Schlüssel-Wert-Paaren
Natürlich gibt es für Schlüssel-Wert-Paare auch eine Export- und Importfunktion. So können Daten und Strukturen richtig vorbereitet und einfach hochgeladen werden. Das ergibt vor allem dann viel Sinn, wenn du hunderte Kunden- und Produktdaten durch KVPs ergänzen möchtest.
Schlüssel-Wert-Paare bei der Ersteinrichtung von FrachtPilot anlegen
Wenn während der Testphase bereits der Eindruck entsteht, dass gewisse Informationen schon von vornherein als Schlüssel-Wert-Paare importiert werden sollen, können diese Problemlos in der Import-Excel als neue Spalte eigentragen werden. Wichtig: die Spalte muss den Präfix KVP_ und der Rest muss auch groß geschrieben sein und darf keine Leerzeichen enthalten.
Import und Export durch benutzerdefinierte Formulare
Wir können dir alle bestehenden Schlüssel-Wert-Paare exportieren und nach deiner Bearbeitung wieder importieren. Hier besteht auch die Möglichkeit, dass wir diese Funktion auch für dich freischalten. Melde dich einfach bei uns und frag nach.