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

Case

顧客の懸案事項または問題であるケースを表します。

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

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

項目

項目 詳細
AccountId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
ケースと関連付けられた Account の ID。
これはリレーション項目です。
リレーション名
Account
リレーション種別
Lookup
参照先
Account
BusinessHoursId
型
reference
プロパティ
Create、Filter、Group、Sort、Update
説明
このケースに関連付けられた営業時間の ID。
Comments
型
textarea
プロパティ
Create、Delete、Layout、Nillable、Query、Retrieve、Search、Sort、Undelete、Update
説明
新しい CaseComment を挿入するために使用します。メールのテキストエリアの長さは 4,000 文字です。
CaseNumber
型
string
プロパティ
Autonumber、Defaulted on create、Filter、idLookup、Sort
説明
ケースが挿入されると自動的に割り当てられます。直接設定できず、ケースが作成されると変更することができません。
ClosedDate
型
dateTime
プロパティ
Filter、Nillable、Sort
説明
ケースがクローズした日時。
CommunityId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort
説明
このケースと関連付けられたゾーンの ID。

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

ConnectionReceivedId
型
reference
プロパティ
Filter、Group、Nillable、Sort
説明
組織とこのレコードを共有した PartnerNetworkConnection の ID。この項目は、Salesforce to Salesforce が有効な場合に使用できます。
ConnectionSentId
型
reference
プロパティ
Filter、Group、Nillable、Sort
説明
このレコードを共有した PartnerNetworkConnection の ID。この項目は、Salesforce to Salesforce が有効な場合に使用できます。この項目は、API バージョン 15.0 以前を使用する場合にサポートされます。他の API バージョンでは、この項目の値は null です。レコードを接続に転送するには、新しい PartnerNetworkRecordConnection を使用します。
ContactEmail
型
email
プロパテ���
Filter、Group、Nillable、Sort
説明
取引先責任者のメールアドレス。Case.ContactEmail 項目は取引先責任者のメール項目を表示し、Case.ContactId はこれを参照します。表示ラベルは [取引先責任者 メール] です。この項目は、API バージョン 38.0 以降で使用できます。
ContactFax
型
phone
プロパティ
Filter、Group、Nillable、Sort
説明
取引先責任者の FAX 番号。表示ラベルは [取引先責任者 Fax] です。この項目は、API バージョン 38.0 以降で使用できます。
ContactId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
関連付けられた取引先責任者の ID。
これはリレーション項目です。
リレーション名
Contact
リレーション種別
Lookup
参照先
Contact
ContactMobile
型
phone
プロパティ
Filter、Group、Nillable、Sort
説明
取引先責任者の携帯電話番号。表示ラベルは [取引先責任者 携帯] です。この項目は、API バージョン 38.0 以降で使用できます。
ContactPhone
型
phone
プロパティ
Filter、Group、Nillable、Sort
説明
取引先責任者の電話番号。表示ラベルは [取引先責任者 電話] です。この項目は、API バージョン 38.0 以降で使用できます。
CreatorFullPhotoUrl
型
string
プロパティ
Filter、Group、Nillable、Sort
説明

フィードのユーザのプロファイル写真の URL。この項目を表示するには、Chatter アンサーを有効にする必要があります。この項目は、API バージョン 26.0 以降で使用できます。

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

質問または返信を投稿したユーザの名前。ポータルユーザには内部ユーザ (エージェント) の名のみがフィードに表示されます。この項目を表示するには、Chatter アンサーを有効にする必要があります。この項目は、API バージョン 26.0 以降で使用できます。

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

フィードのユーザのサムネイル写真の URL。この項目を表示するには、Chatter アンサーを有効にする必要があります。この項目は、API バージョン 26.0 以降で使用できます。

