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

Asset

顧客が購入した商業価値のある項目 (会社または競合他社が販売した商品など) を表します。

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

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

項目

項目 詳細
AccountId
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
(必須) この納入商品と関連付けられた Account の ID。有効な取引先 ID である必要があります。ContactId が指定されていない場合は必須です。
この項目はリレーション項目です。
リレーション名
Account
リレーション種別
Lookup
参照先
Account
Address
address
プロパティ
Filter、Nillable
説明
アセットの物理的な住所か位置情報を表します。
AssetLevel
int
プロパティ
Filter、Group、Nillable、Sort
説明
納入商品階層における納入商品の位置。納入商品に親および子納入商品がない場合、レベルは 1 になります。階層に属する納入商品は、ルート納入商品の場合は 1、ルート納入商品の子納入商品の場合は 2、その子の場合は 3 というようになります。この項目が導入される前に作成された納入商品では、納入商品レベルがデフォルトで –1 になります。納入商品レコードが更新されると、納入商品レベルが計算され、自動的に更新されます。
AssetProvidedById
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
納入商品を提供した取引先。通常はメーカーです。
この項目はリレーション項目です。
リレーション名
AssetProvidedBy
リレーション種別
Lookup
参照先
Account
AssetServicedById
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
納入商品のサービスを提供する取引先。
この項目はリレーション項目です。
リレーション名
AssetServicedBy
リレーション種別
Lookup
参照先
Account
Availability
percent
プロパティ
Filter、Nillable、Sort
説明
納入商品が使用可能であったと想定されるアップタイムの割合。
AveragetimetoRepair
double
プロパティ
Create、Filter、Nillable、Sort、Update
説明
故障後のアセットの修理に通常要する時間を表します。
  • 平均故障間隔 = (日単位の稼働時間 - 日単位の計画外ダウンタイム) x 1 日あたりの平均稼働時間 ÷ 計画外ダウンタイムの回数
  • 平均修理時間 = 時間単位の計画外ダウンタイム ÷ 計画外ダウンタイムの回数

稼働時間記録開始日と計画外ダウンタイムの回数情報が指定されている場合にのみ、平均修理時間と平均故障間隔が計算されます。「計画外」として分類される「AssetDowntimePeriod」レコードの数に基づいて、アセットに対して「計画外ダウンタイム回数」が計算されます。平均故障間隔を計算するには、稼働時間レコード終了日も指定する必要があります。

メモ

AveragetimeBetweenFailure
double
プロパティ
Create、Filter、Nillable、Sort、Update
説明
アセットが再び故障する可能性が高くなるまでに通常経過する時間数を表します。
  • 平均故障間隔 = (日単位の稼働時間 - 日単位の計画外ダウンタイム) x 1 日あたりの平均稼働時間 ÷ 計画外ダウンタイムの回数
  • 平均修理時間 = 時間単位の計画外ダウンタイム ÷ 計画外ダウンタイムの回数

稼働時間記録開始日と計画外ダウンタイムの回数情報が指定されている場合にのみ、平均修理時間と平均故障間隔が計算されます。「計画外」として分類される「AssetDowntimePeriod」レコードの数に基づいて、アセットに対して「計画外ダウンタイム回数」が計算されます。平均故障間隔を計算するには、稼働時間レコード終了日も指定する必要があります。

メモ

AverageUptimePerDay
double
プロパティ
Create、Filter、Nillable、Sort、Update
説明
納入商品が使用可能であったと想定される 1 日あたりの平均時間数。
City
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
住所の市区郡の詳細。
ConsequenceOfFailure
picklist
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
アセットの故障に伴うビジネスへの影響。この項目を使用することで、アセットの状態を把握し、フローを使用してアクションを起こすことができます。この項目を有効にするには、オブジェクトマネージャーで項目の使用可能状況を更新してください。項目レベルセキュリティとページレイアウトのために、項目が表示されていることを確認してください。詳細は、「項目へのアクセスはどのように決まるのですか」を参照してください。Winter ’22 より前に作成され、Field Service が有効になっていない組織では、選択リストの値は事前に定義されていません。この項目は、API バージョン 53.0 以降で使用できます。
可能な値は次のとおりです。
  • Insignificant
  • Minor
  • Moderate
  • Major
  • Critical
