Skip to content

Comment

Option required

Comments are only available if the COMMENT option is enabled on the project.

Definition

A Comment is a message posted by a logged-in user on a participant. It is used for annotation and follow-up on a participant throughout the project.

Distinct entity

Comment on a Participant (this entity, Operations module) and Comment on a Preparation element (Preparation module) share the same concept and name but are distinct technical entities with their own parent reference and lifecycle.

Editability

A Comment can be edited in place (message and tags) via Edit comment, and removed via Delete comment. See the Editability policy.

Project
└── Participant
    └── Comment

Main attributes

AttributeDescription
MessageThe comment message
AuthorThe logged-in user who created the comment
TagsZero or more tags associated with the comment

Tags

A comment can carry zero or more Tags. Tags are project-scoped labels created once per project and reused across every participant's comments. The full definition (attributes, count semantics, lifecycle) is documented on the Tag business object page.

Tag moderation

Tag management (create, rename, delete) is restricted to PROJECT_ADMIN and PROJECT_MANAGER. Other roles can attach existing tags to their comments but cannot modify the project tag catalog. See Manage tags.

Status

A comment does not have an explicit status field. Its state is derived from:

SituationImplied state
Have been soft deletedHIDDEN
Have not been soft deletedVISIBLE

Relationships

Related objectRelationship
ParticipantA comment is attached to one participant
UserA comment is authored by one user (zero if user purged)
TagA comment can carry zero or more tags