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 Messages.	`threaded_messages`
Supported Commands	`Add`, `Read`, `Modify`, `Delete`	`add()`, `read()`, `modify()`, `upsert()`, `delete()`	See Available methods.	-

XML

SOAP

REST

Database table

Object

ThreadedMessage

oaThreadedMessage

ThreadedMessage

See Threaded Discussion Messages.

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.

XML / SOAP

REST

Database

Description

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

[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

[Read-only] A 1/0 field indicating if the message was edited.

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

[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.