Template Parser

This way of template customisation is obsolote and will work only on webpages of in classic wwwroot-folder!

This information is only available in English.

The document describes the behavior and options of the Template Parser rendering the estos MetaDirectory WebServer templates. It gives you a short introduction on how the parser handles commands and which options come along with the command. Even if there are short samples included you will understand the context much better if you take a closer look at the templates which come along with the estos MetaDirectory.

Parser behavior

Every whitespace will be deleted during parsing of the template file.
If you feel you are in need of a whitespace use instead.
This was done to speedup the page transfer

Command composition

Each parser command has the following layout:



The fieldname describes the databasefield. The attributes how the field, the data and associated fieldname have to be parsed.

Known estos MetaDirectory databasefields

Command	Databasefield	LDAP Field
<!-- <Databasename/> -->	Database name	databaseName
<!-- <Distinguishedname/> -->	Distinguished name	distinguishedName
<!-- <DatabaseID/> -->	DatabaseID	entryIDDB
<!-- <StoreID/> -->	StoreID	entryIDStore
<!-- <EntryID/> -->	EntryID	entryID
<!-- <Displayname/> -->	Display name	displayName
<!-- <Firstname/> -->	First name	givenName
<!-- <Lastname/> -->	Last name	sn
<!-- <Title/> -->	Title	title
<!-- <Company/> -->	Company	company
<!-- <Department/> -->	Department	department
<!-- <Officeroomnumber/> -->	Office room number	physicalDeliveryOfficeName
<!-- <Businessaddressstreet/> -->	Business address street	streetAddress
<!-- <Businessaddresspostalcode/> -->	Business address postal code	postalCode
<!-- <Businessaddresscity/> -->	Business address city	l
<!-- <Businessaddressstate/> -->	Business address state	st
<!-- <Businessaddresscountry/> -->	Business address country	c
<!-- <Privateaddressstreet/> -->	Private address street	privateAddressStreet
<!-- <Privateaddresspostalcode/> -->	Private address postal code	privateAddressPostalCode
<!-- <Privateaddresscity/> -->	Private address city	privateAddressCity
<!-- <Privateaddressstate/> -->	Private address state	privateAddressState
<!-- <Privateaddresscountry/> -->	Private address country	privateAddressCountry
<!-- <Otheraddressstreet/> -->	Other address street	otherAddressStreet
<!-- <Otheraddresspostalcode/> -->	Other address postal code	otherAddressPostalCode
<!-- <Otheraddresscity/> -->	Other address city	otherAddressCity
<!-- <Otheraddressstate/> -->	Other address state	otherAddressState
<!-- <Otheraddresscountry/> -->	Other address country	otherAddressCountry
<!-- <EMail/> -->	E-Mail	mail
<!-- <EMail2/> -->	E-Mail 2	mail2
<!-- <EMail3/> -->	E-Mail 3	mail3
<!-- <SIPadress/> -->	SIP adress	sipAddress
<!-- <WebpageURL/> -->	Web page URL	url
<!-- <Phonebusiness/> -->	Phone business	telephoneNumber
<!-- <Phonebusiness2/> -->	Phone business 2	otherTelephone
<!-- <Companymaintelephone/> -->	Company main telephone	telephoneNumberCompanyMain
<!-- <Assistanttelephone/> -->	Assistant telephone	telephoneAssistant
<!-- <Phonehome/> -->	Phone home	homephone
<!-- <Phonehome2/> -->	Phone home 2	otherHomePhone
<!-- <Primarytelephone/> -->	Primary telephone	telephonePrimary
<!-- <Phonemobile/> -->	Phone mobile	mobile
<!-- <Cartelephone/> -->	Car telephone	telephoneCar
<!-- <Radiotelephone/> -->	Radio telephone	telephoneRadio
<!-- <Phonepager/> -->	Phone pager	pager
<!-- <Callbacktelephone/> -->	Callback telephone	telephoneCallback
<!-- <ISDNtelephone/> -->	ISDN telephone	telephoneISDN
<!-- <TTYTTDtelephone/> -->	TTYTTD telephone	telephoneTTYTTD
<!-- <Facsimilebusiness/> -->	Facsimile business	facsimileTelephoneNumber
<!-- <Facsimilehome/> -->	Facsimile home	otherFacsimileTelephoneNumber
<!-- <CustomerID/> -->	Customer ID	customerid
<!-- <Directweblink/> -->	Direct web link	directWebLink
<!-- <Directopencontact/> -->	Direct open contact	directOpenContact
<!-- <Comment/> -->	Comment	info
<!-- <Custom0/> -->	Custom 0	custom0
<!-- <Custom1/> -->	Custom 1	custom1
<!-- <Custom2/> -->	Custom 2	custom2
<!-- <Custom3/> -->	Custom 3	custom3
<!-- <Custom4/> -->	Custom 4	custom4
<!-- <Custom5/> -->	Custom 5	custom5
<!-- <Custom6/> -->	Custom 6	custom6
<!-- <Custom7/> -->	Custom 7	custom7
<!-- <Custom8/> -->	Custom 8	custom8
<!-- <Custom9/> -->	Custom 9	custom9
<!-- <ContactURL/> -->	URL to edit the contact	contactURL
<!-- <ContactURLDescription/> -->	Description for the 1. contactURL	contactURLDescription
<!-- <ContactURL2/> -->	2. URL to open the contact	contactURL2
<!-- <ContactURLDescription2/> -->	Description for contactURL2	contactURLDescription2
<!-- <ContactURL3/> -->	3. URL to open the contact	contactURL3
<!-- <ContactURLDescription3/> -->	Description for contactURL3	contactURLDescription3
<!-- <ContactPictureMeta/> -->	Embets the picture for this contact	jpegPhoto
<!-- <ContactPicturePath/> -->	Contains a path to the picture if configured within the replicator	imagePath

