この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

CollaborationGroup

Chatter グループを表します。このオブジェクトは、API バージョン 19.0 以降で使用できます。

サポートされているコール

create()、delete()、describeLayout()、describeSObjects()、query()、retrieve()、search()、update()、upsert()

特別なアクセスルール

グループ内の情報の表示設定は、グループの種別とユーザの権限に応じて異なります。

  • メンバー: 「新規 Chatter グループの作成および所有」権限を持つすべてのユーザは、公開、非公開、およびリストに��載しないグループを作成できます。自分が属する任意の Experience Cloud サイトへの作成も可能です。
  • 所有者とマネージャ: ユーザは、自分が所有または管理するグループについてグループの詳細を変更できます。所有者は、自分が所有するグループを削除することもできます。
  • 非メンバー: 次のユーザ権限があれば、グループのメンバーかどうかに関係なくグループにアクセスできます。
    • すべてのデータの参照 — ユーザは、自分の組織とその Experience Cloud サイトにわたってすべての公開および非公開グループを参照できます。この権限を持つユーザがリストに記載しないグループの情報を参照するには、「リストに記載しないグループの編集」権限も必要です。
    • すべてのデータの編集 — ユーザは、自分の組織とその Experience Cloud サイトにわたってすべての公開および非公開グループの参照、変更、および削除ができます。この権限を持つユーザがリストに記載しないグループの情報を参照または変更するには、「リストに記載しないグループの管理」権限も必要です。
    • エクスペリエンスの作成および設定 — ユーザは、Experience Cloud サイト内のすべての公開および非公開グループの参照、変更、および削除ができます。
    • リストに記載しないグループの管理 — ユーザは、組織とその Experience Cloud サイト内のすべてのリストに記載しないグループの検索、アクセス、および変更ができます。
    • データのエクスポート — ユーザは Salesforce からどのデータでもエクスポートできます。これには、組織とその Experience Cloud サイトの非公開グループおよびリストに記載しないグループのデータも含まれます。
  • Apex および Visualforce: Apex コードはシステムモードで実行されるため、現在のユーザの権限は考慮されません。
    • グループが表示される Visualforce ページでは、リストに記載しないグループまたは非公開グループのデータが、メンバーではないユーザに表示される場合があります。
    • システムモードではユーザの権限が考慮されないため、グループが表示される Visualforce ページにアクセスするすべてのユーザは、そのグループの所有者のように操作できます。
    • AppExchange アプ���ケーションが Apex で記述されており、すべてのグループにアクセスする場合、そのアプリケーションではリストに記載しないグループがメンバーではないユーザに公開されます。
組織でリストに記載しないグループおよび非公開グループへのアクセスを制限および管理する手順は、次のとおりです。
  • すべての Apex コードの SOQL クエリから、リストに記載しないグループおよび非公開グループの情報を明示的に除外します。
  • コードで権限セット、プロファイルレベルの権限、および共有チェックを使用して、グループへのアクセスをさらに制限します。
  • グループの作成を監視および管理するには、CollaborationGroup オブジェクトに対して Apex トリガを使用します。[設定] から、[クイック検索] ボックスに「グループトリガ」と入力し、[グループトリガ] を選択してトリガを追加します。

項目

項目 詳細
AnnouncementId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
グループに最後に関連付けられた Announcement の ID が含まれます。この項目は、API バージョン 30.0 以降で使用できます。
これはリレーション項目です。
リレーション名
Announcement
リレーション種別
Lookup
参照先
Announcement
型
url
プロパティ
Filter、Nillable、Sort
説明
グループのバナー写真の URL。

写真がアップロードされるたびに URL が更新され、最新の写真が反映されます。新しい写真がアップロードされた場合、古い写真で返されていた URL では写真が返されることが保証されません。この項目を使用して最新の写真の URL を照会してください。

この項目は、API バージョン 36.0 以降で使用できます。

CanHaveGuests
型
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
true に設定されている場合、グループが顧客を許可していることを示します。Chatter 顧客とは、会社のメールドメイン外のユーザです。顧客には、招待されたグループのみが表示されます。それらのグループの他のメンバーのみとやり取りできます。顧客に Salesforce 情報は表示されません。

この項目は、API バージョン 23.0 以降で使用できますが、顧客を許可しているグループは、以前の API バージョンからアクセスできます。ただし、以前の API バージョンからアクセスする場合、顧客を許可しているグループは、非公開グループと区別できません。最新の API バージョンにアップグレードすることを強くお勧めします。以前のバージョンを使用する必要がある場合、顧客を許可しているグループに、顧客が含まれることを示す名前を付けてください。

CollaborationType
型
picklist
プロパティ
Create、Filter、Group、Restricted picklist、Sort、Update
説明
Chatter グループの種類。選択可能な値は次のとおりです。
  • Public — 誰でも更新の参照と投稿ができます。公開グループには誰でも参加できます。
  • Private — グループフィードの参照と更新の投稿ができるのはメンバーのみです。リストビュー、検索、およびグループページで非メンバーに表示されるのは、グループ名とその他いくつかの詳細のみです。グループへの参加を要求するメンバーの追加は、グループの所有者またはマネージャが行う必要があります。
  • Unlisted — グループの参照と更新の投稿ができるのは、メンバーと「リストに記載しないグループの管理」権限を持つユーザのみです。他のユーザの場合、グループにアクセスできず、リスト、検索、フィードにグループは表示されません。
