The provided placeholders deliver task-related information in reports.
NOTE: The inclusion of all task-related placeholders is structured in a section marked by an open and closed tag format. The section begins with the opening tag {{tasks}}, followed by the addition of further task placeholders in the usual manner. The section is concluded with the closing tag {{/tasks}}. It is important to note that the additional / is specifically in the closing tag and not in the opening tag.
The task area is located in the area of Pins, e.g.:
```
{{pins}}
...Pin placeholders...
{{tasks}}
...Task placeholders...
{{/tasks}}
{{/pins}}
```
Placeholders for Task Details
{{tasks}}- Opens the area for placeholders related to tasks.{{/tasks}}- Closes the task area.{{if-tasks}}and{{end-if-tasks}}- When placed outside the placeholders for open and closed tasks, they check if there are tasks in the Pin. The headings are only displayed if there is at least one active task that follows the condition.{{task-number}}- Displays the task number.{{task-title}}- Provides the Title of the task.{{task-created-on}}- Shows the date and time the task was created in the app.{{task-created-by}}- Displays the name of the user who created the task.{{task-creator-email}}- Provides the E-mail address of the task creator.{{task-created-notime}}- Displays only the date the task was created in the app.
Task Status
{{task-status}}- Displays the current Status of the task - open, rejected, completed, closed, inactive. Learn more about task Status here.{{task-closed-on}}- If the task is closed, this shows the date it was closed. If it is open, a blank value is returned.{{task-closed-by}}- If the task is closed, this placeholder provides the name of the user who marked it as closed. If the task is still open, the placeholder returns a blank value.{{task-marked-as-done-on}}- If the task is completed, this shows the date and time it was reported as done.{{task-marked-as-done-on-notime}}- Displays only the date the task was reported as done.{{task-marked-as-done-by}}- Displays the name of the user who reported the task as done.
Due Date
{{task-due-date}}- Shows the Due date and time of a task.{{task-due-date-notime}}- Provides only the Due date without time indication.((task-due-date-history}}- Displays previous Due dates, if available.
Task Assignee
{{task-assignee}}- Displays the name of the user, contact, or team to whom the task is assigned.{{task-assignee-company}}- Provides the company name of the user to whom the task is assigned.{{task-assignee-email}}- Delivers the E-mail address of the task assigner.{{task-assignee-city}}- Displays the city of the task assignee.{{task-assignee-zip}}- Returns information about the postal code of the task assignee.{{task-assignee-address}}- Provides the address (street and house number) of the task assignee.{{task-assignee-country}}- Displays the country code (AT, DE) of the task assignee.{{task-assignee-number}}- Provides the phone number of the task assignee.
Task Comments
NOTE: Task comments differ from Pin notes. These placeholders only provide comments and images added in the task detail view. All placeholders related to task comments are again positioned within the comment area, except for the placeholder {{pin-task-comments}}. The correct syntax is as follows:
```
{{pins}}
... Pin placeholders ...
{{tasks}}
... Task placeholders ...
{{comments}}
... Placeholders for task comments ...
{{/comments}}
{{pin-task-comments}} //Outside the comment area.
{{/tasks}}
{{/pins}}
```
{{comments}}- Opens the area for task comments.{{/comments}}- Closes the area for task comments.{{comment-author}}- Provides the name of the user who wrote the comment.{{comment-created-date}}- Displays the creation date and time for the comment.{{comment-text}}- Returns the text of the comment, if available.{{comment-media}}- Displays images in the comment, if available. This placeholder is only available for Word reports.{{if-task-comment}}and{{/if-task-comment}}- When placed outside the placeholders for opening and closing the area for task comments, they check if there are comments in the tasks. Headings are only displayed if there is at least one comment that follows the condition.{{pin-task-comments}}- All comments of a task, separated by ";". This placeholder should be positioned outside the comment area, as otherwise it would be displayed for each comment.