Externe Datenquelle¶

Wir gehen davon aus, dass Sie bereits einen Blick auf Attribut-Typen geworfen haben, wo Sie eine Beschreibung der einzelnen Felder finden können.

Um dieses Beispiel zu reproduzieren, wählen Sie eine Kategorie, der Sie ein benutzerdefiniertes Feld hinzufügen möchten, klicken Sie auf Neues Attribut und wählen Sie Externe Daten-Feld unter Format.

In unserem Beispiel geht es darum, Daten aus einer externen Produktdatenbank abzurufen. Wir möchten unsere Produkte zu den Tickets hinzufügen, damit die Produkte gesucht und aus einer Liste ausgewählt werden können, und außerdem einen Link zur Produktwebsite erstellen.

Basis-Konfiguration¶

Erste Schritte zur Konfiguration des Objekttyps der externen Datenquelle

Beispiel:

Name: product
Display: Product

Konfiguration der externen Datenquelle¶

Geben Sie zunächst die Such-URL ein und vergewissern Sie sich, dass sie #{search.term} als Parameter enthält:

Beispiel: https://dummyjson.com/products/search?q=#{search.term}

Danach gehen Sie in den Vorschaubereich und geben einen Suchbegriff für die externe Datenquelle ein.

Beispiel: mac

Anschließend finden Sie eine Vorschau der Antwortdaten:

Vorschau der JSON-Antwort basierend auf dem Suchbegriff

Wir empfehlen, die Vorschau zu benutzen, um einen Blick auf die Struktur zu werfen. Es gibt ein Top-Level-Element namens products. Eine Ebene darunter finden Sie die Attribute id und title.

Suchergebnis-Antwort basierend auf der Suche aus dem Beispiel:

{
   "products": [
      {
         "id": 6,
         "title": "MacBook Pro",
         "description": "MacBook Pro 2021 with mini-LED display may launch between September, November",
         "price": 1749,
         "discountPercentage": 11.02,
         "rating": 4.57,
         "stock": 83,
         "brand": "Apple",
         "category": "laptops",
         "thumbnail": "https://i.dummyjson.com/data/products/6/thumbnail.png",
         "images": [
           "https://i.dummyjson.com/data/products/6/1.png",
           "https://i.dummyjson.com/data/products/6/2.jpg",
           "https://i.dummyjson.com/data/products/6/3.png",
           "https://i.dummyjson.com/data/products/6/4.jpg"
         ]
      },
      {
         "id": 22,
         "title": "Elbow Macaroni - 400 gm",
         "description": "Product details of Bake Parlor Big Elbow Macaroni - 400 gm",
         "price": 14,
         "discountPercentage": 15.58,
         "rating": 4.57,
         "stock": 146,
         "brand": "Bake Parlor Big",
         "category": "groceries",
         "thumbnail": "https://i.dummyjson.com/data/products/22/thumbnail.jpg",
         "images": [
           "https://i.dummyjson.com/data/products/22/1.jpg",
           "https://i.dummyjson.com/data/products/22/2.jpg",
           "https://i.dummyjson.com/data/products/22/3.jpg"
         ]
      },
      {
         "id": 26,
         "title": "Plant Hanger For Home",
         "description": "Boho Decor Plant Hanger For Home Wall Decoration Macrame Wall Hanging Shelf",
         "price": 41,
         "discountPercentage": 17.86,
         "rating": 4.08,
         "stock": 131,
         "brand": "Boho Decor",
         "category": "home-decoration",
         "thumbnail": "https://i.dummyjson.com/data/products/26/thumbnail.jpg",
         "images": [
           "https://i.dummyjson.com/data/products/26/1.jpg",
           "https://i.dummyjson.com/data/products/26/2.jpg",
           "https://i.dummyjson.com/data/products/26/3.jpg",
           "https://i.dummyjson.com/data/products/26/4.jpg",
           "https://i.dummyjson.com/data/products/26/5.jpg",
           "https://i.dummyjson.com/data/products/26/thumbnail.jpg"
         ]
      }
   ],
   "total": 3,
   "skip": 0,
   "limit": 3
}

Um dem entfernten System mitzuteilen, dass sich die gewünschten Daten unterhalb der Ebene products befinden, müssen Sie dies in das Feld Search result list key eintragen.

Nach dem Einfügen von products in das genannte Feld, erhalten Sie eine erweiterte Vorschau. Sie können ein zusätzliches Feld Search result list mit einer JSON-Struktur finden. Dies ist die gleiche Antwort wie zuvor, aber das obere Element products wurde von der externen Datenquelle entfernt.