Description
型
textarea
プロパティ
Create、Nillable、Update
説明
ケースのテキストによる説明。最大 32 KB です。
FeedItemId
型
reference
プロパティ
Create、Group、Nillable、Sort
説明
このケースに関連付けられている Chatter の質問の ID。この項目は API バージョン 33.0 以降で使用でき、質問-to-ケースが有効な組織でのみアクセスできます。
HasCommentsUnreadByOwner
型
boolean
プロパティ
Defaulted on create、Filter、Group、Sort
説明
ケースにケース所有者がまだ読み取っていないコメントがあるか (true)、否か (false) を示します。
HasSelfServiceComments
型
boolean
プロパティ
Defaulted on create、Filter、Group、Sort
説明
ケースにセルフサービスユーザが追加したコメントがあるか (true)、否か (false) を示します。カスタマーポータルが有効化されている場合にのみ表示されます。
IsClosed
型
boolean
プロパティ
Defaulted on create、Filter、Group、Sort
説明
ケースがクローズしているか (true)、否か (false) を示します。この項目は、Status 項目によって制御されています。直接設定することはできません。表示ラベルは Closed です。
IsClosedOnCreate
型
boolean
プロパティ
Defaulted on create、Filter、Group、Sort
説明
このケースが作成されたのと同時に終了したか (true)、否か (false) を示します。このフラグは参照のみ���、レコード作成時に自動的に設定されます。IsClosed フラグが true でない限り、true に設定することはできません。
IsDeleted
型
boolean
プロパティ
Defaulted on create、Filter
説明
オブジェクトがごみ箱に移動したか (true)、否か (false) を示します。表示ラベルは [削除済み] です。
IsEscalated
型
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
ケースがエスカレーションされたか (true)、否かを示します。ケースのエスカレーションされた状態は、ケースをどのように使用できるか、ケースをクエリ、削除、更新できるかどうかに影響しません。このフラグは API を使用して設定できます。表示ラベルは [エスカレーション済み] です。
IsSelfServiceClosed
型
boolean
プロパティ
Defaulted on create、Filter、Group、Sort
説明
セルフサービスユーザのケースがクローズしているか (true)、否か (false) を示します。
IsStopped
型
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
ケースのエンタイトルメントプロセスが終了しているか (true)、否か (false) を示します。
IsVisibleInSelfService
型
boolean
プロパティ
Defaulted on create、Filter、Group、Sort
説明
カスタマーサービスポータル、パートナーサービスポータル、セルフサービスポータルにケースを表示できるか (true)、否か (false) を示します。この項目は、パートナー関係の管理、カスタマーサービスポータル、セルフサービスポータルの前のバージョンのケースの表示に適用されます。ポータルユーザが参照・更新アクセス権を持つ場合、項目は共有を変更せず、ケースへのダイレクト URL の使用を阻止しません。
Language
型
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
ケースの言語。Language 項目が使用可能になるのは、Service Cloud が付属する Enterprise、Performance、および Unlimited Edition 組織で Einstein ケース分類を有効にしたときです。デフォルトでは、この項目を使用するのは、Einstein 分類アプリケーションのみです。
LastReferencedDate
型
datetime
プロパティ
Filter、Nillable、Sort
説明
現在のユーザがこのレコード、このレコードに関連するレコード、またはリストビューに最後にアクセスしたときのタイムスタンプ。
LastViewedDate
型
datetime
プロパティ
Filter、Nillable、Sort
説明
現在のユーザがこのレコードまたはリストビューを最後に表示したときのタイムスタンプ。この値が null の場合、ユーザはこのレコードまたはリストビューにアクセスしただけで (LastReferencedDate) 表示していない可能性があります。
MasterRecordId
型
reference
プロパティ
Filter、Group、Nillable、Sort
説明
このオブジェクトが結合の結果として削除された場合、この項目には保存されたレコードの ID が入力されます。他の理由でこのオブジェクトが削除された場合、または削除されていない場合、値は null となります。
これはリレーション項目です。
リレーション名
MasterRecord
リレーション種別
Lookup
参照先
Case
Origin
型
picklist
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
Email、Phone、Web など、ケースの取得元。表示ラベルは [Case Origin] です。
OwnerId
型
reference
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
ケースを所有する取引先責任者の ID。
これは多態的なリレーション項目です。
リレーション名
Owner
リレーション種別
Lookup
参照先
Group、User
ParentId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
階層内の親ケースの ID。表示ラベルは [Parent Case] です。
これはリレーション項目です。
リレーション名
Parent
リレーション種別
Lookup
参照先
Case
Priority
型
picklist
プロパティ
Create、Defaulted on create、Filter、Group、Nillable、Sort、Update
説明
High、Medium、Low など、ケースの重要度または緊急度���
QuestionId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
ケースに関連付けられているアンサーゾーンの質問。この項目は、有効になっているアンサーゾーンがない場合は、表示されません。
Reason
型
picklist
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
Instructions not clear または User didn’t attend training など、ケースが作成された理由。
RecordTypeId
型
reference
プロパティ
Create、Filter、Nillable、Update
説明
このオブジェクトに割り当てられるレコードタイプの ID。
SlaStartDate
型
dateTime
プロパティ
Create、Filter、Nillable、Sort、Update
説明
ケースがエンタイトルメントプロセスを開始した時刻を示します。ケースに対する「編集」権限を持っている場合、時刻を更新またはリセットできます。

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

