Tabele wyszukiwania
Jak korzystać z tabel wyszukiwania
Tabele wyszukiwania są sposobem na przechowywanie danych, które można następnie wykorzystać w Szablonach, Przepływach i Podróżach. Twórz swoje Tabele wyszukiwania za pośrednictwem panelu sterowania, a następnie dynamicznie odwołuj się do danych w tych tabelach.
Tabele wyszukiwania w Bird przechowują i centralizują odniesienia do danych, które można wyszukać podczas tworzenia szablonów e-maili przy użyciu języka szablonowego Liquid w HTML.
Na przykład, flagi każdego kraju, skróty lub waluty mogą być przechowywane i aktualizowane centralnie jako tabela wyszukiwania. Za każdym razem, gdy jest używana do tworzenia e-maila, można się do niej odwołać z tej tabeli wyszukiwania.
Ważne ograniczenia:
Każda tabela może przechowywać do 10 oddzielnych elementów danych.
Każdy element może zawierać do około 300kB danych.
Utwórz Lookup Table
Użyj Tabeli Lookup w Szablonie Email
Aby użyć tabeli wyszukiwania w szablonie e-mail, możesz dodać następującą składnię liquid do swojego szablonu HTML lub do elementu HTML używanego w kreatorze przeciągnij i upuść:
Tutaj,
variable_name jest dowolną nazwą, którą możesz zdefiniować
lookup-table-slug to identyfikator nadany podczas tworzenia tabeli wyszukiwania
item-name to nazwa elementu, który stworzyłeś
object-value to wartość, którą nadałeś dla elementu JSON
key_name to nazwa klucza w parze klucz-wartość zdefiniowanej pod item-value
Na przykład,
Aby wyrenderować lokalną walutę zdefiniowanego kraju, możemy użyć poniższej składni
variable_name tutaj jest zdefiniowane jako currency (dowolna nazwa, którą użytkownik może zdefiniować)
lookup-table-slug tutaj to country-flags zgodnie z definicją podczas tworzenia tabeli wyszukiwania
item-name to country stworzony wcześniej i pokazany w lewym panelu
object-value to AD, które jest wartością zdefiniowaną w JSON. Zauważ, że to może także być zmienna
key_name to local_currency, które jest zdefiniowane w JSON
Kiedy używane w kreatorze szablonów e-mail w bloku HTML, powyższa składnia wyrenderuje wartość local_currency jak przechowywana pod obiektem AD pod elementem country w tabeli wyszukiwania country-flags
Możesz przełączyć się na sekcję podglądu, aby zobaczyć dynamicznie wyświetlaną wartość w szablonie e-mail. Poniżej pokazuje wartość EUR pobraną z tabeli wyszukiwania.
Używanie tabel wyszukiwania w Flows
Możesz odczytywać tabele wyszukiwania w Flows, aby ponownie użyć centralnie zdefiniowanych danych.
Aby użyć tabeli wyszukiwania, najpierw utwórz ją, jak opisano powyżej.
Przejdź do Workflows > Flows
Utwórz początkowy przepływ, używając wybranego przez siebie typu wyzwalacza.
Dodaj nowy krok Perform Lookup do swojego przepływu. Kliknij Add New Action i wybierz go z grupy Lookup Tables lub wyszukaj go za pomocą funkcji wyszukiwania po prawej stronie:
Zobaczysz ekran konfiguracji, na którym możesz wybrać tabelę do odczytu i skonfigurować, jak dokładnie chcesz wykonać to wyszukiwanie:
Zobaczysz trzy komponenty, które możesz skonfigurować:
Lookup Table Slug wskazuje, którą tabelę chcesz przejrzeć. Klikając w to pole, Flows pokaże dostępne tabele wyszukiwania:
Lookup pozwala określić, co odzyskać i możesz używać różnych dostępnych zmiennych do skonstruowania tego klucza wyszukiwania. Domyślną operacją jest zwrócenie wartości, do której odnosi się Twoje wyszukiwanie, jako wartości na poziomie głównym, ale jeśli chcesz stworzyć obiekt danych - możesz skorzystać z funkcji As, aby załadować go do konkretnej właściwości:
Replace pozwala zastąpić zmienne w zwróconych wynikach wyszukiwania wartością statyczną lub wartością zdefiniowaną w tabeli wyszukiwania. Następujący przykład zastąpi tekst
{{ MyVariableName }}w każdym elemencie zwróconym za pomocą akcji Lookup wartością, którą znajdzie pod kluczemreplacements.<locale>.MyVariableName:
Po kliknięciu przycisku Test zobaczysz dane wynikowe:
Konfigurowanie, którą tabelę odczytać, jest wymagane i musisz dodać co najmniej jedną akcję Lookup. Nie musisz dodawać żadnych akcji Replace.
