Display Templates

 Top  Previous  Next

Display templates are HTML files that use HTML comments like <!--TL_PRJID_DATA--> to allow TestLog to replace the comment with the appropriate data. This allows you to control the display style such as font size, color and table properties using CSS as well as the specific location and order of fields using the TestLog comments. There is a set of default templates located in the ‘templates’ directory where TestLog is installed, to add your own template files create a new directory in the templates directory, copy the existing templates into this directory and edit them as you please. The <!--TL_STYLE--> tag is used by TestLog to embed or link to the stylesheet so there must be a stylesheet in each template directory named "style.css". The stylesheet for each template group can be altered to change how items are displayed, the CSS classes used in TestLog are described below.

 

CSS Classes

 

Class Name

Use

List

General items in a table

ListHeading

The first row in a List table that contains heading information

Breadcrumbs

DIV section that is added in place of the <!--TL_BREADCRUMBS--> tag containing page breadcrumb location and actions (CGI/Web export only)

TLHeader

Used in breadcrumbs DIV

TLHeaderTitle

The title section of the breadcrumb DIV

TLHeaderAction

The actions sections of the breadcrumbs DIV

TLHeaderLogo

Table elements in the breadcrumb DIV

Login

Table items used for the Login page (CGI Only)

 

 

Templates

 

Database
DatabaseTemplate.html

 

The database template uses one tag, <!--TL_DATABASE-->, that displays the top level of the database, showing the projects, test cases, configurations, resources, testers and filters links.

 

Project
ProjectTemplate.html

 

Field

Heading Tag

Data Tag

ID

<!--TL_PRJID_HEADING-->

<!--TL_PRJID_DATA-->

Test Manager

<!--TL_PRJMANAGER_HEADING-->

<!--TL_PRJMANAGER_DATA-->

Project Title

<!--TL_PRJTITLE_HEADING-->

<!--TL_PRJTITLE_DATA-->

Planned Start Date

<!--TL_PRJPLANSTART_HEADING-->

<!--TL_PRJPLANSTART_DATA-->

Actual Start Date

<!--TL_PRJACTSTART_HEADING-->

<!--TL_PRJACTSTART_DATA-->

Planned End Date

<!--TL_PRJPLANEND_HEADING-->

<!--TL_PRJPLANEND_DATA-->

Actual End Date

<!--TL_PRJACTEND_HEADING-->

<!--TL_PRJACTEND_DATA-->

Scope and Overview

<!--TL_PRJSCOPE_HEADING-->

<!--TL_PRJSCOPE_DATA-->

Resources and Staff

<!--TL_PRJRES_HEADING-->

<!--TL_PRJRES_DATA-->

Risks and Minimisation Actions

<!--TL_PRJRISKS_HEADING-->

<!--TL_PRJRISKS_DATA-->

Additional Notes

<!--TL_PRJNOTES_HEADING-->

<!--TL_PRJNOTES_DATA-->

References

<!--TL_PRJREF_HEADING-->

<!--TL_PRJREF_DATA-->

 

Test Configuration
TestCfgTemplate.html

 

Field

Heading Tag

Data Tag

ID

<!--TL_TCFGID_HEADING-->

<!--TL_TCFGID_DATA-->

Name

<!--TL_TCFGNAME_HEADING-->

<!--TL_TCFGNAME_DATAG-->

Location

<!--TL_TCFGLOCATION_HEADING-->

<!--TL_TCFGLOCATION_DATA-->

Description

<!--TL_TCFGDESCRIPTION_HEADING-->

<!--TL_TCFGDESCRIPTION_DATA-->

 

Test Resource
TestResTemplate.html

 

Field

Heading Tag

Data Tag

ID

<!--TL_TRESID_HEADING-->

<!--TL_TRESID_DATA-->

Name

<!--TL_TRESNAME_HEADING-->

<!--TL_TRESNAME_DATA-->

Location

<!--TL_TRESLOCATION_HEADING-->

