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

參數值
- http://host_name/path/
- (必要)WebSphere Commerce Server 和架構路徑的完整名稱。
- langId
- 設定或重設在階段作業期間的屬意語言;
有關商店的支援語言可在 STORELANG 表格中找到。
- forUser
- 將代替其執行指令之使用者或組織的登入 ID;只有具備處理訂單權限的人才可指定這個參數。
- forUserId
- 與 forUser 相同,但卻是 USERS 表格中之內部使用者 ID 所指的使用者。
- memberId
- 如果沒有指定 memberId,預設值是現行使用者
(要登入的使用者)。這個參數可用來新增組織實體或其他使用者的地址。
- URL
- (必要)當指令順利完成時所要呼叫的 URL。
- businessTitle
- 要新增地址之人在公司的職位(如總經理或經理)。
- nickName
- (必要)要新增之地址的暱稱或識別碼。
成員可有多個地址,且每一個各有一個暱稱。
使用者在登錄時所提供的地址會被系統視為登錄者自己的地址,
而系統會將該地址的暱稱設為使用者的登入 ID。
- personTitle
- 要輸入地址之使用者的稱謂(如博士、先生或小姐)。
- lastName
- 使用者的姓氏。
- firstName
-
使用者的名字。
- middleName
-
使用者的別名或姓名的起始字母。
- organizationName
-
使用者所代表的組織。
- organizationUnitName
- 使用者之組織中的單位名稱。
- officeAddress
- 組織內部地址(如收發中心)。
- primary
- 提供的地址是不是特定地址類型的主要地址:
1=主要
0=非主要(預設值)
- addressType
- 地址類型,例如:
R=住家地址(預設值)
M=郵寄地址
S=出貨地址
B=帳單地址
SB=出貨與帳單地址
如果沒有指定 addressType,預設值是 "SB"
- address1
-
使用者地址的第一行。
- address2
-
使用者地址的第二行。
- address3
-
使用者地址的第三行。
- city
-
使用者所在的城市名稱。
- state
-
使用者所在的州/省(縣/市)或對等轄區的名稱
- zipCode
-
使用者地址的郵遞區號。
- country
-
使用者所在的國家(或地區)名稱。
- bestCallingTime
- 白天或晚上電洽使用者:
- phone1
- 使用者的主要電話號碼。
- phone1Type
-
使用者主要電話號碼所用的電話類型,比方說,供聽障人士使用的 TTY、用於脈衝碼調變的 PCM,或行動電話的 CEL。這個欄位可有 3 個字元。
- publishPhone1
-
要不要列出使用者的主要電話號碼:
Y=是
N=否
- phone2
- 使用者的次要電話號碼。
- phone2Type
-
使用者次要電話號碼所用的電話類型,比方說,供聽障人士使用的 TTY、用於脈衝碼調變的 PCM,或行動電話的 CEL。這個欄位可有 3 個字元。
- publishPhone2
-
要不要列出使用者的次要電話號碼:
Y=是
N=否
- fax1
-
使用者的主要傳真號碼。
- fax2
-
使用者的次要傳真號碼。
- email1
-
使用者的主要電子郵件位址或網址。
- email2
-
使用者的次要電子郵件位址或網址。
- billingCode
- 買方組織的代碼,用以識別出貨或帳單地址以及成本中心。
- billingCodeType
- 代表帳單代碼所用之代碼結構方法的代碼。
預設值為 D(由買方指定)。值 02 表示由 Ariba 指定。
- taxPayerId
- 用來識別課稅使用者的字串,在搭配稅金軟體時尤其有用。
- packageSuppression
-
在訂單出貨時,要不要在包裝中夾帶廣告傳單:
1=夾帶
0=不夾帶
- addressfield1 到 addressfield3
-
可自訂的欄位。
- shippingGeoCode
- 視地理區域而定的出貨代碼,對稅金軟體特別有用。
- taxGeoCode
- 視地理區域而定的稅金代碼,對於稅金軟體特別有用。
範例 1
下列範例要利用暱稱 "mother_address" 在地址表格中新增一個項目。
https://myhostname/webapp/wcs/stores/servlet/AddressAdd?
nickName=mother_address&address1=7+Elm+St.&city=Toronto&state=Ontario
&country=Canada&zipCode=M4M+2T1&lastName=Lee&URL=/
範例 2
下列範例要新增一個完整的帳單地址。
https://myhostname/webapp/wcs/stores/servlet/AddressAdd?URL=basemall.jsp&nickName=msur1nickB
&addressType=B&primary=1&personTitle=Dr&lastName=last&firstName=first
&middleName=middle&address1=address1&address2=address2
&address3=address3&city=Toronto&state=Ontario&country=Canada
&zipCode=A1A1A1&phone1=111-111-1111&phone2=222-222-2222
&phone1Type=PHN&phone2Type=TTY&publishPhone1=1&publishPhone2=0
&bestCallingTime=E&fax1=333-333-3333&fax2=444-444-4444
&email1=msur1nickB@email1.com&email2=msur1nickB@email2.com
&businessTitle=bustitle&organizationName=organization
&organizationUnitName=oraganizationunit&officeAddress=officeaddress
&packageSuppression=0&addressField1=field1&addressField2=field2
&addressField3=field3&billingCode=billingCode&billingCodeType=BT
&shippingGeoCode=shippinggeocode&taxGeoCode=taxgeocode
附註:對於暫時和永久地址,每個成員可有一組地址。在建立地址時,它的狀態會標示為 "P"(表示「永久」),代表現行地址。
當地址更新時,會以所作的更新來建立新的地址記錄。新記錄會標示為 "P",較早的記錄會標示為 "T"(表示「暫時」),代表舊地址。
當以 AddressDelete 指令刪除地址時,
會將該地址的狀態標為 "T"。
規則
- 在每一種地址類型方面,可有零或一個主要地址(主要欄位等於 1)。
若新地址為主要的,
則此指令會將此地址類型中的現有主要地址(若有的話)改為非主要。
- 若未指定 primary 參數,則預設值為 0(無主要)。
- 如果沒有指定 addressType 參數,預設值為 'R'(住家地址)。
- 檢查指定的暱稱是否有人使用。
- 呼叫 AuditAddressCmd 作業指令,
以執行其它的參數檢查。
如果商店程式開發人員想自訂檢查作業,就必須在 AuditAddressCmd 作業指令中新增新的程式碼。
- 在 ADDRESS 表格中建立新地址。
- 如果該成員沒有通訊錄,則在 ADDRBOOK 表格中建立一筆新記錄。
- 如果指令失敗,則呼叫 AddressErrorView 指令。
- 一旦執行成功,則呼叫指定的 URL。
異常狀況
- URL 參數不得為空值,且其長度必須大於 0。
- nickName 參數不得為空值,其長度必須大於 0,且不得早已存在於這本通訊錄中。
- primary 參數必須為空值,或者必須等於 0 或 1。
- publishPhone1、publishPhone2 與 packageSupression 參數必須為空值或整數。