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.

This document will describe the behavior and options for the Template Parser, which renders the estos MetaDirectory web server templates. It will provide you with a brief introduction to how the parser handles commands and which options will be available with the command. Even if short samples have been included, you will understand the context much better when you look closer at the templates provided along with estos MetaDirectory.

Parser Behavior

All white space will be deleted when parsing the template file.
If you feel you are in need of a white space use instead.
This was done to increase the page transfer rate.

Command Composition

Each parser command has the following organization:



Fieldname describes the database field. The attributes indicate how the field, the data and the associated field name must be parsed.

Known estos MetaDirectory databasefields

Command	Database field	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/> -->	Company street address	streetAddress
<!-- <Businessaddresspostalcode/> -->	Company ZIP code	postalCode
<!-- <Businessaddresscity/> -->	Company 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/> -->	Company phone	telephoneNumber
<!-- <Phonebusiness2/> -->	Secondary company phone	otherTelephone
<!-- <Companymaintelephone/> -->	Company main telephone	telephoneNumberCompanyMain
<!-- <Assistanttelephone/> -->	Assistant telephone	telephoneAssistant
<!-- <Phonehome/> -->	Home phone	homephone
<!-- <Phonehome2/> -->	Secondary home phone	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/> -->	Company fax number	facsimileTelephoneNumber
<!-- <Facsimilehome/> -->	Home fax number	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/> -->	Will embed the picture for this contact	jpegPhoto
<!-- <ContactPicturePath/> -->	Contains a path to the picture, if configured from the replicator	imagePath

Parser Commands and Attributes

Command	Potential 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 language corresponding to the page the user is viewing
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 will format the field value according to the format specified by the possible values
	plain	<!-- <Company fieldvalue="1" formatvalue="plain" /> --> +4912345678
	phonelink	<!-- <Phonebusiness fieldvalue="1" formatvalue="phonelink" /> --> +4912345678 The phonelink handler can be defined from the estos MetaDirectory Administrator.
	maillink	<!-- <EMail fieldvalue="1" formatvalue="maillink" /> --> info@estos.com
	siplink	<!-- <Custom0 fieldvalue="1" formatvalue="siplink" /> --> info@estos.com
	httplink	<!-- <WebPageURL fieldvalue="1" formatvalue="httplink" /> --> https://www.estos.com
	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