SourceId
型
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
ソーシャル投稿元の ID。
Status
型
picklist
プロパティ
Create、Defaulted on create、Filter、Group、Nillable、Sort、Update
説明
「新規」、「クローズ」、「エスカレーション済み」など、ケースの状況。この項目は、IsClosed フラグを直接制御します。それぞれの事前定義された Status 値は、IsClosed フラグ値を意味します。詳細は、「CaseStatus」を参照してください。
StopStartDate
型
dateTime
プロパティ
Filter、Nillable、Sort
説明
ケースのエンタイトルメントプロセスが停止した日時。

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

Subject
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
ケースの件名です。最大 255 文字です。
SuppliedCompany
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
ケース作成時に入力された会社名。表示ラベルは [会社] です。
SuppliedEmail
型
email
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
ケース作成時に入力されたメールアドレス。表示ラベルは [メール] です。

組織に有効な自動レスポンスルールがある場合、API を使用してケースを作成する場合は SuppliedEmail が必要です。自動レスポンスルールでは、ContactId で指定された取引先責任者のメールを使用します。取引先責任者レコードにメールアドレスがない場合、ここで指定されたメールが使用されます。

SuppliedName
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
ケース作成時に入力された名前。表示ラベルは [名前] です。
SuppliedPhone
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
ケース作成時に入力された電話番号。表示ラベルは [電話] です。
Type
型
picklist
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
Feature Request または Question など、ケースの種類。

Case データをインポートし、CreatedDate など、監査項目に値を設定する必要がある場合、Salesforce にご連絡ください。これらの項目を自身で設定する必要がない限り、監査項目は API 操作時に自動的に更新されます。

メモ

使用方法

Case オブジェクトを使用して、���織のケースを管理します。クライアントアプリケーションは、API を使用してケースに関連付けられた Attachment レコードをクエリ、更新、削除できます。

割り当てルール

ケースをクエリまたは更新すると、クライアントアプリケーションは、ユーザインターフェースで設定された割り当てルールに基づいて、ケースを 1 つ以上の User レコードに自動的に割り当てることができます。この機能を使用するために、クライアントアプリケーションは、create または update で使用する AssignmentRuleHeader に次のオプションのいずれか (両方ではない) を設定する必要があります。

項目 項目の型 詳細
assignmentRuleId reference 使用する割り当てルールの名前。無効な割り当てルールの場合があります。指定されていない場合および useDefaultRule が true の場合、デフォルトの割り当てルールが使用されます。指定された割り当てルールの ID を検索するには、AssignmentRule オブジェクトをクエリ (RuleType="caseAssignment" を指定)、返される AssignmentRule オブジェクトを反復、使用する割り当てルールを検索してその ID を取得し、AssignmentRuleHeader のこの項目に取得した ID を設定します。
useDefaultRule boolean ルールに基づいた割り当てのデフォルトルールを使用するか (true)、否か (false) を示します。デフォルトルールは、Salesforce ユーザインターフェースでユーザによって割り当てられます。

Lead の AssignmentRuleHeader の設定 (Case の AssignmentRuleHeader の設定と同様) を示すコード例については、Lead を参照してください。

ケースの取引先と取引先責任者の分割

リリース 8.0 より前では、AccountId を指定できず、取引先責任者の取引先から取得されていました。この処理は、今後のリリースでもサポートが継続されていますが、現在では AccountId を指定することができます。ケースの作成時に AccountId を指定しない場合、値は取引先の AccountId にデフォルト設定されます。

レコードを更新するとき、ContactId が変更されない場合、AccountId は再生成されません。これにより、API が、Salesforce ユーザインターフェースで以前変更された値を上書きしないようにします。ただし、API コールが ContactId を変更して AccountId 項目が空欄である場合、AccountId は取引先責任者の取引先を使用して生成されます。

メモ

Java での _case の使用

case は Java の予約語であるため、使用する開発ツールによっては、Case の代わりに _case を使用してアプリケーションを更新する必要があります。

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

このオブジェクトには次の関連するオブジェクトがあります。API バージョンが指定されていない場合、これらはこのオブジェクトと同じ API バージョンで使用できます。指定されている場合、指定された API バージョン以降で使用できます。

CaseChangeEvent (API バージョン 44.0)
このオブジェクトには変更イベントを利用できます。
CaseFeed (API バージョン 18.0)
このオブジェクトにはフィード追跡を利用できます。
CaseHistory
オブジェクトの追跡項目について履歴を利用できます。
CaseOwnerSharingRule
このオブジェクトには共有ルールを利用できます。
CaseShare
このオブジェクトには共有を利用できます。