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

Product2

組織で販売している商品を表します。

このオブジェクトには、数量と収益によるスケジュールのみに使用される項目がいくつかあります (収益など)。スケジュールは、商品機能およびスケジュール機能が有効化されている組織でのみ使用できます。これらの機能が有効化されていない場合、スケジュール項目は DescribeSObjectResult に表示されず、項目をクエリ、作成、または更新できません。

Product2 オブジェクトは商品を表します。API バージョン 8.0 以降、Product オブジェクトはサポートされません。Product を指定する要求は拒否され、レスポンスには Product オブジェクトについては記述されません。

メモ

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

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

項目

項目 詳細
CanUseQuantitySchedule
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
商品に数量のスケジュールが指定されているか (true)、否か (false) を示します。表示ラベルは [数量スケジュールの有効] です。
CanUseRevenueSchedule
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
商品に収益のスケジュールが指定されているか (true)、否か (false) を示します。表示ラベルは [収益スケジュールの有効] です。
ConnectionReceivedId
reference
プロパティ
Filter、Group、Nillable、Sort
説明
組織とこのレコードを共有した PartnerNetworkConnection の ID。この項目は、Salesforce to Salesforce が有効な場合に使用できます。
ConnectionSentId
reference
プロパティ
Filter、Group、Nillable、Sort
説明
このレコードを共有した PartnerNetworkConnection の ID。この項目は、Salesforce to Salesforce が有効な場合に使用できます。この項目は、API バージョン 15.0 以前を使用する場合にサポートされます。他の API バージョンでは、この項目の値は null です。レコードを接続に転送するには、新しい PartnerNetworkRecordConnection を使用します。
CurrencyIsoCode
picklist
プロパティ
Create、Defaulted on create、Filter、Group、Restricted picklist、Sort、Update
説明
マルチ通貨機能を有効化している組織にのみ使用できます。組織で使用できる通貨の ISO コードが指定されています。
Description
textarea
プロパティ
Create、Filter、Nillable、Sort、Update
説明
このレコードのテキストによる説明。表示ラベルは [商品説明] です。
DisplayUrl
url
プロパティ
Create、Filter、Nillable、Sort、Update
説明
リンクされた外部データソース内の特定バージョンのレコードへの URL。
ExternalDataSourceId
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
関連する外部データソースの ID。
ExternalId
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リンクされた外部データソース内のレコードの一意の ID。たとえば、ID #123 です。
Family
picklist
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
このレコードに関連付けられている商品ファミリの ID。商品ファミリは、ユーザインターフェースで選択リストとして構成されています。有効な値のリストを取得するには、describeSObjects() をコールし、Family 項目に関連付けられた値の DescribeSObjectResult を処理します。表示ラベルは [商品ファミリ] です。
IsActive
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
このレコードが有効か (true) 有効でないか (false) を示します。無効な Product2 レコードは、ユーザインターフェースの多くの領域で非表示となります。必要に応じて、Product2 オブジェクトの IsActive フラグを変更できます。表示ラベルは [有効] です。
IsArchived
boolean
プロパティ
Defaulted on create、Filter、Group、Sort
説明
商品がアーカイブされているかどうかを説明します。デフォルト値は false です。
IsDeleted
boolean
プロパティ
Defaulted on create、Filter
説明
オブジェクトがごみ箱に移動したか (true)、否か (false) を示します。表示ラベルは Deleted です。
LastReferencedDate
dateTime
プロパティ
Filter、Nillable、Sort
説明

現在のユーザがこのレコード、このレコードに関連するレコード、またはリストビューに最後にアクセスしたときのタイムスタンプ。

LastViewedDate
dateTime
プロパティ
Filter、Nillable、Sort
説明

現在のユーザがこのレコードまたはリストビューを最後に表示したときのタイムスタンプ。この値が null の場合、ユーザはこのレコードまたはリストビューにアクセスしただけで (LastReferencedDate) 表示していない可能性があります。

