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"。   

規則

異常狀況

相關概念

相關參照

IBM copyright