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

ContentDocument

Salesforce CRM Content のライブラリにアップロードされたドキュメントまたは Salesforce Files を表します。Salesforce CRM Content では、バージョン 17.0 以降でこのオブジェクトを使用できます。Salesforce Files では、API バージョン 21.0 以降でこのオブジェクトを使用できます。
公開できる最大ドキュメント数は 30,000,000 です。アーカイブされたファイルは、この制限とディスク使用量制限にカウントされます。
  • Contact Manager Edition、Group Edition、Professional Edition、Enterprise Edition、Unlimited Edition、および Performance Edition を使用するお客様は、24 時間につき最大で 200,000 件の新しいバージョンを公開できます。
  • Developer Edition とトライアル版のお客様は、24 時間につき最大で 2,500 件の新しいバージョンを公開できます。

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

delete()describeLayout()describeSObjects()query()retrieve()search()undelete()update()

特別なアクセスルール

  • カスタマーポータルユーザおよびパートナーポータルユーザが、アクセス権を持つライブラリのコンテンツを照会するには、「ポータルのコンテンツの参照」権限が必要です。
  • ユーザ (「すべてのデータの参照」権限を持つユーザを含む) は、自分がアクセス権を持つファイルに対してのみクエリを実行できます。次に例を挙げます。
    • ライブラリの権限に関係なく、自分がメンバーであるライブラリと個人ライブラリのすべての Salesforce CRM Content ファイル (API バージョン 17.0 以降)。
    • 自分が所有しているか、プロファイルに投稿したか、参照可能なグループに投稿したか、直接共有しているすべての Salesforce Files (API バージョン 21.0 以降)。
  • 次のいずれかに該当する場合、Salesforce CRM Content ドキュメントを削除できます。
    • ドキュメントが個人ライブラリに公開されているか、またはユーザのアップロードキューである。
    • ドキュメントが公開ライブラリに公開され、ユーザが「コンテンツの追加」ライブラリ権限の有効なライブラリのメンバーで、ドキュメントを削除しようとしているユーザが所有者である。
    • ドキュメントが、「コンテンツの削除」または「ライブラリの管理」権限が有効な公開ライブラリに公開され、ドキュメントを削除しようとしているユーザが所有者でない。
API バージョン 25.0 以降では、Salesforce Files および Salesforce CRM Content ドキュメントの所有権を変更できます。
  • Salesforce CRM Content ドキュメントの所有権を変更するには、次の条件を満たす必要があります。
    • Salesforce CRM Content アプリケーションが有効化されている。
    • ドキュメントの所有者になるユーザは、Salesforce CRM Content 機能のライセンスを持っている。
  • 次のいずれかの条件を満たす場合、ユーザは Salesforce CRM Content ドキュメントまたは Salesforce ファイルの所有権を変更できます。
    • ユーザが現在の所有者であるか、ユーザのプロファイルで「すべてのデータの編集」権限または「Salesforce CRM Content の管理」権限のいずれかが有効化されている。
    • ユーザのプロファイルでそのドキュメントを含むライブラリに対する「ライブラリの管理」権限が有効化されている。
    • ドキュメントの所有者になるユーザは、有効で表示可能なユーザである必要がありますが、元の所有者は無効なユーザでもかまいません。
    • ドキュメントの所有者を、ドキュメントを含むライブラリへのアクセス権を持たないユーザに変更できます。ライブラリ管理者はライブラリに新しい所有者メンバーシップを付与する必要がある場合があります。

    メモ

項目

項目 詳細
ArchivedById
reference
プロパティ
Filter、Group、Nillable、Sort
説明
ドキュメントをアーカイブしたユーザの ID。

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

ArchivedDate
date
プロパティ
Filter、Group、Nillable、Sort
説明
ドキュメントがアーカイブされた日付。

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

ContentAssetId
reference
プロパティ
Filter、Group、Nillable、Sort、Update
説明
ContentDocument がアセットファイルの場合は、この項目がアセットを指し示します。この項目の値は、ほとんどのエンティティで null です。

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

ContentModifiedDate
dateTime
プロパティ
Filter、Nillable、Sort
説明
ドキュメントが変更された日付。

ContentModifiedDate は、ドキュメントの名前が変更されたり、新規ドキュメントバージョンがアップロードされたりした場合などに更新されます。ドキュメントの最初のバージョンをアップロードするとき、ContentModifiedDate は現在時刻または過去の任意の時刻に設定できます。

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

ContentSize
int
プロパティ
Filter、Group、Nillable、Sort
説明

ドキュメントのサイズをバイトで表したものです。

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

Description
textarea
プロパティ
Filter、Nillable、Sort
説明

ドキュメントの説明。

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

Division
picklist
プロパティ
Defaulted on create、Filter、Group、Restricted picklist、Sort
説明
組織のデータの論理セグメントです。たとえば、会社がさまざまな事業単位によって構成されている場合、「北米」、「ヘルスケア」、「コンサルティグ」など、各事業単位のディビジョンを作成することができます。組織でディビジョン権限が有効化されている場合にのみ使用可能です。
FileExtension
string
プロパティ
Filter、Group、Nillable、Sort
説明