<!--TL_TRESLOCATION_DATA-->

Description

<!--TL_TRESDESCIPTION_HEADING-->

<!--TL_TRESDESCIPTION_DATA-->

 

Tester
TesterTemplate.html

 

Field

Heading Tag

Data Tag

ID

<!--TL_TESTERID_HEADING-->

<!--TL_TESTERID_DATA-->

Name

<!--TL_NAME_HEADING-->

<!--TL_NAME_DATA-->

Location

<!--TL_LOCATION_HEADING-->

<!--TL_LOCATION_DATA-->

Remote Access

<!--TL_REMOTE_HEADING-->

<!--TL_REMOTE_DATA-->

 

Filter
FilterTemplate.html

 

Field

Heading Tag

Data Tag

ID

<!--TL_FILTERID_HEADING-->

<!--TL_FILTERID_DATA-->

Name

<!--TL_FILTERNAME_HEADING-->

<!--TL_FILTERNAME_DATA-->

Data

N/A

<!--TL_FILTER_DATA-->

 

The <!--TL_FILTER_DATA--> tag will print a list of the filter components.        

 

Test Suite and Project Test Suite
TestSuiteTemplate.html

PrjTestSuiteTemplate.html

 

Field

Heading Tag

Data Tag

ID

<!---TL_TGID _HEADING-->

<!--TL_TGID_DATA-->

Title

<!--TL_TGTITLE_HEADING-->

<!--TL_TGTITLE_DATA->

Description

<!--TL_TGDESCRIPTION_HEADING-->

<!--TL_TGDESCRIPTION_DATA-->

 

Test Case
TestCaseTemplate.html

 

Field

Heading Tag

Data Tag

ID

<!--TL_ID_HEADING-->

<!--TL_ID_DATA-->

Title

<!--TL_TITLE_HEADING-->

<!--TL_TITLE_DATA-->

Test Type

<!--TL_TESTTYPE_HEADING-->

<!--TL_TESTTYPE_DATA-->

Test Phase

<!--TL_TESTTPHASE_HEADING-->

<!--TL_PRJPLANSTART_DATA-->

Test Creation Time

<!--TL_CREATETIME_HEADING-->

<!--TL_CREATETIME_DATA-->

Test Creation Date

<!--TL_CREATEDATE_HEADING-->

<!--TL_CREATEDATE_DATA-->

Test Updated Time

<!--TL_UPDATETIME_HEADING-->

<!--TL_UPDATETIME_DATA-->

Test Updated Date

<!--TL_UPDATEDATE_HEADING-->

<!--TL_UPDATEDATE_DATA-->

Author

<!--TL_AUTHOR_HEADING-->

<!--TL_AUTHOR_DATA-->

Update By

<!--TL_UPDATEBY_HEADING-->

<!--TL_UPDATEBY_DATA-->

Test Configurations

<!--TL_CONFIG_HEADING-->

<!--TL_CONFIG_DATA-->

Test Resources

<!--TL_RESOURCE_HEADING-->

<!--TL_RESOURCE_DATA-->

Expected Test Duration

<!--TL_EXPDURATION_HEADING-->

<!--TL_EXPDURATION_DATA-->

Prerequisites

<!--TL_PRERQ_HEADING-->

<!--TL_PRERQ_DATA-->

Priority

<!--TL_PRIORITY_HEADING-->

<!--TL_PRIORITY_DATA-->

Test Description

<!--TL_DESCRIPTION_HEADING-->

<!--TL_DESCRIPTION_DATA-->

Expected Results

<!--TL_EXPRESULTS_HEADING-->

<!--TL_EXPRESULTS_DATA-->

Notes Fields 1

<!--TL_NOTES1_HEADING-->

<!--TL_NOTES1_DATA-->

Notes Field 2

<!--TL_NOTES2_HEADING-->

<!--TL_NOTES2_DATA-->

External Description Link

<!--TL_EXTLINK_HEADING-->

