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čka	Zjednodušeně	Popis
t:company	company	Název společnosti
t:firstname	firstname	Křestní jméno
t:surname	surname	Příjmení
t:fullname	fullname	Plné jméno, včetně titulů
t:street	street	Ulice a č. (prioritně druhá)
t:city	city	Město (prioritně druhá)
t:zip	zip	PSČ (prioritně druhá)
t:streets	streets	Ulice a č. z první adresy
t:citys	citys	Město z první adresy
t:zips	zips	PSČ z první adresy
t:streetm	streetm	Ulice a č. z druhé adresy
t:citym	citym	Město z druhé adresy
t:zipm	zipm	PSČ z druhé adresy
t:salutation	salutation	Oslovení v pátém pádě
t:email	email	Hlavní e-mail zákazníka
t:mobile	mobile	Telefon (první mobilní)
t:landline	landline	Telefon (první pevná linka)
t:phone	phone	Telefon (první)
t:web	web	Adresa webových stránek
t:frontpath	frontpath	Odkaz 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:frontkey	frontkey	Unikátní klíč identifikující zákazníka
t:compname	compname	Kombinovaný název firmy a jména osoby
t:ico	ico	IČO
t:dic	dic	DIČ
t:birthnum	birthnum	Rodné číslo osoby
t:dicnum	dicnum	Číselná část DIČ bez úvodních písmen (CZ)
t:bankacc	bankacc	Číslo účtu
t:bankcode	bankcode	Kód banky
t:bankss	bankss	Specifický symbol přidělený zákazníkovi
t:streetname	streetname	Název ulice (bez čísla domu)
t:card	card	Číslo zákaznické karty
t:login	login	Přihlašovací jméno zákazníka (do extranetu)
t:symbol	symbol	Volitelný identifikátor symbol
t:id	id	Číselný kód záznamu kontaktu (jen pro interní výstupy)
t:categories	categories	Seznam 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čka	Zjednodušeně	Popis
user:name	name	Jméno aktuálního uživatele
user:notifymail	notifymail	E-mail aktuálního uživatele
user:contact	contact	Telefonické 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čka	Zjednodušeně	Popis
setup:company	ocompany	Název vaší firmy
setup:web	oweb	Vaše webové stránky
setup:email	oemail	E-mail vaší firmy
setup:address	oaddress	Adresa vaší firmy
setup:ico	oico	IČO vaší firmy
setup:dic	odic	DIČ vaší firmy
setup:phones	ophones	Telefonické spojení na vaši firmu
setup:img	img	URL pro umístění obrázků (pro hromadný e-mailing)
setup:today	today	Dnešní datum
setup:date:YYYY-MM-DD	date:YYYY-MM-DD	Naformátované datum YYYY-MM-DD

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

Cesta/Značka	Popis
op:name	Název příležitosti
op:customer	Kó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:currency	Měna částky příležitosti
op:id	Kód příležitosti
op:symbol	Volitelný 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čka	Popis
of:name	Název nabídky
of:customer	Kód zákazníka u nabídky
of:totalprice	Celková cena nabídky
of:itmmoney	Cena položek nabídky
of:currency	Měna nabídky
of:id	Kód nabídky
of:symbol	Volitelný identifikátor nabídky
of:itemof:<name>	Hodnota zákaznického atributu nabídky <name>

Značky pro informace o objednávce

Cesta/Značka	Popis
bc:name	Název objednávky
bc:casetype	Kód typu objednávky (definováno v nastavení)
bc:customer	Kód zákazníka
bc:money	Cena objednávky (v hlavní měně)
bc:intlmoney	Cena objednávky
bc:currency	Měna objednávky
bc:responsibles	Seznam 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čka	Popis
ev:name	Název události
ev:place	Místo konání
ev:start	Začátek konání
ev:end	Konec konání
ev:description	Popis události (může být HTML formát)
ev:responsibles	Seznam účastníků události
ev:time	Čas začátku události

Značky pro informace o faktuře

Cesta/Značka	Popis
in:allnumber	Formátované číslo faktury
in:varsymbol	Variabilní symbol
in:id	Kód záznamu faktury v CRM
in:symbol	Párovací symbol
in:amount	Celková částka faktury
in:currency	Měna faktury

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

Cesta/Značka	Popis
pr:name	Název problému
pr:finish	Plánovaný termín vyřízení problému/požadavku

Speciální značky

Cesta/Značka	Popis
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>
html:body	Značka používaná pro slučování HTML dokumentu s vloženým HTML fragmentem (např. získaným z HTML editoru)

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.