DynamicKitConfigurationAdd コマンド

このコマンドは動的キットを構成します。 キットには複数のアイテムが含まれていますが、 キットの単位でオーダーと返品が行われ、その価格は 1 つで SKU も 1 つです。 動的キットに含まれるアイテムについての情報は、外部のコンフィギュレーター によって制御されます。 

このコマンドを呼び出すには 2 つの方法があります。 XML ファイルから、または URL パラメーターからです。 それらは互いに排他的ではないので、両方の方法を合わせて使用できます。 XML ファイルの値の方が常に優先されます。

osdyncfgx.gif (3955 バイト)

XML 呼び出し方式を用いる場合のパラメーター値

http://host_name/path/
(必須) WebSphere Commerce サーバーおよび構成パスの完全修飾名
xmlConfiguration
動的キットを構成の仕方を定義した XML ファイル。 XML は以下の DTD (productConfiguration.dtd) を使用してください。 これは URL 呼び出し方式に使用すべき XML ファイルを定義します。 

<!ELEMENT Configuration (ComponentList)>
<!ATTLIST Configuration
ConfigurationId CDATA #REQUIRED
ReferenceId CDATA #IMPLIED
ConfiguratorURL CDATA #IMPLIED
WCSURL CDATA #IMPLIED
DynamicKitId CDATA #IMPLIED>
<!ELEMENT ComponentList (Component+)>
<!ATTLIST ComponentList
Currency CDATA #IMPLIED>
<!ELEMENT Component EMPTY>
<!ATTLIST Component
WCSItemId CDATA #IMPLIED
WCSPartNumber CDATA #IMPLIED
MemberId CDATA #IMPLIED
Quantity CDATA #REQUIRED
UnitPrice CDATA #IMPLIED>

以下は、XML ファイルのサンプルです。

<?xml version="1.0" encoding="Shift_JIS"?>
<!DOCTYPE Configuration SYSTEM "productConfiguration.dtd">
<Configuration ConfigurationId = "250" DynamicKitId = "15555">
<ComponentList Currency = "CAD">
<Component WCSItemId = "1111" Quantity = "5" UnitPrice = "50.00"/>
<Component WCSPartNumber = "ABC-1112" MemberId = "15" Quantity = "6" UnitPrice = "55.00"/>
<Component WCSItemId = "1113" Quantity = "7" UnitPrice = "60.00"/>
</ComponentList>
</Configuration>

URL
(必須) コマンドが正常に完了した時に呼び出される URL

URL ファイル呼び出し方式用いる場合のパラメーター値

http://host_name/path/
WebSphere Commerce サーバーおよび構成パスの完全修飾名。
configurationId
(必須) この構成を表す、固有の構成 ID。
catEntryId
(必須) 動的キット・カタログのエントリーの ID。
currency
動的キットが提供されるコンポーネントの価格の通貨。
URL
(必須) コマンドが正常に完了した時に呼び出される URL
componentId
(partNumber が指定されない場合にのみ必須) 動的キットのコンポーネントを表すカタログ・エントリーの ID。 この値はオプションですが、この値が指定されない場合には、partNumber パラメーターに値が提供される必要があります。
partNumber
(componentId が指定されない場合にのみ必須)  動的キットのコンポーネントを表すカタログ・エントリーの部品番号。 この値はオプションですが、この値が指定されない場合には、componentId パラメーターに値が提供される必要があります。 
memberId
partNumber の値が提供される場合、これは partnumber+memberid 固有索引からカタログ・エントリーを判別するために使用されるメンバー ID です。 partNumber の値が提供されている場合には、この値はオプションです。 メンバー ID が指定されない場合、現在のストア組織のメンバー ID が、固有索引からカタログ・エントリーを解決するために使用されます。
quantity
(必須) 動的キット内のこのコンポーネントの数。
price
このコンポーネントの価格。 この値はオプションですが、1 つのコンポーネントに価格が提供される場合には、他のすべてのコンポーネントにも価格が必要です。


以下の例は、catentryId が 15555 の動的キット用の構成 250 に関して説明しています。 その構成のコンポーネントは、WebSphere Commerce の 3 つのアイテムで、1111、"ABC-1112"、および 1113 です。 それぞれの数量および単価は以下のとおりです。

http://myhostname/webapp/wcs/stores/servlet/DynamicKitConfigurationAdd?
&configurationId=250&catEntryId=15555&componentId=1111&quantity=5&price=50
&componentId=ABC-1112&quantity=6&price=55&componentId=1113&quantity=7&price=60

動作
動的キットを構成する。

例外条件
なし

関連概念

関連参照

IBM 著作権