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

CollaborationGroup

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

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

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

特別なアクセスルール

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

メンバー: 「新規 Chatter グループの作成および所有」権限を持つすべてのユーザは、公開、非公開、およびリストに記載しないグループを作成できます。自分が属する任意のコミュニティへの作成も可能です。
所有者とマネージャ: ユーザは、自分が所有または管理するグループについてグループの詳細を変更できます。所有者は、自分が所有するグループを削除することもできます。
非メンバー: 次のユーザ権限があれば、グループのメンバーかどうかに関係なくグループにアクセスできます。
- 「すべてのデータの参照」— ユーザは、自分の組織とそのコミュニティにわたってすべての公開および非公開グループを参照できます。この権限を持つユーザがリストに記載しないグループの情報を参照するには、「リストに記載しないグループの編集」権限も必要です。
- 「すべてのデータの編集」— ユーザは、自分の組織とそのコミュニティにわたってすべての公開および非公開グループの参照、変更、および削除ができます。この権限を持つユーザがリストに記載しないグループの情報を参照または変更するには、「リストに記載しないグループの管理」権限も必要です。
- 「コミュニティの作成およびカスタマイズ」— ユーザは、コミュニティ内のすべての公開および非公開グループの参照、変更、および削除ができます。
- 「リストに記載しないグループの管理」— ユーザは、組織とそのコミュニティ内のすべてのリストに記載しないグループの検索、アクセス、および変更ができます。
- 「データのエクスポート」 — ユーザは Salesforce からどのデータでもエクスポートできます。これには、組織とそのコミュニティの非公開グループおよびリストに記載しないグループのデータも含まれます。
Apex および Visualforce: Apex コードはシステムモードで実行されるため、現在のユーザの権限は考慮されません。
- グループが表示される Visualforce ページでは、リストに記載しないグループまたは非公開グループのデータが、メンバーではないユーザに表示される場合があります。
- システムモードではユーザの権限が考慮されないため、グループが表示される Visualforce ページにアクセスするすべてのユーザは、そのグループの所有者のように操作できます。
- AppExchange アプリケーションが Apex で記述されており、すべてのグループにアクセスする場合、そのアプリケーションではリストに記載しないグループがメンバーではないユーザに公開されます。

組織でリストに記載しないグループおよび非公開グループへのアクセスを制限および管理する手順��、次のとおりです。

すべての Apex コードの SOQL クエリから、リストに記載しないグループおよび非公開グループの情報を明示的に除外します。
コードで権限セット、プロファイルレベルの権限、および共有チェックを使用して、グループへのアクセスをさらに制限します。
グループの作成を監視および管理するには、CollaborationGroup オブジェクトに対して Apex トリガを使用します。[設定] から、[クイック検索] ボックスに「グループトリガ」と入力し、[グループトリガ] を選択します。

項目

項目	詳細
AnnouncementId	型 reference プロパティ Create、Filter、Group、Nillable、Sort、Update 説明グループに最後に関連付けられた Announcement の ID が含まれます。この項目は API バージョン 30.0 以降で使用できます。
BannerPhotoUrl	型 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	型 string プロパティ Create、Filter、Nillable、Sort、Update 説明グループの説明。
FullPhotoUrl	型 url プロパティ Filter、Nillable、Sort 説明グループのプロファイルの写真の URL。写真がアップロードされるたびに URL が更新され、最新の写真が反映されます。新しい写真がアップロードされた場合、古い写真で返されていた URL では写真が返されることが保証されません。この項目を使って最新の写真の URL をクエリする必要があります。この項目は API バージョン 20.0 以降で使用できます。
GroupEmail	型 email プロパティ Group、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`) を示します。
IsAutoArchiveDisabled	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明グループの自動アーカイブが無効になっているか (`true`)、否か (`false`) を示します。
IsBroadcast	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明グループがブロードキャストグループか (`true`)、否か (`false`) を示します。この項目は API バージョン 36.0 以降で使用できます。
LastFeedModifiedDate	型 dateTime プロパティ Filter、Sort 説明グループへの最新の投稿またはコメントの日付。
LastReferencedDate	型 date プロパティ Filter、Nillable、Sort、Update 説明現在のユーザがこのレコードに関連するレコードを最後に表示したときのタイムスタンプ。
LastViewedDate	型 date プロパティ Filter、Nillable、Sort、Update 説明現在のユーザがこのレコードを最後に表示したときのタイムスタンプ。この値が null の場合、このレコードは参照 (LastReferencedDate) されただけで、表示はされていない可能性があります。
MediumPhotoUrl	型 url プロパティ Filter Nillable Sort 説明やや大きいトリミングされた写真のサイズの URL。
MemberCount	型 int プロパティ Filter、Group、Nillable、Sort 説明グループのメンバー数。
Name	型 string プロパティ Create、Filter、Group、Sort、Update 説明グループの名前。グループ名は、公開グループおよび非公開グループ間で一意である必要があります。リストに記載しないグループの名前は一意である必要はありません。
NetworkId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明このグループが含まれるコミュニティの ID。この項目は、Salesforce Communities が組織で有効になっている場合にのみ使用できます。 NetworkId は、グループの作成時にのみ追加できます。既存のグループの場合、NetworkId の変更や追加はできません。この項目は API バージョン 26.0 以降で使用できます。
OwnerId	型 reference プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明グループの所有者の ID。OwnerId を変更できるのは、現在のグループの所有者か「すべてのデータの編集」権限を持つユーザのみです。
SmallPhotoUrl	型 url プロパティ Filter、Nillable、Sort 説明グループのプロファイルの写真のサムネイルの URL。写真がアップロードされるたびに URL が更新され、最新の写真が反映されます。新しい写真がアップロードされた場合、古い写真で返されていた URL では写真が返されることが保証されません。この項目を使って最新の写真の URL をクエリする必要があります。この項目は API バージョン 20.0 以降で使用できます。

使用方法

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

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

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

Salesforce および Force.com のオブジェクトリファレンス

CollaborationGroup

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

特別なアクセスルール

項目

使用方法

関連項目: