G

G

M

M

Tabelle di Ricerca

Come utilizzare le tabelle di ricerca

Panoramica

Panoramica

Panoramica

Le tabelle di ricerca sono un modo per memorizzare dati che puoi poi utilizzare in modelli, flussi e percorsi. Crea le tue tabelle di ricerca attraverso la dashboard e quindi fai riferimento ai dati in queste tabelle in modo dinamico.

Le tabelle di ricerca in Bird memorizzano e centralizzano i riferimenti ai dati, che possono essere consultati durante la creazione di modelli email utilizzando il linguaggio di templating Liquid in HTML.

Ad esempio, le bandiere, le abbreviazioni o le valute di ogni paese possono essere memorizzate e aggiornate centralmente come tabella di ricerca. Ogni volta che viene utilizzata per costruire un'email, può essere riferita da questa tabella di ricerca.

Limitazioni importanti:

  • Ogni tabella può avere fino a 10 articoli di dati separati memorizzati in essa.

  • Ogni articolo può contenere fino a circa 300kB di dati.

Crea una tabella di ricerca

Vai su Contenuto > Tabelle di ricerca e clicca su Crea.

  • Inserisci un nome di visualizzazione

  • Inserisci uno slug senza spazi



Lo Slug è utilizzato per fare riferimento a questa tabella e può contenere solo caratteri alfanumerici. Nota che questo slug viene utilizzato per riferirsi al modello di email

  • Clicca su Salva



Creazione di un elemento in una tabella

Clicca sulla tabella che hai creato

Dal menu contestuale che appare, seleziona "Visualizza"



Ogni elemento in una tabella è essenzialmente un documento JSON. Questo significa che puoi costruire una struttura ad albero di chiavi e valori, dove i valori possono essere testo, numeri, booleani, array o oggetti stessi. Puoi inserire direttamente un documento JSON, utilizzando la sintassi JSON oppure puoi utilizzare un editor UI per costruire il documento JSON.

Editor JSON

  • Una volta salvato, vedrai un editor JSON. Puoi selezionare l'editor Testo o UI in base alle tue preferenze.

  • Aggiorna la tabella di ricerca utilizzando una struttura JSON.

Aggiungere un elemento

Per aggiungere un elemento in un JSON per l'organizzazione, clicca su +Aggiungi elemento nel pannello a sinistra.

  • Digita un nome in alto

  • Clicca sul pulsante Aggiungi elemento

  • Una volta creato, puoi vedere l'elemento creato nel pannello a sinistra.

Scrivere il JSON

Utilizza il formato JSON per definire qualsiasi struttura di oggetto e coppie chiave-valore di seguito:

Ad esempio, un JSON che fornisce il nome del paese e la valuta locale in base all'abbreviazione del paese

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Puoi anche utilizzare l'editor UI per definire la struttura JSON.


Vai su Contenuto > Tabelle di ricerca e clicca su Crea.

  • Inserisci un nome di visualizzazione

  • Inserisci uno slug senza spazi



Lo Slug è utilizzato per fare riferimento a questa tabella e può contenere solo caratteri alfanumerici. Nota che questo slug viene utilizzato per riferirsi al modello di email

  • Clicca su Salva



Creazione di un elemento in una tabella

Clicca sulla tabella che hai creato

Dal menu contestuale che appare, seleziona "Visualizza"



Ogni elemento in una tabella è essenzialmente un documento JSON. Questo significa che puoi costruire una struttura ad albero di chiavi e valori, dove i valori possono essere testo, numeri, booleani, array o oggetti stessi. Puoi inserire direttamente un documento JSON, utilizzando la sintassi JSON oppure puoi utilizzare un editor UI per costruire il documento JSON.

Editor JSON

  • Una volta salvato, vedrai un editor JSON. Puoi selezionare l'editor Testo o UI in base alle tue preferenze.

  • Aggiorna la tabella di ricerca utilizzando una struttura JSON.

Aggiungere un elemento

Per aggiungere un elemento in un JSON per l'organizzazione, clicca su +Aggiungi elemento nel pannello a sinistra.

  • Digita un nome in alto

  • Clicca sul pulsante Aggiungi elemento

  • Una volta creato, puoi vedere l'elemento creato nel pannello a sinistra.

Scrivere il JSON

Utilizza il formato JSON per definire qualsiasi struttura di oggetto e coppie chiave-valore di seguito:

Ad esempio, un JSON che fornisce il nome del paese e la valuta locale in base all'abbreviazione del paese

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Puoi anche utilizzare l'editor UI per definire la struttura JSON.


Vai su Contenuto > Tabelle di ricerca e clicca su Crea.

  • Inserisci un nome di visualizzazione

  • Inserisci uno slug senza spazi



Lo Slug è utilizzato per fare riferimento a questa tabella e può contenere solo caratteri alfanumerici. Nota che questo slug viene utilizzato per riferirsi al modello di email

  • Clicca su Salva



Creazione di un elemento in una tabella

Clicca sulla tabella che hai creato

Dal menu contestuale che appare, seleziona "Visualizza"



Ogni elemento in una tabella è essenzialmente un documento JSON. Questo significa che puoi costruire una struttura ad albero di chiavi e valori, dove i valori possono essere testo, numeri, booleani, array o oggetti stessi. Puoi inserire direttamente un documento JSON, utilizzando la sintassi JSON oppure puoi utilizzare un editor UI per costruire il documento JSON.

