この文章は 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
説明
予約の説明。
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
説明
物理的住所と比較した場合の場所の地理座標の精度レベル。通常、住所の緯度および経度座標に基づく地理コードサービスによって提供されます。

この項目は、API でのみ使用できます。

メモ

LastReferencedDate
型
dateTime
プロパティ
Filter、Nillable、Sort
説明
サービス予約が最後に更新された日付。ユーザインターフェースの表示ラベルは、[最終更新日] です。
LastViewedDate
型
dateTime
プロパティ
Filter、Nillable、Sort
説明
サービス予約が最後に参照された日付。
Latitude
型
double
プロパティ
Create、Filter、Nillable、Sort、Update
説明
Longitude と一緒に使用して、サービス予約が完了した住所の正確な地理位置情報を指定します。許容値は、–90 ~ 90 (小数点以下 15 桁まで) の数値です。

この項目は、API でのみ使用できます。

メモ

Longitude
型
double
プロパティ
Create、Filter、Nillable、Sort、Update
説明
Latitude と一緒に使用して、サービス予約が完了した住所の正確な地理位置情報を指定します。許容値は、–180 ~ 180 (小数点以下 15 桁まで) の数値です。

この項目は、API でのみ使用できます。

メモ

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
プロパティ
Create、Defaulted on create、Filter、Group、Nillable、Sort、Update
説明
予約の状況。選択リストには、カスタマイズ可能な次の値が表示されます。
  • なし - デフォルト値。
  • スケジュール済み — 予約はサービスリソースに割り当てられています。
  • 派遣済み — 割り当てられたサービスリソースは、割り当てについて通知されました。
  • 進行中 - 作業が開始されました。
  • 完了 - 作業が完了しました。
  • 完了不可 - 作業を完了できませんでした。
  • キャンセル済み - 作業がキャンセルされました。通常は作業開始前にキャンセルされます。
StatusCategory
型
picklist
プロパティ
Defaulted on create、Filter、Group、Nillable、Restricted picklist、Sort
説明
それぞれの [状況] の値が分類されるカテゴリ。[状況のカテゴリ] 項目にはデフォルトの [状況] 値と同じ 7 個の値があります。

カスタムの [状況] 値を作成する場合は、どのカテゴリに属すかを指定する必要があります。たとえば、「Customer Absent」(お客様不在) という値を作成する場合、それが [完了できません] カテゴリに属するということを指定できます。

[状況のカテゴリ] 項目は、カスタムアプリケーション、トリガ、および入力規則を参照する場合に便利です。状況カテゴリでは、追跡、レポート、ビジネス��ロセス管理の一貫した作業分類を維持しながら、作業のライフサイクルを拡張およびカスタマイズできます。

Street
型
textarea
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
サービス予約が完了した番地および町名。
Subject
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
予約について説明する短い語句。
WorkTypeId
型
reference
プロパティ
Filter、Group、Nillable、Sort
説明
サービス予定に関連付けられた作業種別。親が作業指示または作業指示品目の場合、作業種別は予定の親レコードから継承されます。

使用方法

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