Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Announcement

Represents a Chatter group announcement. This object is available in API version 30.0 and later.

Supported Calls

create(), delete(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), undelete(), update(), upsert()

Fields

Field Name	Details
ExpirationDate	Type dateTime Properties Create, Filter, Sort, Update Description Required. The date on which the announcement expires. Announcements display on the group UI until 11:59 p.m. local time on the selected date.
FeedItemId	Type reference Properties Create, Filter, Group, Sort Description Required. The ID of the FeedItem that contains the content of the announcement. Announcements are stored as text posts. This is a relationship field. Relationship Name FeedItem Relationship Type Lookup Refers To FeedItem
ParentId	Type reference Properties Filter, Group, Nillable, Sort Description The ID of the parent CollaborationGroup that the announcement belongs to. An announcement can belong only to a single Chatter group. This is a relationship field. Relationship Name Parent Relationship Type Lookup Refers To CollaborationGroup
SendEmails	Type boolean Properties Defaulted on create, Filter, Group, Sort Description Set to `true` to email all group members when an announcement is posted to the group. The default is `false`. This requires the user to have the “Send announcement on email” permission. This field is available in API version 36.0 and later. This field is currently available to select customers through a pilot program. To be nominated to join this pilot program, contact Salesforce. Additional terms and conditions may apply to participate in the pilot program. Please note that pilot programs are subject to change, and as such, we cannot guarantee acceptance into this pilot program or a particular time frame in which this feature can be enabled. Any unreleased services or features referenced in this document, press releases, or public statements are not currently available and may not be delivered on time or at all. Customers who purchase our services should make their purchase decisions based upon features that are currently available. Note

Usage

Group owners, managers, and users with the “Modify All Data” permission can use the Announcement object to create, edit, and delete group announcements. Creating a group announcement is a three-step process.

Use the FeedItem object to create a text post with the announcement’s content. Use the CollaborationGroup record you want to post the announcement to as the parent of this feed item.
Next, use the feed item ID and an expiration date to create the announcement record.
Finally, update the AnnouncementId field in the CollaborationGroup record with the ID of the announcement you created.

To delete the group announcement, simply delete the AnnouncementId value in the CollaborationGroup record. To restore a group announcement, update the AnnouncementId field for a group with the announcement’s ID. The expiration date for the announcement should be in the future and the feed item used to create the announcement should be parented by the same group.

Object Reference for the Salesforce Platform

Announcement

Supported Calls

Fields

Usage