Name
string
プロパティ
Create、Filter、Group、idLookup、Sort、Update
説明
必須。このレコードのデフォルト名。表示ラベルは [商品名] です。
NumberOfQuantityInstallments
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
商品に数量スケジュールが指定されている場合、スケジュールの回数。
NumberOfRevenueInstallments
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
商品に収益スケジュールが指定されている場合、インストールの回数。
ProductClass
picklist
プロパティ
Defaulted on create、Filter、Group、Restricted picklist、Sort
説明
この項目は参照のみです。この項目の値は、Type 項目の値と、商品が ProductAttribute レコードに関連付けられているかどうかによって決定されます。この項目により、商品が単なる商品であるのか、バリエーションの親であるのか、それとも商品バリエーションであるのかが示されます。使用可能な値は次のとおりです。
  • Simple — この商品にバリエーションはありません。
  • VariationParent — この商品はバリエーションの親です。1 つ以上の商品バリエーションの基礎となる商品で、独自の在庫管理単位 (SKU) がありますが、販売できるエンティティではありません。代わりに、そのバリエーションである販売可能エンティティの親となります。
  • Variation — この商品は親商品のバリエーションです。各バリエーションには独自の SKU があります。

ProductClass 値が VariationParent の場合、その値は変化しません。商品に対して ProductAttribute レコードを添付または添付解除すると、ProductClass 値は、SimpleVariation の間で変化します。

デフォルト値は Simple です。この項目は、API バージョン 50.0 以降で使用できます。これは、コマースの実装をサポートするために導入されました。

ProductCode
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
このレコードのデフォルト商品コード。組織で商品コードの命名パターンを定義します。
QuantityInstallmentPeriod
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
商品に数量スケジュールが指定されている場合、スケジュールでカバーされている時間。
QuantityScheduleType
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
商品に数量スケジュールが指定されている場合、その種類。
QuantityUnitOfMeasure
picklist
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
製品の単位 (キログラム、リッター、ケースなど)。この項目に含まれているのは 1 つの値 [Each] のみのため、独自の値を作成することを考慮してください。ProductItem の QuantityUnitOfMeasure 項目は、この項目の値を継承します。
RecalculateTotalPrice
boolean
プロパティ
Defaulted on create、Filter、Group、Sort
説明
品目に Quantity 値の子スケジュール行がある場合、OpportunityLineItem 計算の動作を変更します。この項目が有効な場合、合計数量が変わると、販売価格に合計数量の値を乗じて、合計金額を変更します。
RevenueInstallmentPeriod
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
商品に収益スケジュールが指定されている場合、スケジュールでカバーされている期間。
RevenueScheduleType
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
商品に収益スケジュールが指定されている場合、その種類。
StockKeepingUnit
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
商品の SKU。ProductCode 項目と並行して使用したり、その項目の代わりに使用したりします。たとえば、[商品コード] 項目を使用してメーカーの識別コードを追跡し、再販時に商品に SKU を割り当てることができます。
Type
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort
説明
商品の種別。Type の値は、ProductClass 項目の参照のみの値に影響を与えます。使用できる値は、BaseNull です。
  • Type = Base の場合、ProductClass = VariantionParent となります。
  • Type = Null の場合、ProductClass = Simple となります。
  • ProductAttribute レコードを商品に添付する場合、商品の ProductClass 値は Variation に変化します。逆に、商品からすべての ProductAttribute レコードを添付解除すると、ProductClass 値は Simple に変化します。

この項目は、API バージョン 50.0 以降で使用できます。これは、コマースの実装をサポートするために導入されました。

スケジュール有効化フラグ

