Individuelle Tags via API in QONTROL

Diese Funktion erlaubt es dir, eigene Datenfelder, die über das data-Objekt via API an PAQATO übermittelt werden, in der QONTROL-Oberfläche nutzbar zu machen. Du kannst diese Felder als eigene Spalten einblenden, nach ihnen filtern und sie in der Auftrags- oder Sendungsübersicht sortieren.

Funktionsweise und Logik

Bisher war das data-Feld in der API eine Art „Sammelbecken“ für Zusatzinformationen. Durch die Konfiguration individueller Spalten weist du QONTROL an, bestimmte Schlüssel (Keys) aus diesem Datenpaket zu erkennen und sie als strukturierte Tabellenspalten darzustellen.

Beispiel:

Wenn du in der API den Wert "priority": "high" übermittelst, kannst du in QONTROL eine Spalte „Priorität“ anlegen, die genau diesen Wert ausliest.

Schritt-für-Schritt: Eine neue Spalte anlegen

• Gehe im Hauptmenü auf QONTROL > Einstellungen
• Wähle den Reiter Individuelle Spalten
• Entscheide dich für den Unterreiter Aufträge oder Sendungen, je nachdem, für welchen Bereich du das Feld benötigst
• Klicke auf den Button Neue Spalte für [Bereich] hinzufügen.
• Fülle die Eingabemaske wie folgt aus:
  • Erklärungen der Eingabefelder:
    Feldbezeichnung: Hier musst du den exakten technischen Namen (Key) eingeben, der in deinem API-Payload verwendet wird (z. B. erp_status oder supplier_name).
  • Spaltentitel (Deutsch/Englisch): Das ist die Bezeichnung, die oben im Tabellenkopf der Übersicht erscheint.
  • Beschreibung (Deutsch/Englisch): Dieser Text wird als Tooltip angezeigt, wenn du in der Übersicht mit der Maus über den Spaltennamen fährst. Nutze dies, um Kollegen zu erklären, was die Werte bedeuten.
  • Datentyp:
    • String: Für Textwerte (z. B. "Müller GmbH", "Projekt A")
    • Integer: Für ganze Zahlen (z. B. Prioritätsstufen 1, 2, 3)
    • Boolean: Für Ja/Nein-Werte (wird im System als Checkbox oder Text validiert)
  • Klicke auf Hinzufügen. Das Feld ist nun im System registriert.

Die Spalten in der Übersicht aktivieren

Nachdem du eine Spalte angelegt hast, ist sie technisch vorhanden, aber noch nicht automatisch in deiner Ansicht sichtbar.

• Navigiere zur Auftrags- oder Sendungsübersicht
• Klicke am rechten Rand auf das Spalten-Symbol (Listensymbol)
• Suche in der Liste nach deinem neu angelegten Spaltentitel (diese befinden sich meist am Ende der Liste)
• Aktiviere die Checkbox neben dem Namen. Die Spalte erscheint nun sofort in deiner Tabelle
• Du kannst die Spalte per Drag-and-Drop an die gewünschte Position ziehen

Filtern und Sortieren

Individuelle Spalten verhalten sich wie Standardfelder:

Sortierung: Klicke auf den Spaltentitel, um die gesamte Liste auf- oder absteigend nach deinen individuellen Werten (z. B. nach ABC-Kunden) zu sortieren.

Filterung: Klicke auf das Filter-Icon im Spaltenkopf. Je nach Datentyp (String, Integer, Boolean) öffnet sich eine passende Filtermaske. Du kannst dort gezielte Werte auswählen, um z. B. nur Sendungen eines bestimmten Lagers oder Projekts anzuzeigen.

Beispiele für die Praxis

Wichtige Hinweise

Detailansicht: Die konfigurierten Felder werden derzeit nur in der Tabelle, nicht auch automatisch in der jeweiligen Detailansicht des Auftrags oder der Sendung aufgeführt. Diese Ausbaustufe folgt.

Datenherkunft: Felder, die über die API kommen, sind von manuell in QONTROL angelegten Tags oder Bearbeitungsständen zu unterscheiden. Sie dienen der automatisierten Synchronisation deiner internen Daten mit QONTROL.

Punktnotation bei verschachtelten Objekten: Falls die Daten in deinem API-Payload nicht auf der obersten Ebene des data-Feldes liegen, sondern in einem verschachtelten Objekt (Nested Object) übermittelt werden, muss die Feldbezeichnung in der Konfiguration in QONTROL in Punktnotation angegeben werden.

Beispiel:
Dein API-Payload sieht wie folgt aus:

"data": {
   "erp_info": {
      "priority": "high"
   }
}

Um auf den Wert "high" zuzugreifen, musst du in der Spaltenkonfiguration als Feldbezeichnung erp_info.priority eingeben. Nur so kann QONTROL den Pfad durch die Datenstruktur korrekt auflösen.