Skip to main content

Task Placeholders

Updated yesterday

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 adding more task placeholders in the usual way. 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}​} - Indicates the Title of the task.

  • {​{task-created-on}​} - Shows the date and time when the task was created in the app.

  • {​{task-created-by}​} - Displays the name of the user who created the task.

  • {​{task-creator-email}​} - Indicates the E-mail address of the task creator.

  • {​{task-created-notime}​} - Shows only the date when 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, an empty value is returned.

  • {​{task-closed-by}​} - If the task is closed, this placeholder indicates the name of the user who marked it as closed. If the task is still open, the placeholder returns an empty 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}​} - Shows 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}​} - Displays the Due date and time of a task.

  • {​{task-due-date-notime}​} - Indicates only the Due date without time.

  • ((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}​} - Indicates the company name of the user to whom the task is assigned.

  • {​{task-assignee-email}​} - Provides 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}​} - Returns 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}​} - Indicates the phone number of the task assignee.

Task Comments

NOTE: Task comments differ from Pin notes. These placeholders only provide comments and images that were added in the task detail view. All placeholders related to task comments are again positioned within the comment area, with the exception of 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}​} - Indicates the name of the user who wrote the comment.

  • {​{comment-created-date}​} - Shows the creation date and time for the comment.

  • {​{comment-text}​} - Returns the text of the comment, if available.

  • {​{comment-media}​} - Displays the 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.

Did this answer your question?