ContactId
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
AccountId が指定されていない場合は必須です。この納入商品と関連付けられた Contact の ID。取引先の親を持つ有効な取引先責任者 ID である必要があります (納入商品の AccountId と一致する必要はありません)。
この項目はリレーション項目です。
リレーション名
Contact
リレーション種別
Lookup
参照先
Contact
Country
String
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
住所の国の詳細。
CurrencyIsoCode
picklist
プロパティ
Create、Defaulted on create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
請求に関連付けられている 3 文字の ISO 4217 通貨コード。デフォルト値は USD です。
この項目は、API バージョン 55.0 以降で使用できます。この項目は、CPQ Plus、Salesforce Billing、または Subscription Management が有効な場合に使用できます。
CurrentAmount
currency
プロパティ
Filter、Nillable、Sort
説明
将来の使用のために予約されています。

この項目は、API バージョン 50.0 以降で使用できます。この項目は、CPQ Plus、Salesforce Billing、または Subscription Management が有効な場合に使用できます。

CurrentLifecycleEndDate
dateTime
プロパティ
Filter、Nillable、Sort
説明
現在として示されている期間の終了を表します。現在の納入商品状態期間の終了日から継承されるシステム設定項目。エバーグリーンサブスクリプションと同様、この項目が空の場合は [現在のライフサイクル終了日] 項目も空になります。

この項目は、API バージョン 50.0 以降で使用できます。この項目は、CPQ Plus、Salesforce Billing、または Subscription Management が有効な場合に使用できます。

CurrentMrr
currency
プロパティ
Filter、Nillable、Sort
説明
納入商品状態期間での納入商品の月間経常収益。現在の納入商品状態期間の月間経常収益から継承されるシステム設定項目。現在の納入商品状態期間がない場合、値は 0 になります。表示ラベルは [現在の月間経常収益] です。

この項目は、API バージョン 50.0 以降で使用できます。この項目は、CPQ Plus、Salesforce Billing、または Subscription Management が有効な場合に使用できます。

CurrentQuantity
double
プロパティ
Filter、Nillable、Sort
説明
現在の納入商品状態期間の納入商品の数量。現在の納入商品状態期間の数量から継承されるシステム設定項目。現在の納入商品状態期間がない場合、値は 0 になります。

この項目は、API バージョン 50.0 以降で使用できます。この項目は、CPQ Plus、Salesforce Billing、または Subscription Management が有効な場合に使用できます。

Description
textarea
プロパティ
Create、Nillable、Update
説明
納入商品の説明。
DigitalAssetStatus
picklist
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
アセットのデジタル追跡の状況。デフォルトの選択リストには次の値が表示されます。
  • On
  • Off
  • Warning
  • Error
ExternalIdentifier
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
外部システムの一致レコードの ID。この項目は、API バージョン 49.0 以降で使用できます。
GeocodeAccuracy
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
住所の地理コードの精度レベル。
HasLifecycleManagement
boolean
プロパティ
Defaulted on create、Filter、Group、Sort
説明
この納入商品がライフサイクル管理される納入商品の場合は true、そうでない場合は false。納入商品をライフサイクル管理される納入商品に切り替えることも、その逆を行うこともできません。この項目はシステムによって設定されます。
デフォルト値は false です。

この項目は、API バージョン 50.0 以降で使用できます。この項目は、CPQ Plus、Salesforce Billing、または Subscription Management が有効な場合に使用できます。

