DynamicKitConfigurationAdd 指令

這個指令會架構動態套件。套件含有多個項目,它的訂購和退貨是作為一整個單元來處理的,擁有單一價格和單一 SKU。 動態套件所包含之項目的相關資訊由外部架構程式來控制。

呼叫這個指令的方法有兩個:利用 XML 檔或 URL 參數。 兩個方法不互斥,可以一起使用。永遠以 XML 檔的值為優先。

osdyncfgx.gif(3955 個位元組)

使用 XML 呼叫方法的參數值

http://host_name/path/
(必要)WebSphere Commerce Server 和架構路徑的完整名稱。
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="UTF-8"?>
<!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 Server 與架構路徑的完整名稱。
configurationId
(必要)代表這個架構的唯一架構 ID。
catEntryId
(必要)動態套件型錄項目的 ID。
貨幣
用來提供動態套件內的元件價格的貨幣。
URL
(必要)當指令順利完成時所要呼叫的 URL。
componentId
(只在沒有提供 partNumber 值時才是必要的)代表動態套件元件之型錄項目的 ID。 這個值是選用的;不過,如果沒有提供這個值,就必須提供 partNumber 參數值。
partNumber
(只在沒有提供 componentId 值時才是必要的)代表動態套件元件之型錄項目的產品編號。 這個值是選用的;不過,如果沒有提供這個值,就必須提供 componentId 參數值。
memberId
如果提供了 partNumber 值,那麼,這就是用來從 partnumber+memberid 唯一索引確定型錄項目的成員 ID。 如果提供了 partNumber,這個值就是選用的。 如果沒有提供成員 ID,就會用現行商店組織的成員 ID 來從唯一索引解析型錄項目。
數量
(必要)動態套件內這個元件的數目。
price
這個元件的價格。這個值是選用的;不過,如果提供了一個元件的價格,每個其它元件也都必須有價格。

範例
下列範例說明 catentryId 為 15555 之動態套件的架構 250。 架構的元件是三個 WebSphere Commerce 項目: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 copyright