7.1

Návod na použití slučovacích značek

Při tvorbě šablon pro InTouch CRM se setkáte s potřebou používat slučovací značky. Jedná se o speciální znakové sekvence, které jsou nahrazeny skutečným textem při použití šablony.

Značky mají dvě možné formy: [[[cesta]]] nebo {{{cesta}}}. Druhá forma podporuje escapování speciálních znaků (závislé na výstupním formátu, obvykle HTML). Značka v první formě pošle data do výstupu v nezměněné podobě.

Uvnitř značky může být jeden nebo více identifikátorů (řetězců) oddělených dvojtečkou, které tvoří cestu. Příklady platných slučovacích značek mohou být:

{{{salutation}}} - Vloží oslovení zákazníka
[[[include:112]]] - Vloží obsah šablony s kódem 112 (fragment)
[[[t:fullname]]] - Vloží jméno zákazníka

Všechny slučovací značky by měly mít cestu složenou s min. dvou segmentů (např. [[[html:body]]]), nicméně z důvodu kompatibility existují i značky s jedním segmentem cesty (např. [[[phone]]]). V přehledu níže je uvádíme ve sloupci Zjednodušeně.

V přehledu neuvádíme (pro zjednodušení) počáteční nebo koncovou trojici znaků [[[, ]]] či {{{, }}}.

Značky pro informace o zákazníkovi

Cesta/ZnačkaZjednodušeněPopis
t:companycompanyNázev společnosti
t:firstnamefirstnameKřestní jméno
t:surnamesurnamePříjmení
t:fullnamefullnamePlné jméno, včetně titulů
t:streetstreetUlice a č. (prioritně druhá)
t:citycityMěsto (prioritně druhá)
t:zipzipPSČ (prioritně druhá)
t:streetsstreetsUlice a č. z první adresy
t:cityscitysMěsto z první adresy
t:zipszipsPSČ z první adresy
t:streetmstreetmUlice a č. z druhé adresy
t:citymcitymMěsto z druhé adresy
t:zipmzipmPSČ z druhé adresy
t:salutationsalutationOslovení v pátém pádě
t:emailemailHlavní e-mail zákazníka
t:mobilemobileTelefon (první mobilní)
t:landlinelandlineTelefon (první pevná linka)
t:phonephoneTelefon (první)
t:webwebAdresa webových stránek
t:frontpathfrontpathOdkaz na extranet (samoobslužný kiosek)
t:agree:<id>agree:<id>Odkaz (URL) pro udělení souhlasu s kódem <id>
t:disagree:<id>disagree:<id>Odkaz (URL) pro odebrání souhlasu s kódem <id>
t:frontkeyfrontkeyUnikátní klíč identifikující zákazníka
t:compnamecompnameKombinovaný název firmy a jména osoby
t:icoicoIČO
t:dicdicDIČ
t:birthnumbirthnumRodné číslo osoby
t:dicnumdicnumČíselná část DIČ bez úvodních písmen (CZ)
t:bankaccbankaccČíslo účtu
t:bankcodebankcodeKód banky
t:bankssbankssSpecifický symbol přidělený zákazníkovi
t:streetnamestreetnameNázev ulice (bez čísla domu)
t:cardcardČíslo zákaznické karty
t:loginloginPřihlašovací jméno zákazníka (do extranetu)
t:symbolsymbolVolitelný identifikátor symbol
t:ididČíselný kód záznamu kontaktu (jen pro interní výstupy)
t:categoriescategoriesSeznam kategorií kontaktu oddělených čárkou
t:attr:<name>attr:<name>Hodnota pojmenovaného atributu <name>

Značky pro informace o aktuálním uživateli

Cesta/ZnačkaZjednodušeněPopis
user:namenameJméno aktuálního uživatele
user:notifymailnotifymailE-mail aktuálního uživatele
user:contactcontactTelefonické spojení na aktuálního uživatele
user:login Přihlašovací jméno aktuálního uživatele

Značky pro informace o provozovateli CRM

Cesta/ZnačkaZjednodušeněPopis
setup:companyocompanyNázev vaší firmy
setup:webowebVaše webové stránky
setup:emailoemailE-mail vaší firmy
setup:addressoaddressAdresa vaší firmy
setup:icooicoIČO vaší firmy
setup:dicodicDIČ vaší firmy
setup:phonesophonesTelefonické spojení na vaši firmu
setup:imgimgURL pro umístění obrázků (pro hromadný e-mailing)
setup:todaytodayDnešní datum
setup:date:YYYY-MM-DDdate:YYYY-MM-DDNaformátované datum YYYY-MM-DD

Značky pro informace o příležitosti

Cesta/ZnačkaPopis
op:nameNázev příležitosti
op:customerKód zákazníka u příležitosti
op:amountČástka příležitosti (v hlavní měně)
op:intlamountČástka příležitosti (v měně viz. níže)
op:currencyMěna částky příležitosti
op:idKód příležitosti
op:symbolVolitelný identifikátor příležitosti
op:itemop:<name>Hodnota zákaznického atributu příležitosti <name>

Značky pro informace o nabídce

Cesta/ZnačkaPopis
of:nameNázev nabídky
of:customerKód zákazníka u nabídky
of:totalpriceCelková cena nabídky
of:itmmoneyCena položek nabídky
of:currencyMěna nabídky
of:idKód nabídky
of:symbolVolitelný identifikátor nabídky
of:itemof:<name>Hodnota zákaznického atributu nabídky <name>

Značky pro informace o objednávce

Cesta/ZnačkaPopis
bc:nameNázev objednávky
bc:casetypeKód typu objednávky (definováno v nastavení)
bc:customerKód zákazníka
bc:moneyCena objednávky (v hlavní měně)
bc:intlmoneyCena objednávky
bc:currencyMěna objednávky
bc:responsiblesSeznam uživatelů a skupin odpovědných za vyřízení objednávky
bc:itembc:<name>Hodnota zákaznického atributu objednávky <name>

Značky pro informace o události (schůzce)

Cesta/ZnačkaPopis
ev:nameNázev události
ev:placeMísto konání
ev:startZačátek konání
ev:endKonec konání
ev:descriptionPopis události (může být HTML formát)
ev:responsiblesSeznam účastníků události
ev:timeČas začátku události

Značky pro informace o faktuře

Cesta/ZnačkaPopis
in:allnumberFormátované číslo faktury
in:varsymbolVariabilní symbol
in:idKód záznamu faktury v CRM
in:symbolPárovací symbol
in:amountCelková částka faktury
in:currencyMěna faktury

Značky pro informace o problému (helpdesk)

Cesta/ZnačkaPopis
pr:nameNázev problému
pr:finishPlánovaný termín vyřízení problému/požadavku

Speciální značky

Cesta/ZnačkaPopis
include:<id>Zpracování a vložení obsahu jiné šablony s kódem <id>
msg:<key>:<arg0>:<arg1>:...Vložení lokalizovaného (i18n) stringu s klíčem <key>

Poznámky

V šablonách je možné najít i jiné, než zde uvedené značky. Je to tím, že šablonovací systém je rozšiřitelný o libovolné jiné značky. Pokud vám nějaké chybí, kontaktujte nás.