基本指令語法

所有 WebSphere Commerce 購物流程指令都有下列基本語法:

    http://host_name/path/Command?parameter1=value&parameter2=value&parameter3=value

圖例如下: 

如果要閱讀這種軌道型語法圖時,請從左上角開始,然後循線往下讀。  請記住如下的使用慣例: 

  • host_namepath 取決於產品的安裝路徑而定。
  • 指令名稱後的定界符號為 ?。 連續參數間的定界符號為 &。 不需要在第一個參數前使用 &。  
  • 一般而言,在語法圖中參數的值會以 s 表示以代表字串。  若參數需要預先定義的字碼,或其在資料類型上的限制不明顯, 則會在說明中解釋。 
  • 當線條由左至右時,假設有參數不得取消而必須放在主線上(像是 URL), 則表示該參數為必要的。
  • 若參數不在主線上(如 langId)且可以不用, 則該參數為選用的。 
  • 假設有參數帶有一條回到左端的線路(像是 listId),表示該參數可重複使用,像是:  
  • &listId=1&listId=2&listId=3

    下面的語法圖說明替代的必要參數組,您可使用:

    &logonId=s&challengeAnswer=s 

    或者使用:

    &logonPassword=s&logonPasswordOld=s&logonPasswordVerify=s
    

    下個語法圖顯示 memberId(這個參數有時是必要的)。這一點用破折線來表示。在 OrgEntityAdd 的說明中,有參數是必要或選用的時機解說。

    參數

    以下是可用於大部分指令中的一些常見參數:

    storeId
    此參數可讓指令連結某個特定商店。  這對運作於商場層次的指令相當好用,因為它可讓指令只運作於該商店範圍內。
    langId
    指定指令執行時期所用的語言。 參數值儲存在 LANGUAGE 表格中。 指定的語言會置換使用者的預設語言(如果支援的話)。 否則,如果不支援指定的語言,就會使用商店或網站的預設語言。
    forUser
    指定使用者的登入 ID,讓另一位使用者為他執行若干動作。 只有具備處理訂單權限的人(像是:客戶服務代表、客戶服務主管、 營運經理、流通經理 商家或 賣方)才能使用此參數。 當客戶要求取得協助以完成交易時,就可以在呼叫中心設定使用這個參數。 之後,呼叫中心操作員就會登入,並以發出呼叫之客戶的身份來完成訂單。
    forUserId
    與 forUser 相同,但卻是 USERS 表格中之內部使用者 ID 所指的使用者。
    URL
    在指令執行成功時,所要呼叫的網址。  此參數的值視下列而定:以指令的輸入參數起頭(URL 除外)。 新增此指令產生的其它任何「名稱-值」配對,以便在發生名稱衝突時取代之。最後,新增在 URL 中找到的「名稱-值」配對,以便在發生名稱衝突時取代之。

    範例
    在顯示範例時,通常 URL 會橫跨多行。為了閱讀方便, 其編排方式類似如下:
         http://myhostname/webapp/wcs/stores/servlet/AddressUpdate?addressId=128
         &firstName=Jeffery&URL=/webapp/wcs/stores/servlet/


    請注意,URL 指令通常以單行出現。

    相關參照

    IBM copyright