InstallDate
date
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
納入商品が導入された日付。
IsCompetitorProduct
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
この納入商品が、競合会社が販売した商品を表すか (true)、否か (false) を示します。デフォルト値は、false です。UI 表示ラベルは [競合の納入商品] です。
IsInternal
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
納入商品が内部で製造または使用されるか (true)、否か (false) を示します。デフォルト値は、false です。UI 表示ラベルは [社内の納入商品] です。
LastReferencedDate
dateTime
プロパティ
Filter、Nillable、Sort
説明
納入商品が最後に更新された日時。UI 表示ラベルは [最終更新日] です。
LastViewedDate
dateTime
プロパティ
Filter、Nillable、Sort
説明
納入商品が最後に参照された日時。
Latitude
double
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
Longitude と一緒に使用して、住所の正確な地理位置情報を指定します。
LifecycleEndDate
dateTime
プロパティ
Filter、Nillable、Sort
説明
納入商品のライフサイクルの終了を表します。最終納入商品状態期間の終了日から継承されるシステム設定項目。エバーグリーンサブスクリプションと同様、この項目が空の場合は、ライフサイクルに終了日がありません。この項目は、API バージョン 50.0 以降で使用できます。この項目は、CPQ Plus、Salesforce Billing、または Subscription Management が有効な場合に使用できます。
LifecycleStartDate
dateTime
プロパティ
Filter、Nillable、Sort
説明
納入商品のライフサイクルの開始を表します。最早納入商品状態期間の開始日から継承されるシステム設定項目。この項目は編集できません。新しい納入商品アクションが納入商品状態期間の開始日に影響を与える場合、この期間は削除され、新しい期間が生成されます。この項目は、API バージョン 50.0 以降で使用できます。この項目は、CPQ Plus、Salesforce Billing、または Subscription Management が有効な場合に使用できます。
LocationId
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
納入商品の場所。通常は、納入商品が格納されている場所 (倉庫やバンなど) です。
Longitude
double
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
Latitude と一緒に使用して、住所の正確な地理位置情報を指定します。
ManufactureDate
date
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
納入商品が製造された日付。この項目は、API バージョン 49.0 以降で使用できます。
Name
string
プロパティ
Create、Filter、Group、idLookup、Sort、Update
説明
(必須) 納入商品の名前。表示ラベルは [納入商品名] です。
OwnerId
reference
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
納入商品の所有者。デフォルトでは、納入商品所有者は、納入商品レコードを作成したユーザーです。UI 表示ラベルは [納入商品所有者] です。
この項目はリレーション項目です。
リレーション名
Owner
リレーション種別
Lookup
参照先
User
ParentId
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
納入商品の親納入商品。UI 表示ラベルは [親納入商品] です。
この項目はリレーション項目です。
リレーション名
Parent
リレーション種別
Lookup
参照先
Asset
PostalCode
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
住所の郵便番号。
Price
currency
プロパティ
Create、Filter、Nillable、Sort、Update
説明
この納入商品に支払われた金額。
Product2Id
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
(省略可能) この納入商品と関連付けられた Product2 の ID。有効な Product2 ID である必要があります。UI 表示ラベルは [商品] です。
この項目はリレーション項目です。
リレーション名
Product2
リレーション種別
Lookup
参照先
Product2
ProductCode
string
プロパティ
Filter、Group、Nillable、Sort
説明
関連商品の商品コード。
ProductDescription
string
プロパティ
Filter、Sort、Nillable
説明
関連商品の商品説明。
ProductFamily
picklist
プロパティ
Filter、Group、Sort、Nillable
説明
関連商品の商品ファミリー。
PurchaseDate
date
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
納入商品が購入された日付。
Quantity
double
プロパティ
Create、Filter、Nillable、Sort、Update
説明
購入または導入された数量。[数量] 項目の値は、顧客納入商品ライフサイクル管理では設定されません。この項目は、必要に応じて入��できます。
QuantityIncreasePricingType
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
この納入商品の数量が増加したときに使用する価格設定種別を指定します。UI 表示ラベルは [数量の増加の価格設定種別] です。この項目は、API バージョン 56.0 以降で使用できます。この項目は、Subscription Management が有効な場合に使用できます。
可能な値は次のとおりです。
  • LastNegotiatedPrice — API バージョン 58.0 以降で使用できます。
  • ListPrice
RecordTypeId
reference
プロパティ
Create、Filter、Group、Sort、Update
説明
当事者の一意の識別子。
この項目はリレーション項目です。
リレーション名
RecordType
リレーション種別
Lookup
参照先
RecordType
Reliability
percent
プロパティ
Filter、Nillable、Sort
説明
納入商品が予定外のダウンタイムの対象ではなかった想定されるアップタイムの割合。
RenewalPricingType
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
サブスクリプションの更新時に使用される価格。UI 表示ラベルは [更新の価格設定種別] です。この項目は、API バージョン 55.0 以降で使用できます。この項目は、Subscription Management が有効な場合に使用できます。
可能な値は次のとおりです。
  • LastNegotiatedPrice
  • ListPrice
