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

ServiceAppointment

顧客のフィールドサービス作業を完了するための予約を表します。このオブジェクトは、API バージョン 38.0 以降で使用できます。

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

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

特別なアクセスルール

Field Service Lightning が有効になっている必要があります。

項目

項目名 詳細
AccountId
reference
プロパティ
Filter、Group、Nillable、Sort
説明
(参照のみ) 予約に関連付けられた取引先。親レコードが作業指示または作業指示品目の場合、この項目の値は親から継承されます。それ以外の場合は、空白のままです。
ActualDuration
int
プロパティ
Create、Filter、Nillable、Sort、Update
説明
人員が住所に到着してから予約が完了するまでにかかった時間 (分数)。[実際の開始時間] 項目と [実際の終了時間] 項目に値を最初に追加したときに [実際の所要時間] が自動的に生成され、[実際の開始時間][実際の終了時間] の差異が示されます。それ以降、[実際の開始時間] 項目と [実際の終了時間] 項目を更新しても [実際の所要時間] 項目は再更新されませんが、手動で更新できます。
ActualEndTime
dateTime
プロパティ
Create、Filter、Nillable、Sort、Update
説明
予約が終了した実際の日時。
ActualStartTime
dateTime
プロパティ
Create、Filter、Nillable、Sort、Update
説明
予約が開始された実際の日時。
Address
address
プロパティ
Filter
説明
予約を実行���る住所。親レコードに住所が含まれる場合、住所は親レコードから継承されます。
AppointmentNumber
string
プロパティ
Autonumber、Defaulted on create、Filter、Sort
説明
予約を識別する自動割り当て番号。
ArrivalWindowEndTime
dateTime
プロパティ
Create、Filter、Nillable、Sort、Update
説明
技術者が取引先の部門に到着するようスケジュールされた時間枠の終了。通常、この時間枠はスケジュール済み開始時間から終了時間までの時間枠よりも大きい範囲になっており、遅延やスケジュール変更のための時間が確保されています。到着期間の開始と終了を顧客と共有し、スケジュール済み開始時間と終了時間を内部のみで維持するように選択できます。
ArrivalWindowStartTime
dateTime
プロパティ
Create、Filter、Nillable、Sort、Update
説明
技術者が取引先の部門に到着するようスケジュールされた時間枠の開始。遅延やスケジュールの変更に対応できるように、この期間は通常、[スケジュール済み開始時間] と [スケジュール済み終了時間] の期間よりも長くなります。到着期間の開始と終了を顧客と共有し、スケジュール済み開始時間と終了時間を内部のみで維持するように選択できます。
City
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
予約が完了した市区郡。最大 40 文字です。
ContactId
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
親レコードに関連付けられた取引先責任者。必要に応じて、サービス予約の取引先責任者を手動で更新できます。
Country
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
作業指示が完了した国。最大 80 文字です。
Description
textarea
プロパティ
Create、Nillable、Update
説明
予約の説明。
DispatchStatus
picklist
プロパティ
Create、Defaulted on create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
予約について、割り当てられたサービス人員に通知したかどうかを示します。2 つの値があります。
  • 派遣済み: 予約について、割り当てられたサービス人員に通知した。この値を選択すると、予約の Status[派遣済み] に変わります。この値を選択できるのは、予約の Status[未スケジュール] または [スケジュール済み] の場合のみです。
  • キャンセル: 予約がキャンセルされた。この値を選択すると、予約の Status[キャンセル] に変わります。