Description
型
textarea
プロパティ
Create、Filter、Nillable、Sort、Update
説明
グループの説明。
FullPhotoUrl
型
url
プロパティ
Filter、Nillable、Sort
説明
グループのプロファイルの写真の URL。

写真がアップロードされるたびに URL が更新され、最新の写真が反映されます。新しい写真がアップロードされた場合、古い写真で返されていた URL では写真が返されることが保証されません。この項目を使用して最新の写真の URL を照会してください。

この項目は、API バージョン 20.0 以降で使用できます。

GroupEmail
型
email
プロパティ
Nillable、Sort
説明
グループに投稿するためのメールアドレス。非公開グループで「すべてのデータの編集」権限と「すべてのデータの参照」権限を持つメンバーとユーザのみが表示できます。

この項目は、API バージョン 29.0 以降で使用できます。

HasPrivateFieldsAccess
型
boolean
プロパティ
Defaulted on create、Filter、Group、Sort
説明
true に設定されている場合、非公開グループの InformationBody 項目および InformationTitle 項目を表示できることを示します。この項目は、「すべてのデータの編集」権限または「すべてのデータの参照」権限を持つ非公開グループのメンバーおよびユーザについて true に設定します。
InformationBody
型
textarea
プロパティ
Create、Nillable、Update
説明
[情報] セクションのテキスト。非公開グループで「すべてのデータの編集」権限と「すべてのデータの参照」権限を持つメンバーとユーザのみが表示できます。
InformationTitle
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
[情報] セクションのタイトル。非公開グループで「すべてのデータの編集」権限と「すべてのデータの参照」権限を持つメンバーとユーザのみが表示できます。
IsArchived
型
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
グループがアーカイブ済みか (true)、否か (false) を示します。

この項目は、API バージョン 28.0 以降で使用できます。

IsAutoArchiveDisabled
型
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
グループの自動アーカイブが無効になっているか (true)、否か (false) を示します。

この項目は、API バージョン 29.0 以降で使用できます。

IsBroadcast
型
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
グループがブロードキャストグループか (true)、否か (false) を示します。

この項目は、API バージョン 36.0 以降で使用できます。

LastFeedModifiedDate
型
dateTime
プロパティ
Filter、Sort
説明
グループへの最新の投稿またはコメントの日付。
LastReferencedDate
型
datetime
プロパティ
Filter、Nillable、Sort
説明
現在のユーザがこのレコードに関連するレコードを最後に表示したときのタイムスタンプ。
LastViewedDate
型
datetime
プロパティ
Filter、Nillable、Sort
説明
現在のユーザがこのレコードを最後に表示したときのタイムスタンプ。この値が null の場合、このレコードは参照 (LastReferencedDate) されただけで、表示はされていない可能性があります。
MediumPhotoUrl
型
url
プロパティ
Filter、Nillable、Sort
説明
やや大きいトリミングされた写真のサイズの URL。
MemberCount
型
int
プロパティ
Filter、Group、Nillable、Sort
説明
グループのメンバー数。
Name
型
string
プロパティ
Create、Filter、Group、idLookup、Sort、Update
説明
グループの名前。グループ名は、公開グループおよび非公開グループ間で一意である必要があります。リストに記載しないグループの名前は一意である必要はありません。
NetworkId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort
説明
このグループが含まれる Experience Cloud サイトの ID。この項目は、デジタルエクスペリエンスが組織で有効になっている場合にのみ使用できます。

NetworkId は、グループの作成時にのみ追加できます。既存のグループの場合、NetworkId の変更や追加はできません。この項目は、API バージョン 26.0 以降で使用できます。

OwnerId
型
reference
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
グループの所有者の ID。OwnerId を変更できるのは、現在のグループの所有者か「すべてのデータの編集」権限を持つユーザのみです。
これはリレーション項目です。
リレーション名
Owner
リレーション種別
Lookup
参照先
User
SmallPhotoUrl
型
url
プロパティ
Filter、Nillable、Sort
説明
グループのプロファイルの写真のサムネイルの URL。

写真がアップロードされるたびに URL が更新され、最新の写真が反映されます。新しい写真がアップロードされた場合、古い写真で返されていた URL では写真が返されることが保証されません。この項目を使用して最新の写真の URL を照会してください。

この項目は、API バージョン 20.0 以降で使用できます。

使用方法

このオブジェクトを使用して、組織または Experience Cloud サイト内のグループを作成、編集、または削除します。グループを永久に削除すると、グループのすべての投稿およ��コメントも削除されます。さらに、グループに投稿されたすべてのファイルとリンクが削除され、��のファイル共有場所からファイルが削除されます。

Chatter グループメンバーとして、CollaborationGroupFeed オブジェクトを使用してグループに投稿できます。Chatter グループの所有者またはマネージャは、CollaborationGroupMember オブジェクトを使用してグループメンバーを追加または削除できます。また、Announcement オブジェクトを使用してグループにお知らせを投稿したり、CollaborationGroupMemberRequest オブジェクトを使用して非公開グループへの参加要求を受諾または拒否したりできます。さらに、グループの所有者、マネージャ、または Salesforce システム管理者は、CollaborationInvitation オブジェクトを使用して、グループにユーザを招待できます。

Salesforce システム管理者は、API を使って招待を送信するためにグループのメンバーである必要はありません。

関連付けられたオブジェクト

このオブジェクトには次の関連するオブジェクトがあります。特に記載がない限り、これらはこのオブジェクトと同じ API バージョンで使用できます。

CollaborationGroupFeed
このオブジェクトにはフィード追跡を利用できます。