RenewalTerm
double
プロパティ
Create、Filter、Nillable、Sort、Update
説明
更新期間単位では、更新見積のデフォルトのサブスクリプション期間を定義します。この項目は、API バージョン 55.0 以降で使用できます。この項目は、Subscription Management が有効な場合に使用できます。
RenewalTermUnit
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
サブスクリプション期間の期間の単位。この項目は、API バージョン 55.0 以降で使用できます。この項目は、Subscription Management が有効な場合に使用できます。
可能な値は次のとおりです。
  • Annual — API バージョン 58.0 以降で使用できます。— UI の表示ラベルは [年] です。
  • Months
RootAssetId
reference
プロパティ
Filter、Group、Nillable、Sort
説明
(参照のみ) 納入商品階層の最上位納入商品。納入商品が階層のどこにあるかに応じて、ルートが親と同じになることがあります。UI 表示ラベルは [ルート納入商品] です。
この項目はリレーション項目です。
リレーション名
RootAsset
リレーション種別
Lookup
参照先
Asset
SerialNumber
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
この納入商品のシリアル番号。
State
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
住所の都道府県の詳細。
Status
picklist
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
値のカスタマイズが可能な選択リスト。デフォルトの選択リストには次の値が表示されます。
  • Purchased
  • Shipped
  • Installed
  • Registered
  • Obsolete
StatusReason
picklist
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
デバイス状況の説明。この項目は、API バージョン 49.0 以降で使用できます。
可能な値は次のとおりです。
  • Not Ready
  • Off
  • Offline
  • Online
  • Paused
  • Standby
StockKeepingUnit
string
プロパティ
Filter、Group、Nillable、Sort
説明
関連商品に割り当てられた SKU。
Street
textarea
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
住所の町名番地の詳細。
SumDowntime
double
プロパティ
Filter、Nillable、Sort
説明
計画的および予定外の累計ダウンタイム。次の方法で決定します。
  • UptimeRecordStart のみが設定されている場合は、UptimeRecordStart からのすべてのダウンタイムの合計
  • UptimeRecordStartUptimeRecordEnd が設定されている場合は、UptimeRecordStart から UptimeRecordEnd までのすべてのダウンタイムの合計
上記以外の場合は、ダウンタイムが累計されません。
SumUnplannedDowntime
double
プロパティ
Filter、Nillable、Sort
説明
予定外の累計ダウンタイム。次の方法で決定します。
  • UptimeRecordStart のみが設定されている場合は、UptimeRecordStart からのすべての予定外のダウンタイムの合計
  • UptimeRecordStartUptimeRecordEnd が設定されている場合は、UptimeRecordStart から UptimeRecordEnd までのすべての予定外のダウンタイムの合計
上記以外の場合、予定外のダウンタイムは累計されません。
TotalLifecycleAmount
currency
プロパティ
Filter、Nillable、Sort
説明
納入商品の収益の総額。これには、納入商品ライフサイクルの各フェーズからの収益も含まれます。この項目は、CPQ Plus、Salesforce Billing、または Subscription Management が有効な場合に使用できます。
UptimeRecordEnd
dateTime
プロパティ
Create、Filter、Nillable、Sort、Update
説明
SumDowntimeSumUnplannedDowntime の累計を終了する日。
UptimeRecordStart
dateTime
プロパティ
Create、Filter、Nillable、Sort、Update
説明
SumDowntimeSumUnplannedDowntime の累計を開始する日。
UsageEndDate
date
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
この納入商品の使用が終了または期限が切れる日付。
Uuid
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
納入商品の一意の ID。この項目は、API バージョン 49.0 以降で使用できます。

使用方法

このオブジェクトを使用して、顧客に販売した商品を追跡します。納入商品を追跡すると、クライアントアプリケーションは、以前販売された商品または特定の取引先に現在導入されている商品を迅速に確認できます。最大 10,000 個の納入商品の階層を作成することもできます。

たとえば、会社で過去に販売した商品について商談を更新およびより高額な商品を販売したいとします。同様に、商品を交換したり取り替えたりできる顧客環境にある競合会社の商品を追跡できるとします。

納入商品の追跡は、商品固有のサポート問題を解決する詳細情報を提供するため、商品サポートに役立ちます。たとえば、PurchaseDate または SerialNumber は、指定された商品に、商品のリコールなど、特定のメンテナンス要件があるかどうかを示します。同様に、UsageEndDate は、納入商品がサービスの適用外となった日時、またはライセンスや保証期限が切れる日時を示します。

アプリケーションが Asset レコードを作成する場合、NameAccountId/ContactId のいずれか、または両方を指定する必要があります。

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

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

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