Template Context

In addition to the standard Jinja2 filters, the following additional elements are available in the template context.

Name

Description

Example

checksum

The fingerprint value for the document. Every document template has a unique fingerprint which is calculated from its definition. Including the fingerprint in a document can provide assurance that a validated version of the document template has been used to generate a particular document.

Checksum : {{ checksum }}

convert_html

A filter function which attempts to turn HTML content into equivalent Word Document formats for display.

Only available in Word Document Templates

{{ field.PreText|convert_html }}

GENERATED_AT

A python date/time object in UTC timezone representing the start date/time of the document generation task.

See Python Date Formats.

Created at: {{ GENERATED_AT | timezone(USER_TIMEZONE_NAME) | format_datetime('%Y-%m-%d') }}

IS_TEST

A boolean representing whether the document template is being run in test mode from the document template editor.

{% if IS_TEST %}RUNNING IN TEST MODE{% endif %}

len

The python len() function. Returns the length of a list or string

{% if len(fields) > 10 %}...{% endif %}

project_role_for_user(user)

project_role_for_user(user) takes a User object and returns the User Project Role that the user has in this Project.

Hello {{ user.username }} your role in the project is {{ project_role_for_user(user).name }}

now()

now() function returns a python DateTime object representing the current server time with UTC timezone.

See Python Date Formats.

Time is now: {{ now() | format_datetime(('%d %b %Y %H:%M:%S') }}

settings

A python dictionary of settings provided by the user (these may just be the defaults for the template)

{{ settings.get("form_order","Ordinal") }}

template_name

The name of the Document Template being executed.

Template: {{ template_name }}

timezone

Converts a datetime value into the timezone provided.

See List of Time Zones.

User Time : {{ now()|timezone(USER_TIMEZONE_NAME)|format_datetime('%Y-%m-%d') }}
Time in NY : {{ now()|timezone("America/New_York")|format_datetime('%Y-%m-%d') }}

user

The User object for the user running the report.

Run by {{ user.username }}

USER_TIMEZONE_NAME

The name of the timezone of the user running the document template. e.g. Europe/London

See List of Time Zones.

Timezone : {{ USER_TIMEZONE_NAME }}

wiki_page(name)

A function which returns a Wiki page from the Drafts Project Wiki, formatted using the convert_html filter above. This is useful for injecting content maintained in the Wiki into documents.

Only available in Word Document Templates

{{ wiki_page("Design Notes") }}

Draft Home Templates

The following additional context variables are available in templates with a scope of Draft Home:

Name

Description

Example

draft

A draft reference. The root object from which Draft properties and sub objects such as lists of Forms or Folders can be accessed.

The draft variable is only available when the document template scope is of type Draft Home

Draft {{ draft.DraftName}} in Project {{ draft.Project.ProjectName }}

Project Home Templates

The following additional context variables are available in templates with a scope of Project Home:

Name

Description

Example

project

A project reference. The root object from which Project properties and sub objects such as lists of Drafts or Tickets can be accessed.

The project variable is only available when the document template scope is of type Project Home or Project Tickets

{{ project.ProjectName }}

Project Ticket Templates

The following additional context variables are available in templates with a scope of Project Tickets:

Important

When running document templates in testing from the document template editor the filter_assignments are set to "All", filter_labels are set to empty list, search_text is empty string, filtered_ids is an empty list and ticket_page is set to "All".

Name

Description

Example

project

A project reference. The root object from which Project properties and sub objects such as lists of Drafts or Tickets can be accessed.

The project variable is only available when the document template scope is of type Project Home or Project Tickets

{{ project.ProjectName }}

filter_assignments

The assignment filter selected in the ticket view that the document was generated from. Can be one of "All", "Unassigned" or "Assigned to me". Defaults to "All".

Assignments Filter : {{ filter_assignments }} {# All, Unassigned, Assigned to me #}

filter_labels

A list of labels which the ticket view is being filtered by. Empty list if view not being filtered by label.

{{ ", ".join(filter_labels) or 'None' }}

filtered_ids

Database ids of the records which are viewable in the ticket view that the document was generated from. This allows the document template author to report on just the tickets that the user has the view filtered to.

{% for ticket in project.ticket_set.filter(id__in=filtered_ids).order_by('iid') %}

search_text

The contents of the "search" box on the ticket view that the document was generated from

Active Search: {{ search_text or 'None' }}

ticket_page

The sub-page of the ticket view that the document was generated from. Can be "open", "closed" or "all"

Ticket Page: {{ ticket_page.title() }}