Task Comments

View and send comments to Tasks.

Overview

Commenting Descriptions

Comments allow Request participants to solicit and provide feedback on business decisions in a Task:

• Post Task comments: Post comments to the currently displayed Task summary. All Request participants that view that Task's summary see that comment. Write and preview comments using rich text features including but not limited to text styles, images, hyperlinks, and lists. The commenting editor uses Markdown syntax. Request participants may edit and/or delete their own posted comments if the Form Task element or Manual Task element associated with that Task is configured to allow editing and/or deleting of Task comments.

• Tag ProcessMaker users in a Task comment: Precede a user's username with the @ symbol to invite that user into the comment thread so that user can participate in the discussion. Upon using the @ symbol and then typing the initial letters of the user to tag, those users that match those initial letters display for selection. After sending the comment with tagged users, those users receive a notification of the comment they were tagged within, and then may select that notification to view that Task comment. Selecting a notification for a tagged comment opens that Task summary that contains the tagged comment. If the tagged user is not a Request participant prior to being tagged in a Task comment, that user becomes a Request participant only for that Request.

• Add emoticon reactions to sent Task comments: Add emoticon reactions to posted Task comments if the Form Task element or Manual Task element associated with that Task is configured to allow.

• Add votes to sent Task comments: Add votes to posted Task comments if the Form Task element or Manual Task element associated with that Task is configured to allow.

Use a Markdown syntax quick guide for the most commonly used Markdown syntax.

Requirements

ProcessMaker Platform Package Required

The Comments package must be installed to use Task commenting functions.

Form Task or Manual Task Element Configuration

For Tasks to provide commenting functions, the Form Task element or Manual Task element associated with that Task must be configured to allow the following commenting functions:

• Allow comments: The Form Task element or Manual Task element must be configured to allow comments.

• Add reactions to comments: Add emoticon reactions to posted comments in a Task summary if its associated Form Task element or Manual Task element is configured to allow it.

• Allow comment voting: Vote on posted comments in a Task summary if its associated if its associated Form Task element or Manual Task element is configured to allow it. Voting allows Request participants to vote on the merits of a posted comment and provide feedback to the Request participant that posted that comment.

• Allow comment editing: Request participants may edit their posted comments in a Task summary if its associated Form Task element or Manual Task element is configured to allow it.

• Allow comment deletion: Request participants may delete their own posted comments from a Task summary if its associated Form Task element or Manual Task element is configured to allow it.

See Configure Commenting Functions in Configure a Process or ask your Process designer to configure the Process to use comments in its associated Requests.

View Comments in a Task Summary

Ensure the following requirements are met to view comments for a Task:

• The Comments package is installed.

• The Form Task element or Manual Task element associated with your Task is configured to allow comments.

Follow these steps to view posted comments to a Task summary:

1. Ensure that you are logged on to ProcessMaker Platform.

2. Do one of the following to view the Task from which to view its posted comments:

   • From a Request summary, click the Tasks tab, which is the default tab.

   • View all assigned Tasks.

   • View all completed Tasks.

   • View self service Tasks.

3. Click the name of the Task from the Task column.

4. View below the Task. Task comments display in chronological order below the Task. The comment icondisplays for each posted comment except those posted as replies to a comment. If the Form Task element or Manual Task element associated with this Task provides additional commenting functionality, you may do the following while viewing a Task comment:

   • Post or reply to a Task comment.

   • Add a reaction to a Task comment.

   • Add a vote to a Task comment.

Request comments display in that Request's history in chronological order

Each posted comment contains the following information:

• Avatar: The user's avatar identifies the sender of each comment. Hover your cursor over a user's avatar to view that person's full name.

• Datetime: The datetime displays when the comment was posted to the Task summary. The time zone setting to display the time is according to the ProcessMaker Platform instance unless your user profile's Time zone setting is specified.

• Request number: The Request number displays to the right of the datetime when the comment was posted.

• Comment: The posted comment displays below the preceding information. The comment may contain tagged users, emoticon reactions, and/or votes. If a comment contains replies, click the Load Replies button to display that comment's replies.

• Reply: Click the Reply button to reply to a selected comment. See Send or Reply to a Comment in a Request.

Each posted comment may contain the following ways to provide reaction or feedback to a selected comment depending how the Process associated with that Request is configured to use commenting functions:

• Add a reaction to a Request comment: Click theicon to add an emoticon reaction to a selected comment or reply. See Add a Reaction to a Task Comment.
• Add a vote to a Request comment: Click either theandicon below a selected comment to vote favorably or unfavorably to that comment, respectively. See Add a Vote to a Task Comment.

Add a Reaction to a Task Comment

Ensure the following to add reactions to a posted Task comment:

• The Comments package installed.

• The Form Task element or Manual Task element associated with that Task is configured to allow reactions to posted comments.

‌Follow these steps to add a reaction to a posted Task comment:‌

1. ​View the posted comments for a Task.

2. Click the reaction iconbelow the posted comment to add an emoticon reaction. Available emoticon icons display.
3. Browse for and then select the emoticon reaction to add to the posted comment. The emoticon reaction displays as a new reply to the posted comment.