DueDate
dateTime
プロパティ
Create、Filter、Sort、Update
説明
この日付までに予約を完了する必要があります。通常、許容最早開始日と期日は顧客のサービスレベル契約の条件を反映します。
Duration
double
プロパティ
Create、Nillable、Filter、Sort、Update
説明
想定される、予約の長さ。親レコードが作業指示または作業指示品目の場合、予約は親の所要時間を継承しますが手動で更新できます。所要時間は、[所要時間種別] 項目で選択した値に基づいて分または時間単位で示されます。
DurationType
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
所要時間の単位 (分または時間)。
EarliestStartTime
dateTime
プロパティ
Create、Filter、Sort、Update
説明
この日付以降に予約を完了する必要があります。通常、許容最早開始日と期日は顧客のサービスレベル契約の条件を反映します。
GeocodeAccuracy
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
物理的住所と比較した場合の場所の地理座標の精度レベル。通常、住所の緯度および経度座標に基づく地理コードサービスによって提供されます。
LastReferencedDate
dateTime
プロパティ
Filter、Nillable、Sort
説明
サービス予約が最後に更新された日付。ユーザインターフェースの表示ラベルは、[最終更新日] です。
LastViewedDate
dateTime
プロパティ
Filter、Nillable、Sort
説明
サービス予約が最後に参照された日付。
Latitude
double
プロパティ
Create、Filter、Nillable、Sort、Update
説明
Longitude と一緒に使用して、サービス予約が完了した住所の正確な地理位置情報を指定します。許容値は、–90 ~ 90 (小数点以下 15 桁まで) の数値です。
Longitude
double
プロパティ
Create、Filter、Nillable、Sort、Update
説明
Latitude と一緒に使用して、サービス予約が完了した住所の正確な地理位置情報を指定します。許容値は、–180 ~ 180 (小数点以下 15 桁まで) の数値です。
OwnerId
reference
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
サービス予約の所有者。
ParentRecordId
reference
プロパティ
Create、Filter、Group、Sort
説明
予約に関連付けられた親レコード。
ParentRecordStatusCategory
string
プロパティ
Group、Nillable、Sort
説明
(参照のみ) 親レコードの [状況のカテゴリ]。親レコードが作業指示または作業指示品目の場合、この項目に値が設定されます。それ以外の場合、空白のままです。
ParentRecordType
string
プロパティ
Group、Nillable、Sort
説明
(参照のみ) 親レコードのタイプ (取引先、納入商品、商談、作業指示、または作業指示品目)。
PostalCode
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
作業指示が完了した郵便番号。最大 20 文字です。
SchedEndTime
dateTime
プロパティ
Create、Filter、Nillable、Sort、Update
説明
予約を終了するようにスケジュールされた時刻。Field Service Lightning 管理パッケージをスケジュールオプティマイザと共に使用する場合、予約が人員に割り当てられたときにこのフィールドに値が設定されます。スケジュール済み終了時間[スケジュール済み開始時間] = [予想所要時間]
SchedStartTime
dateTime
プロパティ
Create、Filter、Nillable、Sort、Update
説明
予約を開始するようにスケジュールされた時刻。Field Service Lightning 管理パッケージをスケジュールオプティマイザと共に使用する場合、予約が人員に割り当てられたときにこのフィールドに値が設定されます。
ServiceTerritoryId
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
予約に関連付けられたサービステリトリー。親レコードが作業指示または作業指示品目の場合、予約はその親のサービステリトリーを継承します。
State
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
予約が完了した都道府県。最大 80 文字です。
Status
picklist
プロパティ
Defaulted on create、Filter、Group、Nillable、Restricted picklist、Sort
説明
(参照のみ) 予約の状況。この状況は、現在の時間、予約のスケジュール済み開始時間と終了時間、実際の開始時間と終了時間、および派遣状況に基づいて自動的に設定されます。選択リストには次の値が表示されます。値については各説明を参照してください。
  • 未スケジュール: [スケジュール済み開始時間] 項目と [スケジュール済み終了時間] 項目が空白である。
  • スケジュール済み: [スケジュール済み開始時間] 項目と [スケジュール済み終了時間] 項目が入力されている。
  • 派遣済み: [派遣状況][派遣済み] に変更された。
  • 処理中: [実際の開始時間] 項目が入力されているが、[実際の終了時間] 項目が空白である。
  • 完了: [実際の開始時間] 項目と [実際の終了時間] 項目が入力されている。
  • キャンセル: [派遣状況] が [キャンセル] に変更された。
  • 見逃し: [スケジュール済み開始時間] 項目と [スケジュール済み終了時間] 項目が入力されており、[実際の開始時間] 項目と [実際の終了時間] 項目が空白であり、[スケジュール済み終了時間] 時間が経過した。
  • 長期間実行中: 予約は [処理中] であるが、[スケジュール済み終了時間] 時間が経過した。
  • 遅延: 予約が [スケジュール済み] であり、現在の時間が [スケジュール済み開始時間][スケジュール済み終了時間] の間である。

追加の予約状況は作成できません。サービス予約の状況を編集できるようにする必要がある場合は、カスタム項目を使用します。

メモ

Street
textarea
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
サービス予約が完了した番地および町名。
Subject
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
予約について説明する短い語句。

使用方法

サービス予約には必ず親レコード (作業指示、作業指示品目、商談、取引先、納入商品のいずれか) があります。親レコードのタイプによって、サービス予約の特性がわかります。
  • 作業指示作業指示品目のサービス予約は、実施される作業のより詳細なビューを提供します。作業指示と作業指示品目には作業に関する一般情報を入力できますが、サービス予約にはスケジュールと所有権に関する詳細を追加できます。
  • 納入商品に対するサービス予約は、納入商品に対して実行する作業を表します。
  • 取引先に対するサービス予約は、取引先に対して実行する作業を表します。
  • 商談に対するサービス予約は、商談に関連する作業を表します。