AddressUpdate 指令
這個指令會更新使用者的地址登錄。
請搭配 SSL(安全 Sockets 層次)使用此指令,以確保成員的登入密碼與個人資訊皆經過加密。其做法是鍵入指令與 HTTPS 安全通信協定。

參數值
- http://host_name/path/
- (必要)WebSphere Commerce Server 和架構路徑的完整名稱。
- langId
- 設定或重設在階段作業期間的屬意語言;
有關商店的支援語言可在 STORELANG 表格中找到。
- forUser
- 將代替其執行指令之使用者或組織的登入 ID;只有具備處理訂單權限的人才可指定這個參數。
- forUserId
- 與 forUser 相同,但卻是 USERS 表格中之內部使用者 ID 所指的使用者。
- memberId
- 如果沒有指定 memberId,預設值是現行使用者
(要登入的使用者)。這個參數可用來新增組織實體或其他使用者的地址。
- URL
- (必要)當指令順利完成時所要呼叫的 URL。
- addressId
- (必要)要更新之地址的參考號碼。
- businessTitle
- 要更新地址的使用者在公司的職位(如總經理或經理)。
- personTitle
- 要更新地址之使用者的稱謂(如博士、先生或小姐)。
- firstName
- 使用者的名字。
- middleName
- 使用者的別名或姓名的起始字母。
- organizationName
- 使用者所代表的組織。
- organizationUnitName
- 使用者之組織中的單位名稱。
- officeAddress
- 組織內部地址(如收發中心)。
- primary
- 提供的地址是不是特定地址類型的主要地址:
- addressType
- 地址類型,例如:
- R=住家地址(預設值)
- M=郵寄地址
- S=出貨地址
- B=帳單地址
- SB=出貨與帳單地址
- address1
- 使用者地址的第一行。
- address2
- 使用者地址的第二行。
- address3
- 使用者地址的第三行。
- city
- 使用者所在的城市名稱。
- state
- 使用者所在的州/省(縣/市)或對等轄區的名稱
- zipCode
- 使用者地址的郵遞區號。
- country
- 使用者所在的國家(或地區)名稱。
- bestCallingTime
- 白天或晚上電洽使用者:
- phone1
- 使用者的主要電話號碼。
- phone1Type
-
使用者主要電話號碼所用的電話類型,比方說,供聽障人士使用的 TTY、用於脈衝碼調變的 PCM,或行動電話的 CEL。這個欄位可有 3 個字元。
- publishPhone1
- 要不要列出使用者的主要電話號碼:
- phone2
- 使用者的次要電話號碼。
- phone2Type
-
使用者次要電話號碼所用的電話類型,比方說,供聽障人士使用的 TTY、用於脈衝碼調變的 PCM,或行動電話的 CEL。這個欄位可有 3 個字元。
- publishPhone2
- 要不要列出使用者的次要電話號碼:
1= 是
0= 否
- fax1
-
使用者的主要傳真號碼。
- fax2
-
使用者的次要傳真號碼。
- email1
- 使用者的主要電子郵件位址或網址。
- email2
- 使用者的次要電子郵件位址或網址。
- billingCode
- 買方組織的代碼,用以識別出貨或帳單地址以及成本中心。
- billingCodeType
- 代表帳單代碼所用之代碼結構方法的代碼。
預設值為 D(由買方指定)。值 02 表示由 Ariba 指定。
- taxPayerId
- 用來識別課稅使用者的字串,在搭配稅金軟體時尤其有用。
- packageSuppression
- 在訂單出貨時,要不要在包裝中夾帶廣告傳單:
1=夾帶
0=不夾帶
- addressfield1 到 addressfield3
- 可自訂的欄位。
- shippingGeoCode
- 視地理區域而定的出貨代碼,對稅金軟體特別有用。
- taxGeoCode
- 視地理區域而定的稅金代碼,對於稅金軟體特別有用。
範例
下列範例是更新通訊錄項目(其地址 ID 為 128,且名字為 Jeffery)。
https://myhostname/webapp/wcs/stores/servlet/AddressUpdate?
addressId=128&firstName=Jeffery&URL=/webapp/wcs/stores/servlet/
規則
- AddressUpdate 指令無法更新其它成員的地址,且無法更新暫時地址。
- 在每一種地址類型方面,可有零或一個主要地址(主要欄位等於 1)。
在您的更新中,若是將此地址從非主要改為主要,
則此指令會將此地址類型中的現有主要地址(若有的話)改為非主要。
- 無法更新暱稱。
- 如果鑑別模式是 LDAP,且這個地址是登錄地址(暱稱與登入 ID 相同,且 selfAddress 欄位等於 1),就會在 LDAP 伺服器中更新這個地址的資訊。
- 呼叫 AuditAddressCmd 作業指令來執行其它參數檢查。若商店程式開發人員想自訂檢查作業,則得在 AuditAddressCmd 作業指令中新增新程式碼。
- 以指定的暱稱,將新地址插入 ADDRESS 表格中。會將舊地址標為暫時,而將新地址標為永久。
- 如果指令失敗,則呼叫 AddressErrorView 指令。
- 一旦執行成功,則呼叫指定的 URL。
異常狀況
- URL 參數不得為空值,且其長度必須大於 0。
- addressId 參數不能是空值,且必須指向 ADDRESS 表格中屬於現行使用者的地址,且不能是暫時地址。
- 若有指定 nickName 參數的話,則 nickName 參數應與舊暱稱相同。
- primary 參數必須為空值,或者必須等於 0 或 1。
- publishPhone1、publishPhone2 與 packageSupression 參數必須為空值或整數。