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

ContentDocumentLink

Salesforce CRM Content ドキュメントや Chatter ファイルとそれを共有する場所とのリンクを表します。ファイルは、他のユーザ、Chatter グループ、レコード、Salesforce CRM Content ライブラリと共有できます。Salesforce CRM Content ドキュメントおよび Chatter ファイルでは、このオブジェクトはバージョン 21.0 以降で使用できます。

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

create()delete()describeSObjects()query()retrieve()update()

特別なアクセスルール

  • カスタマーポータルユーザおよびパートナーポータルユーザが、アクセス権を持つライブラリのコンテンツをクエリするには、「ポータルのコンテンツの参照」権限が必要です。
  • ユーザ (「すべてのデータの参照」権限を持つユーザを含む) は、自分がアクセス権を持つファイルに対してのみクエリを実行できます。次に例を挙げます。
    • ライブラリの権限に関係なく、自分がメンバーであるライブラリと個人ライブラリのすべての Salesforce CRM Content ファイル (API バージョン 17.0 以降)。
    • 自分が所有しているか、プロファイルに投稿したか、参照可能なグループに投稿したか、直接共有しているすべての Chatter ファイル (API バージョン 21.0 以降)。
  • API バージョン 33.0 以降では、フィードで追跡可能なレコードタイプの LinkedEntityIdContentDocumentLink オブジェクトを作成および削除できます。そのレコードタイプのフィード追跡が無効な場合でも同様です。組織で Chatter が有効になっている必要があります。
  • API バージョン 25.0 ~ 33.0 では、UserCollaborationGroup、または Organization 種別の LinkedEntityIdContentDocumentLink オブジェクトを作成および削除できます。
  • Communities が有効な組織の場合、ドキュメントは、ファイルが作成されたコミュニティに属するユーザおよびグループとのみ共有できます。

項目

項目 詳細
ContentDocumentId
reference
プロパティ
CreateFilterGroupSort
説明
ドキュメントの ID。
LinkedEntityId
reference
プロパティ
CreateFilterGroupSort
説明
リンクしたオブジェクトの ID。カスタムオブジェクトを含む Chatter フィード追跡をサポートする Chatter ユーザ、グループ、レコード、および Salesforce CRM Content ライブラリを含むことができます。
ShareType
picklist
プロパティ
CreateFilterGroupNillableRestricted picklistSortUpdate
説明
必須。ライブラリ内で共有されているファイルのユーザに付与される権限。これは、ライブラリ内でユーザがすでに持っている権限によって決まります。この項目は、API バージョン 25.0 以降で使用できます。
Viewer
ユーザは共有されているファイルを明示的に参照できますが、編集することはできません。
Collaborator
ユーザは共有されているファイルを明示的に参照、編集できます。
Inferred
ユーザの権限は関連するレコードによって決まります。ライブラリとの共有の場合、これはユーザがそのライブラリで持つ権限によって定義されます。
Visibility
picklist
プロパティ
CreateFilterGroupNillableSort
説明
このフィード項目を使用できるのが、すべてのユーザ、内部ユーザ、共有ユーザのいずれであるかを指定します。この項目は、API バージョン 26.0 以降で使用できます。
Visibility には、次の値があります。
  • AllUsers — このフィード項目は、この項目を参照する権限を持つすべてのユーザが使用できます。
  • InternalUsers — このフィード項目は内部ユーザのみが使用できます。
  • SharedUsers — このフィード項目は、このフィード項目が投稿されたフィードを表示できるすべてのユーザが使用できます。SharedUsers 値は、API バージョン 32.0 以降で使用できます。
Visibility の例外について、次の点に注意してください。
  • レコードフィードへの投稿の場合、Visibility はデフォルトですべての内部ユーザに対して InternalUsers に設定されています。
  • 外部ユーザは VisibilityAllUsers にのみ設定できます。
  • ユーザおよびグループ投稿では、内部ユーザのみが VisibilityInternalUsers に設定できます。
  • ユーザフィードへの投稿の場合、ユーザ共有に関する組織全体のデフォルトが非公開に設定されていると、VisibilitySharedUsers に設定されます。

レコード投稿での ContentDocumentLink の表示設定は、そのレコード上のリンクの最高表示レベルに基づいています。

使用方法

このオブジェクトを使用して、ファイルを共有する場所をクエリしたり、特定の場所にリンクされているファイルをクエリしたりします。たとえば、次のクエリは Chatter グループで共有される特定のドキュメントを返します。

1SELECT ContentDocument.title FROM ContentDocumentLink WHERE ContentDocumentId = '069D00000000so2' AND LinkedEntityId = '0D5000000089123'
  • ContentDocumentLink に対する条件なしでは、クエリを実行することはできません。
  • ContentDocumentId で条件検索している場合は、ContentDocument 項目で条件検索することはできません。LinkedEntityId で条件検索している場合は、ContentDocument 項目でのみ条件検索することができます。
  • 関連オブジェクト項目で条件検索することはできません。たとえば、ファイルのリンク先の取引先のプロパティで条件検索をすることはできません。タイトル項目などのファイルのプロパティでは検索条件できます。
SOQL クエリの絞り込みでは、IdContentDocumentIdLinkedEntityId のいずれかを条件にする必要があります。