この文章は 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 以降で使用できます。
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 を使って招待を送信するためにグループのメンバーである必要はありません。