Editor JSON

  • Una volta salvato, vedrai un editor JSON. Puoi selezionare l'editor Testo o UI in base alle tue preferenze.

  • Aggiorna la tabella di ricerca utilizzando una struttura JSON.

Aggiungere un elemento

Per aggiungere un elemento in un JSON per l'organizzazione, clicca su +Aggiungi elemento nel pannello a sinistra.

  • Digita un nome in alto

  • Clicca sul pulsante Aggiungi elemento

  • Una volta creato, puoi vedere l'elemento creato nel pannello a sinistra.

Scrivere il JSON

Utilizza il formato JSON per definire qualsiasi struttura di oggetto e coppie chiave-valore di seguito:

Ad esempio, un JSON che fornisce il nome del paese e la valuta locale in base all'abbreviazione del paese

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Puoi anche utilizzare l'editor UI per definire la struttura JSON.


Usa la tabella di ricerca nel modello di email


Per utilizzare una tabella di ricerca in un modello di email, puoi aggiungere la seguente sintassi liquid al tuo modello HTML o a un elemento HTML utilizzato in un builder drag-and-drop:

{% assign variable_name = "lookup-table-slug" | lookup: "item-name", "object-value" %}

{{variable_name.key_name}}

Qui,

  • nome_variabile è qualsiasi nome tu possa definire

  • slug-tabella-ricerca è lo slug che hai fornito quando hai creato la tabella di ricerca

  • nome-elemento è il nome dell'elemento che hai creato

  • valore-oggetto è il valore che hai dato per l'elemento JSON

  • nome_chiave è il nome della chiave nella coppia chiave-valore definita sotto valore-elemento

Per esempio,

Per rendere la valuta locale di un paese definito, possiamo usare la sintassi sottostante

  • nome_variabile qui è definito come valuta (qualsiasi nome che l'utente possa definire)

  • slug-tabella-ricerca qui è bandiere-paese come definito quando è stata creata la tabella di ricerca

  • nome-elemento è il paese come creato in precedenza e mostrato nel pannello di sinistra

  • valore-oggetto è AD, che è il valore definito nel JSON. Nota che questo può anche essere una variabile

  • nome_chiave è la valuta_locale, che è definita nel JSON

{% assign currency = "country-flags" | lookup: "country", "AD" %}

{{currency.local_currency}}

Quando utilizzato nel builder di modelli email in un blocco HTML, la sintassi sopra renderà il valore della valuta_locale come memorizzato sotto l'oggetto AD sotto l'elemento paese nella tabella di ricerca bandiere-paese

Puoi passare alla sezione di anteprima per vedere il valore di output visualizzato dinamicamente nel modello email. Sotto, mostra EUR come il valore prelevato dalla tabella di ricerca.

Utilizzare tabelle di ricerca nei Flussi

Puoi leggere le tabelle di ricerca nei Flows per riutilizzare i dati definiti centralmente.

Per utilizzare una tabella di ricerca, prima creane una come descritto sopra.

  1. Naviga su Workflows > Flows

  2. Crea un flusso iniziale utilizzando un tipo di attivazione a tua scelta.

Aggiungi un nuovo Esegui Ricerca passo al tuo flusso. Fai clic su Aggiungi Nuova Azione e selezionalo dal gruppo Tabelle di Ricerca o cercalo utilizzando la funzionalità di ricerca a destra:



Ti verrà mostrata una schermata di configurazione in cui puoi selezionare la tabella da cui leggere e configurare esattamente come vuoi eseguire questa ricerca:



Vedrai tre componenti che puoi configurare:

  1. Slug Tabella di Ricerca indica quale tabella vuoi esaminare. Facendo clic in questo campo, Flows ti mostrerà le tabelle di ricerca disponibili:

  1. Ricerca ti consente di determinare cosa recuperare e puoi utilizzare le varie variabili disponibili per te per costruire questa chiave di ricerca. L'operazione predefinita è restituire il valore a cui punta la tua ricerca come valore di livello radice, ma se vuoi creare un oggetto di dati, puoi utilizzare la funzionalità Come per caricarlo in una proprietà specifica:

  1. Sostituisci ti consente di sostituire variabili nei risultati di ricerca restituiti con un valore statico o un valore definito da qualche parte nella tua tabella di ricerca. Il seguente esempio sostituirebbe il testo {{ MyVariableName }} in qualsiasi elemento restituito con l'azione di Ricerca con il valore trovato sotto la chiave replacements.<locale>.MyVariableName:

Cliccando poi sul pulsante di Test potrai vedere i dati risultanti:


Configurare quale tabella leggere è necessario e devi aggiungere almeno un'azione Ricerca. Non sei obbligato ad aggiungere alcuna azione Sostituisci.


A person is standing at a desk while typing on a laptop.

La piattaforma completa nativa dell'IA che si espande con la tua azienda.

Contatta le vendite

Inizia gratis

© 2025 Uccello

Contatta il supporto

A person is standing at a desk while typing on a laptop.

La piattaforma completa nativa dell'IA che si espande con la tua azienda.

Contatta le vendite

Inizia gratis

© 2025 Uccello

Contatta il supporto

A person is standing at a desk while typing on a laptop.

La piattaforma completa nativa dell'IA che si espande con la tua azienda.

Contatta le vendite

Inizia gratis

© 2025 Uccello

Contatta il supporto