Utilizarea cuvintelor speciale și a placeholderelor în șabloanele de export
În articol vom explica cum introduceți în șabloanele de export din Fynode cuvinte speciale pe care sistemul le va înlocui la generarea exportului cu date concrete din comandă. Vom descrie formatul, cele mai utilizate placeholder-e și exemple pentru șabloane Excel și PDF.
Ce sunt cuvintele speciale (placeholders)
Cuvintele speciale sunt expresii placeholder pe care le introduceți în câmpul „Șablon” și pe care sistemul le va înlocui cu date concrete din comandă la generarea exportului. Sunt folosite pentru date despre comandă, client, produse, factură sau colet. Această funcționalitate este aceeași pentru exporturile Excel și PDF și simplifică crearea de output-uri dinamice.
Formatarea șablonului pentru Excel și PDF
Dacă creați un export Excel, introduceți în câmpul „Șablon” rânduri în format CSV și separați rândurile individuale cu punct și virgulă. Pentru export PDF introduceți cod HTML, în care aceleași placeholder-e funcționează la fel. Înainte de salvare verificați că cheile folosite există pentru tipul de date respectiv.
Cele mai frecvent disponibile placeholder-e
Exemple de substituenți folosiți frecvent includ de exemplu {order.id}, {order.number}, {order.date}, {order.amount}, {order.client.name} și {order.client.email}. Pentru articolele din comandă puteți folosi {order.product.name}, {order.product.quantity}, {order.product.unit_price} sau {order.product.ean}. Lista completă a cheilor disponibile o găsiți în documentația exporturilor și în setările aferente facturării sau șabloanelor de email.
Introduceți în șablon placeholder-ul {order.number}. La generarea exportului, sistemul îl va înlocui cu numărul real al comenzii pentru fiecare rând din export.
Da. Pentru produse folosiți combinații de placeholder-e precum {order.product.name}, {order.product.quantity}, {order.product.unit_price} și {order.product.ean}. La exportul mai multor poziții sistemul se va ocupa să le completeze corect conform șablonului.
Pentru tipul de export Excel introduceți rândurile în format CSV și separați rândurile prin punct și virgulă. Într-un singur rând inserați placeholderele în ordinea coloanelor; sistemul va genera valorile CSV corecte pentru fiecare comandă la generare.
Folosind cuvinte speciale obțineți exporturi flexibile și reutilizabile. După salvarea șablonului, sistemul va înlocui automat placeholder-ele cu valori reale din comandă la generarea exportului și exportul va fi pregătit pentru descărcare sau utilizare în masă în lista comenzilor.