Użycie specjalnych słów i placeholderów w szablonach eksportu
W artykule wyjaśnimy, jak wstawiasz do szablonów eksportu w Fynode specjalne słowa, które system przy generowaniu eksportu zastąpi konkretnymi danymi z zamówienia. Opiszemy format, najczęściej używane placeholdery i przykłady dla szablonów Excel i PDF.
Czym są specjalne słowa (placeholders)
Specjalne słowa to wyrażenia zastępcze, które wstawiasz w polu „Szablon”, a system podczas generowania eksportu zastąpi je konkretnymi danymi z zamówienia. Używa się ich dla danych zamówienia, klienta, produktów, faktury lub przesyłki. Ta funkcjonalność jest taka sama dla eksportów Excel i PDF i upraszcza tworzenie dynamicznych wyników.
Formatowanie szablonu dla Excel i PDF
Jeśli tworzysz eksport Excel, w polu „Szablon” wpisz wiersze w formacie CSV i oddziel poszczególne pola średnikiem. Dla eksportu PDF wstaw kod HTML, w którym te same placeholdery działają identycznie. Przed zapisaniem upewnij się, że użyte klucze istnieją dla danego typu danych.
Najczęściej dostępne placeholdery
Do często używanych słów zastępczych należą na przykład {order.id}, {order.number}, {order.date}, {order.amount}, {order.client.name} i {order.client.email}. Dla pozycji w zamówieniu można użyć {order.product.name}, {order.product.quantity}, {order.product.unit_price} lub {order.product.ean}. Pełna lista dostępnych kluczy znajduje się w dokumentacji eksportów oraz w powiązanych ustawieniach fakturowania i szablonów e-mail.
W szablonie wstaw placeholder {order.number}. Przy generowaniu eksportu system zastąpi go rzeczywistym numerem zamówienia dla każdego wiersza eksportu.
Tak. Dla produktów użyj kombinacji placeholderów takich jak {order.product.name}, {order.product.quantity}, {order.product.unit_price} i {order.product.ean}. Przy eksportowaniu wielu pozycji system zadba o ich prawidłowe wypełnienie zgodnie z szablonem.
Przy eksporcie typu Excel wprowadzasz wiersze w formacie CSV, a poszczególne wiersze oddzielasz średnikiem. W jednym wierszu umieść placeholdery w kolejności kolumn, system podczas generowania utworzy prawidłowe wartości CSV dla każdego zamówienia.
Używając specjalnych słów uzyskasz elastyczne i wielokrotnego użytku eksporty. Po zapisaniu szablonu system podczas generowania eksportu automatycznie zastąpi placeholdery rzeczywistymi wartościami z zamówienia, a eksport będzie gotowy do pobrania lub masowego użycia w liście zamówień.
Dzień dobry, jesteśmy teraz online, chętnie odpowiemy na Twoje pytania.