<!--TL_EXTLINK_DATA-->

 

TestCaseEdit.html
The edit template is used when an item is selected for editing in the CGI version. It uses the same heading + data tags as the view template and if you want a field to be able to be edited via the CGI version you can use its <!--***_EDIT--> tag. The <!--TL_EDIT_FORM_START--> tag is used to indicate where the <FORM> html tag will be inserted by TestLog and <!--TL_EDIT_FORM_END--> is used to indicate where the submit button and </FORM> tag should be inserted by Testlog.

 

Field

Edit Tag

ID

<!--TL_ID_EDIT-->

Title

<!--TL_TITLE_EDIT-->

Test Type

<!--TL_TESTTYPE_EDIT-->

Test Phase

<!--TL_TESTTPHASE_EDIT-->

Test Creation Time

<!--TL_CREATETIME_EDIT-->

Test Creation Date

<!--TL_CREATEDATE_EDIT-->

Test Updated Time

<!--TL_UPDATETIME_EDIT-->

Test Updated Date

<!--TL_UPDATEDATE_EDIT-->

Author

<!--TL_AUTHOR_EDIT-->

Update By

<!--TL_UPDATEBY_EDIT-->

Test Configurations

<!--TL_CONFIG_EDIT-->

Test Resources

<!--TL_RESOURCE_EDIT-->

Expected Test Duration

<!--TL_EXPDURATION_EDIT-->

Prerequisites

<!--TL_PRERQ_EDIT-->

Priority

<!--TL_PRIORITY_EDIT-->

Test Description

<!--TL_DESCRIPTION_EDIT-->

Expected Results

<!--TL_EXPRESULTS_EDIT-->

Notes Fields 1

<!--TL_NOTES1_EDIT-->

Notes Field 2

<!--TL_NOTES2_EDIT-->

External Description Link

<!--TL_EXTLINK_EDIT-->

 

Project Test Case
PrjTestCaseTemplate.html

 

The <!--TL_STATUS_MEANING--> tag can be used to get the original meaning / value for a status. This is used in some of the example templates to change the color of fields and text to reflect the current status.

 

The <!--TL_TEST_HISTORY--> can be used to display the history elements for the test case.

 

Field

Heading Tag

Data Tag

ID

<!--TL_ID_HEADING-->

<!--TL_ID_DATA-->

Title

<!--TL_TITLE_HEADING-->

<!--TL_TITLE_DATA-->

Test Type

<!--TL_TESTTYPE_HEADING-->

<!--TL_TESTTYPE_DATA-->

Test Phase

<!--TL_TESTTPHASE_HEADING-->

<!--TL_PRJPLANSTART_DATA-->

Test Status

<!--TL_STATUS_HEADING-->

<!--TL_STATUS_DATA-->

Number of Attempts

<!--TL_ATTEMPTS_HEADING-->

<!--TL_ATTEMPTS_DATA-->

Testers

<!--TL_TESTERS_HEADING-->

<!--TL_TESTERS_DATA-->

Fault Report

<!--TL_FAULTREP_HEADING-->

<!--TL_FAULTREP_DATA-->

Change Request ID

<!--TL_CHANGEREQ_HEADING-->

<!--TL_CHANGEREQ_HDATA-->

Test Creation Time

<!--TL_CREATETIME_HEADING-->

<!--TL_CREATETIME_DATA-->

Test Creation Date

<!--TL_CREATEDATE_HEADING-->

<!--TL_CREATEDATE_DATA-->

Test Updated Time

<!--TL_UPDATETIME_HEADING-->

<!--TL_UPDATETIME_DATA-->

Test Updated Date

<!--TL_UPDATEDATE_HEADING-->

<!--TL_UPDATEDATE_DATA-->

Last Attempt Time

<!--TL_LASTATTEMPTTIME_HEADING-->

<!--TL_LASTATTEMPTTIME_DATA-->

Last Attempt Date

