この文章は 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
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
説明
納入商品が使用可能であったと想定されるアップタイムの割合。
AverageUptimePerDay
double
プロパティ
Create、Filter、Nillable、Sort、Update
説明
納入商品が使用可能であったと想定される 1 日あたりの平均時間数。
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
CurrentAmount
currency
プロパティ
Filter、Nillable、Sort
説明
現在の納入商品状態期間の未払い総額を表します。現在の納入商品状態期間がない場合、値はデフォルトで 0 になります。

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

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

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

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

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

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

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

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 以降で使用できます。
HasLifecycleManagement
boolean
プロパティ
Defaulted on create、Filter、Group、Sort
説明
この納入商品がライフサイクル管理される納入商品の場合は true、そうでない場合は false。納入商品をライフサイクル管理される納入商品に切り替えることも、その逆を行うこともできません。この項目はシステムによって設定されます。
デフォルト値は false です。

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

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
説明
納入商品が最後に参照された日時。
LifecycleEndDate
dateTime
プロパティ
Filter、Nillable、Sort
説明
納入商品のライフサイクルの終了を表します。最終納入商品状態期間の終了日から継承されるシステム設定項目。エバーグリーンサブスクリプションと同様、この項目が空の場合は、ライフサイクルに終了日がありません。この項目は、API バージョン 50.0 以降で使用できます。この項目は、Salesforce Billing が有効な場合に使用できます。
LifecycleStartDate
dateTime
プロパティ
Filter、Nillable、Sort
説明
納入商品のライフサイクルの開始を表します。最早納入商品状態期間の開始日から継承されるシステム設定項目。この項目は編集できません。新しい納入商品アクションが納入商品状態期間の開始日に影響を与える場合、この期間は削除され、新しい期間が生成されます。この項目は、API バージョン 50.0 以降で使用できます。この項目は、Salesforce Billing が有効な場合に使用できます。
LocationId
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
納入商品の場所。通常は、納入商品が格納されている場所 (倉庫やバンなど) です。
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
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
説明
購入または導入された数量。
Reliability
percent
プロパティ
Filter、Nillable、Sort
説明
納入商品が予定外のダウンタイムの対象ではなかった想定されるアップタイムの割合。
RenewalTerm
double
プロパティ
Create、Filter、Nillable、Sort、Update
説明
更新期間単位では、更新見積のデフォルトのサブスクリプション期間を定義します。この項目は、API バージョン 55.0 以降で使用できます。この項目は、[サブスクリプション管理] が有効な場合に使用できます。
RenewalTermUnit
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
サブスクリプション期間の期間の単位。この項目は、API バージョン 55.0 以降で使用できます。この項目は、[サブスクリプション管理] が有効な場合に使用できます。
可能な値は次のとおりです。
  • Months
RootAssetId
reference
プロパティ
Filter、Group、Nillable、Sort
説明
(参照のみ) 納入商品階層の最上位納入商品。納入商品が階層のどこにあるかに応じて、ルートが親と同じになることがあります。UI 表示ラベルは [ルート納入商品] です。
この項目はリレーション項目です。
リレーション名
RootAsset
リレーション種別
Lookup
参照先
Asset
SerialNumber
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。
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
説明
納入商品の収益の総額。これには、納入商品ライフサイクルの各フェーズからの収益も含まれます。
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
このオブジェクトには共有を利用できます。