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

Case

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

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

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

項目

項目 詳細
AccountId
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
ケースと関連付けられた Account の ID。
BusinessHoursId
reference
プロパティ
Create、Filter、Group、Sort、Update
説明
このケースに関連付けられた営業時間の ID。
CaseNumber
string
プロパティ
Autonumber、Defaulted on create、Filter、idLookup、Sort
説明
ケースが挿入されると自動的に割り当てられます。直接設定できず、ケースが作成されると変更することができません。
ClosedDate
dateTime
プロパティ
Filter、Nillable、Sort
説明
ケースがクローズした日時。
CommunityId
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
このケースと関連付けられた Community (Zone) の ID。

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

ConnectionReceivedId
reference
プロパティ
Filter、Nillable
説明
組織とこのレコードを共有した PartnerNetworkConnection の ID。この項目は、Salesforce to Salesforce が有効な場合にのみ使用できます。
ConnectionSentId
reference
プロパティ
Filter、Nillable
説明
このレコードを共有した PartnerNetworkConnection の ID。この項目は、Salesforce to Salesforce が有効な場合にのみ使用できます。API バージョン 15.0 以降では、ConnectionSentId 項目はサポートされていません。ConnectionSentId 項目は使用できますが、値は Null です。レコードを接続に転送するには、新しい PartnerNetworkRecordConnection を使用します。
ContactEmail
email
プロパティ
Filter、Group、Nillable、Sort
説明
取引先責任者のメールアドレス。表示ラベルは [取引先責任者 メール] です。この項目は API バージョン 38.0 以降で使用できます。
ContactFax
phone
プロパティ
Filter、Group、Nillable、Sort
説明
取引先責任者の FAX 番号。表示ラベルは [取引先責任者 Fax] です。この項目は API バージョン 38.0 以降で使用できます。
ContactId
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
関連付けられた Contact の ID。
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) を示します。表示ラベルは Deleted です。
IsEscalated
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
ケースがエスカレーションされたか (true)、否かを示します。ケースのエスカレーションされた状態は、ケースをどのように使用できるか、ケースをクエリ、削除、更新できるかどうかに影響しません。なお、API を使用してこのフラグを設定することはできません。表示ラベルは Escalated です。
IsSelfServiceClosed
boolean
プロパティ
Defaulted on create、Filter、Group、Sort
説明
セルフサービスユーザのケースがクローズしているか (true)、否か (false) を示します。
IsStopped
boolean
プロパティ
Defaulted on create、Filter、Group、Sort
説明
ケースのエンタイトルメントプロセスが終了しているか (true)、否か (false) を示します。
IsVisibleInSelfService
boolean
プロパティ
Defaulted on create、Filter、Group、Sort
説明
カスタマーサービスポータル、パートナーサービスポータル、セルフサービスポータルにケースを表示できるか (true)、否か (false) を示します。この項目は、パートナー関係の管理、カスタマーサービスポータル、セルフサービスポータルの前のバージョンのケースの表示に適用されます。ポータルユーザが参照・更新アクセス権を持つ場合、項目は共有を変更せず、ケースへのダイレクト URL の使用を阻止しません。
LastReferencedDate
date
プロパティ
Filter、Nillable、Sort、Update
説明
現在のユーザがこのレコードに関連するレコードを最後に表示したときのタイムスタンプ。
LastViewedDate
date
プロパティ
Filter、Nillable、Sort、Update
説明
現在のユーザがこのレコードを最後に表示したときのタイムスタンプ。この値が null の場合、このレコードは参照 (LastReferencedDate) されただけで、表示はされていない可能性があります。
Origin
picklist
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
EmailPhoneWeb など、ケースのソース。表示ラベルは Case Origin です。
OwnerId
reference
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
ケースを所有する取引先責任者の ID。
ParentId
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
階層内の親ケースの ID。表示ラベルは Parent Case です。
Priority
picklist
プロパティ
Create、Defaulted on create、Filter、Group、Nillable、Sort、Update
説明
HighMediumLow など、ケースの重要度または緊急度。
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、Update
説明
ケースがエンタイトルメントプロセスを開始した時刻を示します。ケースに対する「編集」権限がある場合は、時刻を更新またはリセットできます。

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

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

この項目は 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 使用する割り当てルールの名前。無効な割り当てルールの場合があります。指定されていない場合および useDefaultRuletrue の場合、デフォルトの割り当てルールが使用されます。指定された割り当てルールの 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 の代���りに _case を使用してアプリケーションを更新する必要があります。これは、case が Java の予約語であるためです。