ドキュメントのファイル拡張子。

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

FileType
string
プロパティ
Filter、Group、Nillable、Sort
説明

拡張子によって決まるドキュメントの種類。

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

IsArchived
boolean
プロパティ
Defaulted on create、Filter、Group、Sort、Update
説明
ドキュメントがアーカイブされているか (true)、否か (false) を示します。
LastReferencedDate
date
プロパティ
Filter、Nillable、Sort、Update
説明
現在のユーザがこのレコードに関連するレコードを最後に表示したときのタイムスタンプ。
LastViewedDate
date
プロパティ
Filter、Nillable、Sort、Update
説明
現在のユーザがこのレコードを最後に表示したときのタイムスタンプ。この値が null の場合、このレコードは参照 (LastReferencedDate) されただけで、表示はされていない可能性があります。
LatestPublishedVersionId
reference
プロパティ
Filter、Group、Nillable、Sort
説明
最新ドキュメントバージョンの ID (ContentVersion)。
OwnerId
reference
プロパティ
Filter、Group、Sort、Update
説明
このドキュメントの所有者の ID。
ParentId
reference
プロパティ
Filter、Group、Nillable、Sort、Update
説明
ドキュメントを所有するライブラリの ID。API を使って初めて ContentVersion が挿入されるときに自動的に作成されます。

Salesforce CRM Content が有効化されている場合、この項目は API バージョン 24.0 以降で使用できます。

PublishStatus
picklist
プロパティ
Defaulted on create、Filter、Group、Restricted picklist、Sort
説明
ドキュメントが公開されているかどうか、そしてその公開方法を示します。有効な値は、次のとおりです。
  • P — ドキュメントは公開ライブラリに公開され、他のユーザも参照できます。表示ラベルは Public です。
  • R — ドキュメントは個人ライブラリに公開され、他のユーザは参照できません。表示ラベルは Personal Library です。
  • U — 公開が中断されたため、ドキュメントは公開されません。表示ラベルは Upload Interrupted です。
SharingOption
picklist
プロパティ
Defaulted on create、Filter、Group、Restricted picklist、Sort、Update
説明
ファイルの共有が凍結されるかどうかを制御します。ファイルに対する「コラボレータ」アクセス権のあるシステム管理者とファイル所有者のみが、この項目を変更できます。デフォルトは Allowed で、新しい共有が可能であることを意味します。Restricted に設定されているときは新しい共有が阻止されますが、既存の共有には影響ありません。

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

SharingPrivacy
picklist
プロパティ
Defaulted on create、Filter、Group、Restricted picklist、Sort、Update
説明
ファイルの共有プライバシーを制御します。ファイルに対する「コラボレータ」アクセス権のあるシステム管理者とファイル所有者のみが、この項目を変更できます。デフォルトは [レコードへのアクセス権を持つすべてのユーザが参照可能] です。[レコードで非公開] に設定された場合、ファイルはレコードで非公開になりますが、他のユーザと選択的に共有できます。

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

Title
string
プロパティ
Filter、Group、Sort
説明

ドキュメントのタイトル。

使用方法

  • このオブジェクトを使用して、ライブラリのドキュメント (コンテンツパックを除く) または Salesforce ファイルの最新バージョンを取得、クエリ、更新、削除します。ContentVersion オブジェクトを使用して、Salesforce CRM Content ドキュメントまたは Salesforce ファイルの特定のバージョンを作成、クエリ、取得、検索、編集、更新します。
  • query() コールは、アーカイブされたドキュメントを返しません。queryAll() コールは、アーカイブされたドキュメントを返します。
  • アーカイブ済みドキュメントの新しいバージョンを追加することはできません。
  • レコードとのみ共有されているファイルを照会するには、ファイルのコンテンツ ID を指定する必要があります。
  • ドキュメントを作成するには、ContentDocumentId を設定しないで、ContentVersion を使用して新しいバージョンを作成します。このプロセスにより、親ドキュメントレコードが自動的に作成されます。ドキュメントの新しいバージョンを追加する場合、ドキュメントの修正プロセスを開始する既存の ContentDocumentId を指定する必要があります。最新バージョンが公開されると、ドキュメントのタイトル、所有者、公開状況の項目が更新されます。
  • ドキュメントを削除すると、評価、コメント、タグを含むドキュメントのすべてのバージョンが削除されます。
  • API を使用して、コンテンツパッケージを作成、編集または削除することはできません。

    タグ、カスタム項目、コンテンツ所有者のようなコンテンツメタデータは、ドキュメントレベルではなく、バージョンレベルで記録されます。

    メモ

  • API でバージョンを照会する場合、Upload InterruptedPublishStatus を指定したバージョンは返されません。
  • ドキュメントレコードは複数のバージョンのレコードのコンテナです。システムにドキュメントを追加するには、新しいバージョンを作成します。新しいバージョンには実際のファイルデータが含まれます。これにより、ドキュメントに複数のバージョンを含むことができます。このバージョンにはアップロードされたドキュメントの本文が格納されます。
  • トピックを ContentDocument に割り当てるには API バージョン 37.0 以降の TopicAssignment を使用します。