Bereik

Grow

Manage

Automate

Bereik

Grow

Manage

Automate

G

G

M

M

Opzoektabellen

Hoe gebruik je lookup-tabellen

Overzicht

Overzicht

Overzicht

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

Ga naar Content > Lookup Tables en klik op Create.

  • Voer een weergegeven naam in

  • Voer een slug in zonder spaties



De Slug wordt gebruikt om naar deze tabel te verwijzen en mag alleen alfanumerieke tekens bevatten. Merk op dat deze slug wordt gebruikt bij het verwijzen naar de e-mailsjabloon.

  • Klik op Save



Een item in een tabel maken

Klik op de tabel die je hebt gemaakt

Selecteer "View" in het contextmenu dat verschijnt



Elk item in een tabel is in wezen een JSON-document. Dit betekent dat je een boomstructuur van sleutels en waarden kunt opbouwen, waarbij de waarden tekst, nummers, booleans, arrays of objecten zelf kunnen zijn. Je kunt een JSON-document direct invoeren met behulp van JSON-syntaxis of je kunt een UI-editor gebruiken om het JSON-document te maken.

JSON Editor

  • Zodra je hebt opgeslagen, zie je een JSON-editor. Je kunt ofwel de Text of UI-editor kiezen op basis van je voorkeur.

  • Update de lookup-tabel met behulp van een JSON-structuur.

Een item toevoegen

Om een item in een JSON voor organisatie toe te voegen, klik op +Add Item in het linkerpaneel.

  • Typ een naam bovenaan

  • Klik op de Add Item-knop

  • Nadat het is aangemaakt, kun je het aangemaakte item in het linkerpaneel zien.

Schrijf de JSON

Gebruik het JSON-formaat om een objectstructuur en sleutel-waardeparen hieronder te definiëren:

Bijvoorbeeld een JSON die landnaam en lokale valuta geeft op basis van landafkorting

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Je kunt ook de UI-editor gebruiken om de JSON-structuur te definiëren.


Ga naar Content > Lookup Tables en klik op Create.

  • Voer een weergegeven naam in

  • Voer een slug in zonder spaties



De Slug wordt gebruikt om naar deze tabel te verwijzen en mag alleen alfanumerieke tekens bevatten. Merk op dat deze slug wordt gebruikt bij het verwijzen naar de e-mailsjabloon.

  • Klik op Save



Een item in een tabel maken

Klik op de tabel die je hebt gemaakt

Selecteer "View" in het contextmenu dat verschijnt



Elk item in een tabel is in wezen een JSON-document. Dit betekent dat je een boomstructuur van sleutels en waarden kunt opbouwen, waarbij de waarden tekst, nummers, booleans, arrays of objecten zelf kunnen zijn. Je kunt een JSON-document direct invoeren met behulp van JSON-syntaxis of je kunt een UI-editor gebruiken om het JSON-document te maken.

JSON Editor

  • Zodra je hebt opgeslagen, zie je een JSON-editor. Je kunt ofwel de Text of UI-editor kiezen op basis van je voorkeur.

  • Update de lookup-tabel met behulp van een JSON-structuur.

Een item toevoegen

Om een item in een JSON voor organisatie toe te voegen, klik op +Add Item in het linkerpaneel.

  • Typ een naam bovenaan

  • Klik op de Add Item-knop

  • Nadat het is aangemaakt, kun je het aangemaakte item in het linkerpaneel zien.

Schrijf de JSON

Gebruik het JSON-formaat om een objectstructuur en sleutel-waardeparen hieronder te definiëren:

Bijvoorbeeld een JSON die landnaam en lokale valuta geeft op basis van landafkorting

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Je kunt ook de UI-editor gebruiken om de JSON-structuur te definiëren.


Ga naar Content > Lookup Tables en klik op Create.

  • Voer een weergegeven naam in

  • Voer een slug in zonder spaties



De Slug wordt gebruikt om naar deze tabel te verwijzen en mag alleen alfanumerieke tekens bevatten. Merk op dat deze slug wordt gebruikt bij het verwijzen naar de e-mailsjabloon.

  • Klik op Save



Een item in een tabel maken

Klik op de tabel die je hebt gemaakt

Selecteer "View" in het contextmenu dat verschijnt



Elk item in een tabel is in wezen een JSON-document. Dit betekent dat je een boomstructuur van sleutels en waarden kunt opbouwen, waarbij de waarden tekst, nummers, booleans, arrays of objecten zelf kunnen zijn. Je kunt een JSON-document direct invoeren met behulp van JSON-syntaxis of je kunt een UI-editor gebruiken om het JSON-document te maken.

JSON Editor

  • Zodra je hebt opgeslagen, zie je een JSON-editor. Je kunt ofwel de Text of UI-editor kiezen op basis van je voorkeur.

  • Update de lookup-tabel met behulp van een JSON-structuur.

Een item toevoegen

Om een item in een JSON voor organisatie toe te voegen, klik op +Add Item in het linkerpaneel.

  • Typ een naam bovenaan

  • Klik op de Add Item-knop

  • Nadat het is aangemaakt, kun je het aangemaakte item in het linkerpaneel zien.

Schrijf de JSON

Gebruik het JSON-formaat om een objectstructuur en sleutel-waardeparen hieronder te definiëren:

Bijvoorbeeld een JSON die landnaam en lokale valuta geeft op basis van landafkorting

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Je kunt ook de UI-editor gebruiken om de JSON-structuur te definiëren.


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:

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

{{variable_name.key_name}}

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

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

{{currency.local_currency}}

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.

  1. Navigeer naar de Workflows > Flows

  2. 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:

  1. Lookup Table Slug geeft aan welke tabel u wilt bekijken. Door op dit veld te klikken, toont Flows u de beschikbare opzoektabellen:

  1. 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:

  1. 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 sleutel replacements.<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.


Laten we je in contact brengen met een Bird-expert.
Bekijk de volledige kracht van de Bird in 30 minuten.

Door te verzenden, ga je ermee akkoord dat Bird contact met je mag opnemen over onze producten en diensten.

U kunt zich op elk moment afmelden. Zie Bird's Privacyverklaring voor details over gegevensverwerking.

Nieuwsbrief

Blijf op de hoogte met Bird via wekelijkse updates in je inbox.

Laten we je in contact brengen met een Bird-expert.
Bekijk de volledige kracht van de Bird in 30 minuten.

Door te verzenden, ga je ermee akkoord dat Bird contact met je mag opnemen over onze producten en diensten.

U kunt zich op elk moment afmelden. Zie Bird's Privacyverklaring voor details over gegevensverwerking.

Nieuwsbrief

Blijf op de hoogte met Bird via wekelijkse updates in je inbox.

Laten we je in contact brengen met een Bird-expert.
Bekijk de volledige kracht van de Bird in 30 minuten.

Door te verzenden, ga je ermee akkoord dat Bird contact met je mag opnemen over onze producten en diensten.

U kunt zich op elk moment afmelden. Zie Bird's Privacyverklaring voor details over gegevensverwerking.

R

Bereik

G

Grow

M

Manage

A

Automate

Nieuwsbrief

Blijf op de hoogte met Bird via wekelijkse updates in je inbox.