ThreadedMessage

A threaded discussion message [ThreadedMessage] is a message posted by an employee about an object of a supported type. Currently, threaded messages are only available for projects in SuiteProjects Pro. For a description of threaded discussion messages in the SuiteProjects Pro UI, see Project Discussions.

A project discussion is a collection of messages about a specific project. There is a 1:1 relationship between project and project discussion.

A message is a unit of writing posted by a user at a given date and time in the project discussion. A message can be an initial communication posted to the project discussion (original message), or a response posted in a thread (reply).

A thread is an original message and a collection of replies to this original message.

An original message is a message posted to the project discussion. An original message can be either an unthreaded message (if there are no replies) or the start of a thread (if there are replies).

A reply is any message added to a thread, functioning as a response to the original message or to other replies within that same thread.

Review the Usage Guidelines for the ThreadedMessage object.

—	XML	SOAP	REST	Database table
Object	ThreadedMessage	oaThreadedMessage	ThreadedMessage See Threaded Discussion Messagess.	threaded_messages
Supported Commands	Add, Read, Modify, Delete	add(), read(), modify(), upsert(), delete()	See Available methods.	—

The ThreadedMessage object has the following properties:

XML / SOAP	REST	Database	Description
content	content	content	The body of the message.
—	countRepliesTotal	—	[Read-only] If this is an original message for a message thread, the number of read or unread replies in the thread (if any).
—	countRepliesUnread	—	[Read-only] If this is an original message for a message thread, the number of unread replies in the thread (if any).
created	created	created	[Read-only] The date and time the message was created. See Date Fields.
deleted_by	deletedBy	deleted_by	[Read-only] The internal ID of the employee who deleted the message.
edited	edited	edited	[Read-only] A 1/0 field indicating if the message was edited.
id	id	id	[Read-only] The unique internal identifier of the message.
—	isLastReadMessage	—	[Read-only] A 1/0 field indicating whether this is the last message in the project discussion, or the last reply in the message thread marked as read for the authenticated user.
—	lastReplyDate	—	[Read-only] If this is an original message for a message thread, the date and time of the latest reply in the message thread.
record_id	recordId	record_id	[Required] The internal ID of the record in the table tableName associated with the threaded discussion. The project with internal ID record_id must exist.
reply_to_id	replyToId	reply_to_id	If the message is a reply in a message thread, the internal ID of the original message for the thread. If specified, the message with internal ID reply_to_id must exist and be part of the threaded discussions for the project with internal ID record_id.
table_name	tableName	table_name	[Required] The name of the table including the record associated with the threaded discussion. Must be project. Threaded discussions are supported only for projects.
updated	updated	updated	[Read-only] The date and time the message was last updated or modified. See Date Fields.
user_id	userId	user_id	[Read-only] The internal ID of the employee associated with the message (the employee who posted the message). When adding a message, this is the ID of the authenticated user.

Usage Guidelines

Review the following guidelines:

• The Project Discussions feature must be enabled for your account. See Projects Other Settings.

• The authenticated user must have access to the Projects application, and to the project with internal ID record_id.

• To modify a threaded discussion message, the authenticated user must be the author of that message.

• To delete a threaded discussion message, the authenticated user must be the author of that message or an account administrator.