<!--TL_LASTATTEMPTDATE_HEADING-->

<!--TL_LASTATTEMPTDATE_DATA-->

Author

<!--TL_AUTHOR_HEADING-->

<!--TL_AUTHOR_DATA-->

Update By

<!--TL_UPDATEBY_HEADING-->

<!--TL_UPDATEBY_DATA-->

Test Configurations

<!--TL_CONFIG_HEADING-->

<!--TL_CONFIG_DATA-->

Test Resources

<!--TL_RESOURCE_HEADING-->

<!--TL_RESOURCE_DATA-->

Expected Test Duration

<!--TL_EXPDURATION_HEADING-->

<!--TL_EXPDURATION_DATA-->

Actual Test Duration

<!--TL_ACTDURATION_HEADING-->

<!--TL_ACTDURATION_DATA-->

Version Tested

<!--TL_VERTESTED_HEADING-->

<!--TL_VERTESTED_DATA-->

Build Tested

<!--TL_BUILDTESTED_HEADING-->

<!--TL_BUILDTESTED_DATA-->

Prerequisites

<!--TL_PRERQ_HEADING-->

<!--TL_PRERQ_DATA-->

Priority

<!--TL_PRIORITY_HEADING-->

<!--TL_PRIORITY_DATA-->

Test Description

<!--TL_DESCRIPTION_HEADING-->

<!--TL_DESCRIPTION_DATA-->

Expected Results

<!--TL_EXPRESULTS_HEADING-->

<!--TL_EXPRESULTS_DATA-->

Results Obtained

<!--TL_RESULTS_HEADING-->

<!--TL_RESULTS_DATA-->

Result Notes

<!--TL_RESNOTES_HEADING-->

<!--TL_RESNOTES_DATA-->

External Result Link

<!--TL_RESLINK_HEADING-->

<!--TL_RESLINK_DATA-->

Notes Fields 1

<!--TL_NOTES1_HEADING-->

<!--TL_NOTES1_DATA-->

Notes Field 2

<!--TL_NOTES2_HEADING-->

<!--TL_NOTES2_DATA-->

External Description Link

<!--TL_EXTLINK_HEADING-->

<!--TL_EXTLINK_DATA-->

 

PrjTestCaseEdit.html

The edit template is used when an item is selected for editing in the CGI version. It uses the same heading + data tags as the view template and if you want a field to be able to be edited via the CGI version you can use it's <!--***_EDIT--> tag. The <!--TL_EDIT_FORM_START--> tag is used to indicate where the <FORM> html tag will be inserted by TestLog and <!--TL_EDIT_FORM_END--> is used to indicate where the submit button and </FORM> tag should be inserted by Testlog.

 

Field

Edit Tag

ID

<!--TL_ID_EDIT-->

Title

<!--TL_TITLE_EDIT-->

Test Type

<!--TL_TESTTYPE_EDIT-->

Test Phase

<!--TL_TESTTPHASE_EDIT-->

Test Status

<!--TL_STATUS_EDIT-->

Number of Attempts

<!--TL_ATTEMPTS_EDIT-->

Testers

<!--TL_TESTERS_EDIT-->

Fault Report

<!--TL_FAULTREP_EDIT-->

Change Request ID

<!--TL_CHANGEREQ_EDIT-->

Test Creation Time

<!--TL_CREATETIME_EDIT-->

Test Creation Date

<!--TL_CREATEDATE_EDIT-->

Test Updated Time

<!--TL_UPDATETIME_EDIT-->

Test Updated Date

<!--TL_UPDATEDATE_EDIT-->

Last Attempt Time

<!--TL_LASTATTEMPTTIME_EDIT-->

Last Attempt Date

<!--TL_LASTATTEMPTDATE_EDIT-->

Author

<!--TL_AUTHOR_EDIT-->

Update By

<!--TL_UPDATEBY_EDIT-->

Test Configurations

<!--TL_CONFIG_EDIT-->

Test Resources