スケジュール機能を有効化すると、組織では数量スケジュール、収益スケジュールのいずれか、またはその両方の有効化を指定できます。また、API を使用して CanUseQuantitySchedule フラグおよび CanUseRevenueSchedule フラグを介して、数量スケジュールおよび収益スケジュールを商品レベルで制御できます。いずれかのフラグの true の値により、商品と OpportunityLineItem に該当するタイプのスケジュールが指定されます。これらのフラグは、Product2 レコードを作成または更新するときに設定できます。

デフォルトのスケジュールを示す項目

このオブジェクトの残りのスケジュールに関する項目では、デフォルトのスケジュールを定義します。商品の OpportunityLineItem の作成時、デフォルトのスケジュール値を使用して OpportunityLineItemSchedule が作成されます。

各項目では、次の値を使用できます (すべての項目が nillable です)。

項目 有効な値
RevenueScheduleType Divide、Repeat
RevenueInstallmentPeriod Daily、Weekly、Monthly、Quarterly、Yearly
NumberOfRevenueInstallments 1 ~ 150 の整数 (1 と 150 を含む)。
QuantityScheduleType Divide、Repeat
QuantityInstallmentPeriod Daily、Weekly、Monthly、Quarterly、Yearly
NumberOfQuantityInstallments 1 ~ 150 の整数 (1 と 150 を含む)。

作成または更新時にスケジュールに関する項目を設定する場合、API では、項目間で整合性チェックを適用します。整合性の要件は次のとおりです。

  • スケジュールタイプが nil である場合、期間と回数は nil でなければなりません。
  • スケジュールタイプが何らかの値に設定されている場合、期間と回数は nil 以外でなければなりません。

これらの整合性チェックで失敗した create または update は、エラーが発生して拒否されます。

デフォルトのスケジュールを示すこれらの項目、CanUseQuantitySchedule、および CanUseRevenueSchedule は、制限付き選択リスト項目であり、組織でスケジュール機能が有効化されている場合にのみ使用できます。

使用方法

このオブジェクトを使用して、組織のデフォルトの商品情報を定義します。このオブジェクトは、PricebookEntry オブジェクトを介した Pricebook2 オブジェクトとの参照によって関連付けられています。価格表エントリと同じ商品を、別の価格表に記載することができます。実際、異なる価格または通貨を使用する同一の価格表に、同じ商品が複数回 (個別の PricebookEntry レコードとして) 記載されることがあります。同じ価格表内の製品に対し、指定された通貨の価格は 1 つだけ指定できます。カスタム価格表で使用するには、すべての標準価格を標準価格表に価格表エントリとして追加する必要があります。

組織に設定された商品を照会できます。たとえば、クライアントアプリケーションは、API を介して PricebookEntry レコードを設定する場合に使用する有効な商品 ID を取得できます。クライアントアプリケーションは、PricebookEntry オブジェクトで次のタスクを実行できます。
  • クエリ
  • 標準価格表またはカスタム価格表の作成。
  • 更新
  • 削除
  • レコードの作成または更新時の IsActive 項目の変更

このオブジェクトは、商品機能を有効化している組織にのみ定義されます。組織に商品機能がない場合、このオブジェクトは describeGlobal() コールに表示されないため、このオブジェクトを記述または照会できません。

API を使用して商品を削除しようとしているが、その商品を使用する組織がある場合、削除は失敗します。回避策としては、ユーザインターフェースで商品を削除します。これにより、商品をアーカイブできるようになります。

商談および商談商品では、子になる商談商品またはスケジュールへの更新によって親レコードが更新されると、ワークフロールール、入力規則、および Apex トリガが発行されます。つまり、親レコードに対する更新があるときには、カスタムアプリケーションロジックを強制して、より高いデータの品質と組織のビジネスポリシー準拠が保証されます。

メモ

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

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

Product2ChangeEvent (API バージョン 44.0)
このオブジェクトには変更イベントを使用できます。
Product2Feed (API バージョン 18.0)
このオブジェクトに対してフィード追跡を実行できます。
Product2History
オブジェクトの追跡項目について履歴を利用できます。