Emoticon reactions added to a posted Task comment‌

Add a Vote to a Task Comment

Ensure the following to add votes to a posted Task comment:

• The Comments package installed.

• The Form Task element or Manual Task element associated with your Task is configured to allow voting to posted comments.

‌Follow these steps to add a vote to a posted Task comment:‌

1. ​View the posted comments for a Task. The voting indicators display below each posted comment.

2. Do one of the following:

   • Click theicon below the comment to vote favorably for it.
   • Click theicon below the comment to vote unfavorably for it.

   The selected vote indicator displays as a reply to the selected comment and one vote adds to the voting icons below that comment.

Votes added to a posted Task comment

Post or Reply to a Task Comment

Ensure the following to post or reply comments for a Task:

• The Comments package is installed.

• The Form Task element or Manual Task element associated with your Task is configured to allow comments.

Enter comments into Conversational-type Screens prior to entering information into that Screen. Otherwise, that Screen cannot be submitted.

Follow these steps to post or reply to a Task comment:

1. View the Task summary to post or reply to a Task comment.

2. Do one of the following:

   • Post a new Task comment: View the end of that Task's history to locate the Write tab to write and post a new comment to that Task.

   • Reply to an existing Task comment: Browse through that Task's history to locate the existing comment to which to reply, and then click the Reply button at the bottom of that Task comment. The Write tab displays below that Task comment.
3. From the Write tab, write your Task comment. Optionally use rich text features such as text styles, images, hyperlinks, lists, code-, and/or quote-styles. The commenting editor uses Markdown syntax. Use a Markdown syntax quick guide for the most commonly used Markdown syntax. Follow these guidelines:

   • Text styles, including bold, italics, strikethrough, and code styles: Click a text style button from the commenting editor toolbar. The commenting editor displays both the preceding and following Markdown syntax in the commenting editor. Place your cursor between the Markdown syntax, and then write your text to display in that text style. For example, click the Bold text style button from the commenting editor toolbar. Four asterisks display in the commenting editor: two asterisks to precede your text and two to follow your text since bold-style text in Markdown syntax requires two asterisks both preceding and following text for that style. Alternatively, write your text in plain text, highlight the text to display in a particular text style, and then click that text style's button.

   • Add an image: Click the Image button from the commenting editor toolbar. A screen displays to enter the absolute URL to the image to display in the comment. In the Please enter image url setting, enter the image's absolute URL, and then click OK.
   • Add a hyperlink: Select the text in the commenting editor to display as a hyperlink, and then click the Link button from the commenting editor toolbar. A screen displays to enter the hyperlink available from the selected text. In the Please enter link setting, enter the hyperlink available from the selected text, and then click OK.
   • Tag users in a Task comment: Precede a user's username with the @ symbol to invite that user into the comment thread so that user can participate in the discussion. Upon using the @ symbol and then typing the initial letters of the user to tag, those users that match those initial letters display for selection. After sending the comment with tagged users, those users receive a notification of the comment they were tagged within, and then may select that notification to view that Task comment. Selecting a notification for a tagged comment opens that Task summary that contains the tagged comment. If the tagged user is not a Task participant prior to being tagged in a Task comment, that user becomes a Task participant only for that Task.

4. Optionally, click the Preview tab to preview your currently written comment as it would display after it is posted.

5. Click the Send button. The comment posts.

Edit One of Your Task Comments

Ensure the following to edit comments for a Task:

• The Comments package is installed.

• The Form Task element or Manual Task element associated with your Task is configured to allow comments.

Edit comments in Conversational-type Screens prior to entering information into that Screen. Otherwise, that Screen cannot be submitted.

Task participants may edit their own comments, but not those posted by others.

Follow these steps to edit one of your Task comments:‌

1. View the posted comments for a Task.

2. Locate your posted Task comment to edit.

3. Click the Edit Comment iconon the top right of the posted comment. The commenting editor displays with the posted comment contents.
4. Edit your comment using the commenting editor as you did when you posted or replied to a comment.

5. Click the Update Comment button. The edited comment posts.

Editing a posted Task comment

Delete One of Your Task Comments

Ensure the following to delete comments for a Task:

• The Comments package is installed.

• The Form Task element or Manual Task element associated with your Task is configured to allow comments.

Task participants may delete their own comments, but not those posted by others. If the comment being deleted has replies, then its replies are also deleted.

Follow these steps to delete one of your Task comments:‌

1. View the posted comments for a Task.

2. Locate your posted Task comment to delete.

3. Click the Remove Comment icon on the top right of the posted comment. The Caution screen displays to confirm the deletion of the Task comment.

   
4. Click Confirm and the comment is deleted from the list of posted comments.

Related Topics

pageWhat is a Task?pageView Tasks You Need to DopageView Completed TaskspageSelf-Assign Tasks to Yourself from a QueuepageSearch for a TaskpageView a Task SummarypageComments PackagepageWhat is a Package?pageRequest Comments