Origine dati esterna¶
Presumiamo che tu abbia già dato un’occhiata a tipi dove puoi trovare una descrizione dei singoli campi.
Per riprodurre questo esempio, scegli un tipo di oggetto a cui vuoi aggiungere un campo personalizzato, fai clic su Nuovo Attributo e seleziona Campo origine dati esterna sotto Formato.
Il nostro esempio riguarda il recupero di dati da un database di prodotti esterno. Vogliamo aggiungere i nostri prodotti ai ticket in modo che i prodotti possano essere cercati e scelti da un elenco e creare anche un collegamento al sito web del prodotto.
Configurazione origine dati esterna¶
Innanzitutto, inserisci l’URL di ricerca assicurandoti che contenga #{search.term} come parametro:
Esempio: https://dummyjson.com/products/search?q=#{search.term}
Dopodiché, scorri fino alla sezione di anteprima e inserisci un termine di ricerca per l’origine dati esterna.
Esempio: mac
Quindi puoi trovare un’anteprima dei dati di risposta qui sotto:
Consigliamo di utilizzare l’anteprima per esaminare la struttura. C’è un elemento di primo livello chiamato products. Un livello sotto, puoi trovare gli attributi id e title.
Risposta del risultato di ricerca basata sulla ricerca dall’esempio:
{
"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
}
Per indicare al sistema remoto che i dati desiderati si trovano sotto il livello products, devi inserirli nel campo Chiave elenco risultati di ricerca.
Dopo aver inserito products nel campo menzionato, otterrai un’anteprima estesa. Troverai una casella aggiuntiva Elenco risultati di ricerca con una struttura JSON. Questa è la stessa risposta di prima ma privata dell’elemento superiore products dall’origine dati esterna.
Ora devi fornire le chiavi per i valori e le etichette dei risultati di ricerca. Come già accennato, stiamo cercando l”id e il title dei nostri prodotti. Se non l’hai ancora fatto, è un buon momento per guardare l’anteprima dell”Elenco risultati di ricerca.
[
{
"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"
]
}
]
Dopo aver individuato le nostre due chiavi, le inseriamo in chiave valore risultato di ricerca (id) e in chiave etichetta risultato di ricerca (title).
Fondamentalmente, abbiamo già configurato l’origine dati esterna e possiamo vedere una tabella nella sezione di anteprima:
Secondo il nostro caso d’uso di esempio, manca solo il Modello di collegamento.
Nota
Si prega di notare che questa è una funzionalità opzionale. Se non si desidera utilizzare tali collegamenti, ovviamente non è necessario configurarli.
Possiamo aggiungere un indirizzo dove trovare ulteriori informazioni sul prodotto.
Esempio: https://tuo_dominio.com/q=#{ticket.product}
Nell’esempio, il parametro significa:
#{}: «Frame» per l’inserimento di informazioni
ticket: livello oggetto, dove crei il tuo oggetto personalizzato
prodotto: nome dell’oggetto (personalizzato)
Dopo aver configurato il tuo Modello di collegamento, ci sarà un’altra colonna nell’anteprima. Passando il mouse sopra le icone nella colonna Collegamento ti mostrerà dove ti reindirizza.
Nel nostro esempio, uno dei collegamenti appare così: https://tuo_dominio.com/q=6, dove il 6 è l’ID del prodotto.
Puoi trovare maggiori informazioni sull’URL in tipi.