Opzoektabellen
Hoe gebruik je lookup-tabellen
De Lookup Tables zijn een manier voor u om gegevens op te slaan die u vervolgens kunt gebruiken in Templates, Flows en Journeys. Maak uw Lookup Tables via het dashboard en verwijs vervolgens dynamisch naar gegevens in deze tabel.
Lookup Tables in Bird slaan gegevensreferenties op en centraliseren deze, die kunnen worden opgezocht bij het maken van e-mailtemplates met Liquid-template-taal in HTML.
Bijvoorbeeld de vlaggen, afkortingen of valuta van elk land kunnen centraal worden opgeslagen en bijgewerkt als een lookup table. Elke keer dat het wordt gebruikt bij het maken van een e-mail, kan het worden verwezen vanuit deze lookup table.
Belangrijke beperkingen:
Elke tabel kan tot 10 afzonderlijke gegevensitems opslaan.
Elk item mag maximaal ongeveer 300 kB aan gegevens bevatten.
Maak een Lookup Tabel
Gebruik Lookup Table in Email Template
Om een opzoektafel te gebruiken in een e-mailsjabloon, kunt u de volgende liquid-syntax toevoegen aan uw HTML-sjabloon of aan een HTML-element gebruikt in een drag-and-drop builder:
Hier,
variable_name is elke naam die u kunt definiëren
lookup-table-slug is de slug die u heeft gegeven bij het maken van de opzoektafel
item-name is de naam van het item dat u heeft gemaakt
object-value is de waarde die u voor het JSON-item heeft gegeven
key_name is de naam van de sleutel in het sleutel-waarde paar gedefinieerd onder item-waarde
Bijvoorbeeld,
Om de lokale valuta van een gedefinieerd land weer te geven, kunnen we de onderstaande syntax gebruiken
variable_name is hier gedefinieerd als currency (elke naam die de gebruiker kan definiëren)
lookup-table-slug is hier country-flags zoals gedefinieerd toen de opzoektafel werd gemaakt
item-name is de country zoals eerder gemaakt en weergegeven in het linker paneel
object-value is AD, dat de waarde is zoals gedefinieerd in de JSON. Merk op dat dit ook een variabele kan zijn
key_name is de local_currency, wat is gedefinieerd in de JSON
Wanneer gebruikt in de e-mailsjabloon builder in een HTML-blok, zal de bovenstaande syntax de waarde van de local_currency weergeven zoals opgeslagen onder het AD object onder het land-item in de opzoektafel country-flags
U kunt naar het voorbeeldgedeelte schakelen om de uitvoerwaarde dynamisch weergegeven in de e-mailsjabloon te zien. Hieronder wordt EUR getoond als de waarde die is opgehaald uit de opzoektafel.
Lookup-tabellen gebruiken in Flows
U kunt opzoektabellen in Flows lezen om centraal gedefinieerde gegevens opnieuw te gebruiken.
Om een opzoektafel te gebruiken, maakt u eerst een aan zoals hierboven beschreven.
Navigeer naar de Workflows > Flows
Maak een initiële flow met een trigger type naar uw keuze.
Voeg een nieuwe stap Perform Lookup toe aan uw flow. Klik op Add New Action en selecteer deze uit de groep Lookup Tables of zoek ernaar met behulp van de Zoekfunctionaliteit aan de rechterkant:
Er wordt een configuratiescherm getoond waar u de tabel kunt selecteren om uit te lezen en kunt configureren hoe u precies deze opzoekactie wilt uitvoeren:
U zult drie componenten zien die u kunt configureren:
Lookup Table Slug geeft aan welke tabel u wilt bekijken. Door op dit veld te klikken, toont Flows u de beschikbare opzoektabellen:
Lookup laat u bepalen wat u wilt ophalen en u kunt de verschillende beschikbare variabelen gebruiken om deze opzoeksleutel te construeren. De standaardoperatie is om de waarde waarnaar u zoekt terug te geven als de hoofdniveauwaarde, maar als u een gegevensobject wilt creëren - kunt u de mogelijkheid As gebruiken om het in een specifieke eigenschap te laden:
Replace laat u variabelen in een geretourneerd opzoekresultaat vervangen door ofwel een statische waarde of een waarde die ergens in uw opzoektafel is gedefinieerd. Het volgende voorbeeld zou de tekst
{{ MyVariableName }}in elk item dat wordt geretourneerd met de Lookup-actie vervangen door de waarde die het vindt onder sleutelreplacements.<locale>.MyVariableName:
Door vervolgens op de Test-knop te klikken, kunt u de resulterende gegevens zien:
Configureren welke tabel moet worden gelezen is vereist en u moet ten minste éénLookup-actie toevoegen. Het is niet verplicht om Replace-acties toe te voegen.