<!--TL_RESOURCE_EDIT-->

Expected Test Duration

<!--TL_EXPDURATION_EDIT-->

Actual Test Duration

<!--TL_ACTDURATION_EDIT-->

Version Tested

<!--TL_VERTESTED_EDIT-->

Build Tested

<!--TL_BUILDTESTED_EDIT-->

Prerequisites

<!--TL_PRERQ_EDIT-->

Priority

<!--TL_PRIORITY_EDIT-->

Test Description

<!--TL_DESCRIPTION_EDIT-->

Expected Results

<!--TL_EXPRESULTS_EDIT-->

Results Obtained

<!--TL_RESULTS_EDIT-->

Result Notes

<!--TL_RESNOTES_EDIT-->

External Result Link

<!--TL_RESLINK_EDIT-->

Notes Fields 1

<!--TL_NOTES1_EDIT-->

Notes Field 2

<!--TL_NOTES2_EDIT-->

External Description Link

<!--TL_EXTLINK_EDIT-->

 

 

Test Case Report
TestCaseReportTemplate.html

 

The test case report template uses the tag <!--TL_STARTREPORTDATA--> to indicate the starting section of the HTML file that contains the relevant project test case tags and <!--TL_ENDREPORTDATA--> to indicate the end of the section. Between these two tags you can place any project test case tags. This section will be used to format the output for each entry in the test case report.

 

Field

Heading Tag

Data Tag

ID

<!--TL_REPORTID_HEADING-->

<!--TL_REPORTID_DATA-->



 

 

The above templates are used in both the standalone version of TestLog and the CGI version. The following templates are used in the CGI version only.

 

 

List Report
ListReportTemplate.html

 

The list report template is used to display a list report in the CGI version of TestLog. The <!--TL_LISTREPORTID_DATA--> tag is used for the ID of the report. The <!--TL_LIST--> tag is used to display the report contents.

 

 

Status Report
StatusReportTemplate.html

 

Uses a single <!--TL_STATUSREPORT--> tag to indicate where the generated image will be displayed.

 

 

Progress Report
ProgressReportTemplate.html

 

Uses a single <!--TL_PROGRESSREPORT--> tag to indicate where the generated image will be displayed.

 

Default Template
DefaultTemplate.html

 

This is a default template that is used when TestLog needs to display a generated page like an error message. Please don't remove the <!--TL_DATA--> tag from this file.

 

CGI Specific Tags

 

There are also a few tags that are designed for the CGI version and web export. These are;

 

<!--TL_BREADCRUMBS--> - Prints the current location of the file being viewed using hyperlinks so the user can return to the parent items easily.

 

<!--TL_LIST-->, <!--TL_TGLIST--> - Prints a list of hyperlinks of the child objects of an item. For example using this tag in a test suite template will display a list of the child test cases and sub suites.

 

The following templates display a list and only use the <!--TL_BREADCRUMBS--> and <!--TL_LIST--> tags.

 

Test Configuration List

CfgListTemplate.html

Filter List

FilterListTemplate.html

Resource List

ResourceListTemplate.html

Project Root

PrjRootTemplate.html

Report Root

ReportRootTemplate.html

Test Case Root

TestCaseRootTemplate.html

Tester List

TesterListTemplate.html

 

TL_TGLIST Customization
 

The TGLIST tag can be edited to change the columns that are used for displaying the list and in what order. You can select which columns to add by playing the appropriate heading tag for an item to the tag between "::", eg <!--TL_TGLIST:TL_TITLE_HEADING:TL_TESTTYPE_HEADING:TL_TESTTPHASE_HEADING:TL_STATUS_HEADING:--> will display the ID, title, test type, test phase and test status for the list of project test cases. Only items that were part of the original list can be used.

 

Printing Page Breaks
 

To add a page break when printing you can add "<p class=pagebreak>" to an item's display template. This can be useful when printing reports and you want each test case to start on a new page, or if you want to split a test case up with a separate section on each page.