Parser commands and attributes

Command	Possible values	Description
fieldvalue	0/1	<!-- <LastName fieldvalue="1"/> --> Smith The parser drops the associated field value
fieldname	0/1	<!-- <LastName fieldname="1"/> --> Last name The parser drops the associated field name in the corresponding language the user is viewing the page
skipifemptyvalue	0/1	<!-- <LastName skipifemptyvalue="1" fieldname="1" fieldvalue="1"/> --> If LastName exists in the database: Last name:Smith If the LastName is empty the parser will not add "Last name:" to the output
formatvalue		The parser formats the fieldvalue according to the format specified within possible values
	plain	<!-- <Company fieldvalue="1" formatvalue="plain" /> --> +4912345678
	phonelink	<!-- <Phonebusiness fieldvalue="1" formatvalue="phonelink" /> --> +4912345678 It is possible to define the phonelink handler in the estos MetaDirectory administrator.
	maillink	<!-- <EMail fieldvalue="1" formatvalue="maillink" /> --> info@estos.de
	siplink	<!-- <Custom0 fieldvalue="1" formatvalue="siplink" /> --> info@estos.de
	httplink	<!-- <WebPageURL fieldvalue="1" formatvalue="httplink" /> --> https://www.estos.de/
	uri	<!-- <WebPageURL fieldvalue="1" formatvalue="uri" /> --> Format as plain a href without additional formatting.
	uriblank	<!-- <WebPageURL fieldvalue="1" formatvalue="uriblank" /> --> Format as plain a href with target='_blank' without additional formatting.
	custom	<!-- <Custom0 formatvalue="custom" customformat="<a href='http://intranet/accounting/opencontact.php?%value%&view=1'>Open customer accounting</a>"/> --> Open customer accounting You can easily connect your webbased crm software using custom links You can use the following placeholders to get the apropriate data: %name% - for the field name %value% - for the field value %phonelink% - for the dial handler prefix
prefix	any apart <!-- or -->	<!-- <LastName fieldname="1" prefix="<b>"/> --> Last name The parser adds a prefix to the value and or name content
suffix	any apart <!-- or -->	<!-- <LastName fieldvalue="1" suffix="..."/> --> Smith... The parser adds a suffix to the value and or name content
prefixname	any apart <!-- or -->	<!-- <LastName fieldname="1" prefixname="->"/> --> ->Last name The parser adds a prefix to the name of the database field
suffixname	any apart <!-- or -->	<!-- <LastName fieldname="1" fieldvalue="1" suffixname=": "/> --> Last name: Smith The parser adds a suffix to the name of the database field
prefixvalue	any apart <!-- or -->	<!-- <LastName fieldname="1" fieldvalue="1" prefixvalue=": "/> --> Last name: Smith The parser adds a prefix to the value of the database field
suffixvalue	any apart <!-- or -->	<!-- <LastName fieldvalue="1" suffixvalue="..."/> --> Smith... The parser adds a suffix to the value of the database field
prefixvaluenotempty	any apart <!-- or -->	<!-- <LastName fieldname="1" fieldvalue="1" prefixvaluenotempty=": "/> --> Last name: Smith The parser adds a prefix to the value of the database field if it is not empty
suffixvaluenotempty	any apart <!-- or -->	<!-- <LastName fieldvalue="1" suffixvaluenotempty="..."/> --> Smith... The parser adds a suffix to the value of the database field if it is not empty
configvalue	any apart <!-- or -->	<!-- <fullresulttemplate configvalue="fullresult"/> --> This attribute contains a special configuration value for the server. This attribute is used for configuration of the mail page template.
limitvaluelength	Integer 1 - n	<!-- <LastName fieldvalue="1" limitvaluelength="32"/> --> Limit the length of the result value.
encoding	one of htmlansi\|url\|xml	<!-- <Displayname encoding="htmlansi" fieldname="1"/> --> Encode data for html, url or xml output.

Conditional statements

Tag	Description
if	<!-- <if condition="1"/> --> The condition is evaluated and the following text block will be included if the statement evaluates to 1. All Fields from the template parser are available in the statement. Examples: <!-- <if condition="UserAgent=='Mozilla'"/> --> <!-- <endif/> --> <!-- <if condition="Lastname=='Anders' AND Firstname=='Tom'"/> --> <!-- <endif/> -->
elseif	<!-- <elseif condition="1"/> --> The condition is evaluated and the following text block will be included if the statement evaluates to 1. Examples: <!-- <if condition="UserAgent=='Mozilla'"/> --> <!-- <elseif condition="UserAgent=='Opera''"/> --> <!-- <endif/> -->
else	<!-- <else/> --> The following text block will be included if the corresponding if statement did not evaluate to 1. Examples: <!-- <if condition="UserAgent=='Mozilla'"/> --> <!-- <else/> --> <!-- <endif/> -->
endif	<!-- <endif/> --> Marks the end of the if condition text block.

Version 6