Vorschau der Suchergebnisliste der JSON-Antwort

Nun müssen Sie die Schlüssel für die Werte und Bezeichnungen der Suchergebnisse angeben. Wie bereits erwähnt, suchen wir nach der id und dem title unserer Produkte. Wenn Sie es noch nicht getan haben, ist es jetzt ein guter Zeitpunkt, sich die Vorschau der Suchergebnisliste anzusehen.

[
   {
      "id": 6,
      "title": "MacBook Pro",
      "description": "MacBook Pro 2021 with mini-LED display may launch between September, November",
      "price": 1749,
      "discountPercentage": 11.02,
      "rating": 4.57,
      "stock": 83,
      "brand": "Apple",
      "category": "laptops",
      "thumbnail": "https://i.dummyjson.com/data/products/6/thumbnail.png",
      "images": [
        "https://i.dummyjson.com/data/products/6/1.png",
        "https://i.dummyjson.com/data/products/6/2.jpg",
        "https://i.dummyjson.com/data/products/6/3.png",
        "https://i.dummyjson.com/data/products/6/4.jpg"
      ]
   },
   {
      "id": 22,
      "title": "Elbow Macaroni - 400 gm",
      "description": "Product details of Bake Parlor Big Elbow Macaroni - 400 gm",
      "price": 14,
      "discountPercentage": 15.58,
      "rating": 4.57,
      "stock": 146,
      "brand": "Bake Parlor Big",
      "category": "groceries",
      "thumbnail": "https://i.dummyjson.com/data/products/22/thumbnail.jpg",
      "images": [
        "https://i.dummyjson.com/data/products/22/1.jpg",
        "https://i.dummyjson.com/data/products/22/2.jpg",
        "https://i.dummyjson.com/data/products/22/3.jpg"
      ]
   },
   {
      "id": 26,
      "title": "Plant Hanger For Home",
      "description": "Boho Decor Plant Hanger For Home Wall Decoration Macrame Wall Hanging Shelf",
      "price": 41,
      "discountPercentage": 17.86,
      "rating": 4.08,
      "stock": 131,
      "brand": "Boho Decor",
      "category": "home-decoration",
      "thumbnail": "https://i.dummyjson.com/data/products/26/thumbnail.jpg",
      "images": [
        "https://i.dummyjson.com/data/products/26/1.jpg",
        "https://i.dummyjson.com/data/products/26/2.jpg",
        "https://i.dummyjson.com/data/products/26/3.jpg",
        "https://i.dummyjson.com/data/products/26/4.jpg",
        "https://i.dummyjson.com/data/products/26/5.jpg",
        "https://i.dummyjson.com/data/products/26/thumbnail.jpg"
      ]
   }
]

Nachdem wir unsere beiden Schlüssel gefunden haben, fügen wir sie in Schlüssel Suchergebniswert (id) und in den Schlüssel Suchergebnisbezeichnung (title) ein.

Im Grunde haben wir die externe Datenquelle bereits konfiguriert, und wir können eine Tabelle im Vorschaubereich sehen:

Vorschau der Produkttabelle auf Basis des Suchbegriffs

Gemäß unserem Beispiel fehlt jetzt nur noch das Link-Template.

Bemerkung

Bitte beachten Sie, dass dies eine optionale Funktion ist. Wenn Sie solche Links nicht verwenden möchten, müssen Sie sie natürlich auch nicht konfigurieren.

Wir können nun eine Adresse hinzufügen, unter der zusätzliche Produktinformationen zu finden sind.

Beispiel: https://ihre_domain.com/q=#{ticket.product}

In diesem Beispiel bedeutet der Parameter:

#{}: „Rahmen“ für das Einfügen von Informationen

ticket: Objektebene, auf der Sie Ihr benutzerdefiniertes Objekt erstellen

product: Name des (benutzerdefinierten) Objekts

Nachdem Sie Ihr Link-Template konfiguriert haben, wird in der Vorschau eine weitere Spalte angezeigt. Wenn Sie mit der Maus über die Symbole in der Spalte Link fahren, sehen Sie, wohin der Link verweist.

In unserem Beispiel sieht einer der Links so aus: https://ihre_domain.com/q=6, wobei die 6 die Produkt-ID ist.

Weitere Informationen zur URL finden Sie in Attribut-Typen.