OrgEntityAdd 指令
這個指令會登錄新的組織或組織單位。
請搭配 SSL(安全 Sockets 層次)使用此指令,以確保資訊皆經過加密。
其做法是鍵入指令與 HTTPS 安全通信協定。

參數值
- http://host_name/path/
- (必要)WebSphere Commerce Server 和架構路徑的完整名稱。
- langId
- 設定或重設在階段作業期間的屬意語言;
有關商店的支援語言可在 STORELANG 表格中找到。
- forUser
- 將代替其執行指令之使用者的登入 ID;只有具備處理訂單權限的人才可指定這個參數。
- forUserId
- 與 forUser 相同,但卻是 USERS 表格中之內部使用者 ID 所指的使用者。
- orgEntityType
-
(必要)要新增之組織實體的類型。
O=組織
OU=組織單位
- orgEntityName
-
(必要)組織或組織單位的名稱。
- distinguishedName
-
組織或組織單位的識別名稱,供 LDAP 使用。
- parentMemberId
-
(如果 orgEntityType 等於 'OU',就是必要的)要新增之上層組織或組織單位的成員 ID;它是參照 MEMBER 表格的外來鍵。
如果是組織 (orgEntityType=O),這就不是必要的參數。
如果是組織單位 (orgEntityType=OU),則是必要的參數,且應該含有組織或組織單位的母項成員 ID。
- legalId
-
已登錄的組織識別碼;組織單位可為空值。
- businessCategory
-
說明組織或組織單位所執行的商業種類。
- preferredDelivery
-
遞送時應採用的方法。
- 說明
-
登錄者的說明。
- orgEntityField1 到 orgEntityField3
-
可自訂的欄位。
- taxPayerId
- 用來識別課稅使用者的字串,在搭配稅金軟體時尤其有用。
- lastName
- (如果鑑別模式是 LDAP,就是必要的)登錄者的姓氏。
如果鑑別模式是 LDAP,這就是必要的參數。
- firstName
- 登錄者的名字。
- middleName
- 登錄者的別名或姓名的起始字母。
- address1
- 登錄者地址的第一行。
- address2
- 登錄者地址的第二行。
- address3
- 登錄者地址的第三行。
- addressfield1 到 addressfield3
- 可自訂的欄位。
- addressType
- 地址的類型;可使用內容檔來架構有效值:S(出貨地址),B(帳單地址)以及 SB(出貨地址與帳單地址兩者)。單一地址可具有許多不同類型。如果找不到內容檔,則使用預設值 SB。
- officeAddress
- 內部地址(如收發中心)。
- billingCode
- 登錄者組織的代碼,用以識別出貨或帳單地址以及成本中心。
- billingCodeType
- 指定帳單代碼所用代碼結構方法的代碼。預設值為 D,由買方指派。值
02 代表由 Ariba 指定。
- city
- 登錄者所在的城市名稱。
- state
- 登錄者所在的州/省(縣/市)或同等名稱
- zipCode
- 登錄者地址的郵遞區號。
- country
- 登錄者所在的國家(或地區)名稱。
- phone1
- 登錄者的主要電話號碼。
- phone2
- 登錄者的次要電話號碼。
- phone1Type
-
登錄者主要電話號碼所用的電話類型,比方說,供聽障人士使用的 TTY、用於脈衝碼調變的 PCM,或行動電話的 CEL。這個欄位可有 3 個字元。
- phone2Type
-
登錄者次要電話號碼所用的電話類型,比方說,供聽障人士使用的 TTY、用於脈衝碼調變的 PCM,或行動電話的 CEL。這個欄位可有 3 個字元。
- publishPhone1
- 1=表示列出登錄者主要電話號碼的指示碼
- 0=表示不列出登錄者主要電話號碼的指示碼
這些 publishPhone 欄位沒有預設值。如果欄位維持沒有使用,資料庫中會保留空值。
- publishPhone2
- 1=表示列出登錄者次要電話號碼的指示碼
- 0=表示不列出登錄者次要電話號碼的指示碼
- bestCallingTime
- D - 表示白天是登錄者最佳電話聯絡時間的指示碼。
- E - 表示晚上是登錄者最佳電話聯絡時間的指示碼。
- fax1
- 登錄者的主要傳真號碼。
- fax2
- 登錄者的次要傳真號碼。
- email1
- 登錄者的主要電子郵件位址或網址。
- email2
- 登錄者的次要電子郵件位址或網址。
- businessTitle
- 登錄者的公司職稱。
- organizationName
- 登錄者所代表的組織名稱。
- organizationUnitName
- 登錄者所代表的組織內的單位名稱。
- packageSuppression
- 1=此指示碼表示在出貨時要在包裝中夾帶廣告傳單
- 0=此指示碼表示在出貨時不要在包裝中夾帶廣告傳單
這個欄位沒有預設值。如果欄位維持沒有使用,資料庫中會保留空值。
- shippingGeoCode
- 視地理區域而定的出貨代碼,對稅金軟體特別有用。
- taxGeoCode
- 視地理區域而定的稅金代碼,對於稅金軟體特別有用。
- administratorLastName
- 管理者的姓氏。
- administratorFirstName
- 管理者的名字。
- administratorMiddleName
- 管理者的別名。
- URL
- (必要)當指令順利完成時所要呼叫的 URL。
範例 1
下列範例會建立一個組織項目。
https://myhostname/webapp/wcs/stores/servlet/OrgEntityAdd?URL=MallFrontView.htm
&orgEntityType=0&orgEntityName=IBM
範例 2
下列範例會建立一個完整的組織項目。
https://myhostname/webapp/wcs/stores/servlet/OrgEntityAdd?orgEntityType=O
&orgEntityName=MSGROrg1Name&URL=basemall.jsp&distinguishedName=MSGROrg1DisName
&legalId=MSGROrg1RegName&businessCategory=MSGROrg1BusCategory
&preferredDelivery=MSGROrg1PreDelivery&description=MSGROrg1Description
&orgEntityField1=MSGROrg1Field1&orgEntityField2=MSGROrg1Field2
&orgEntityField3=MSGROrg1Field3
範例 3
下列範例會建立一個完整的組織單位項目:
http://myhostname/webapp/wcs/stores/servlet/OrgEntityAdd?orgEntityType=OU
&orgEntityName=MSGROrgUnit1Name&URL=basemall.jsp&distinguishedName=MSGROrgUnit1DisName
&memberId=xxx&legalId=MSGROrgUnit1RegName&businessCategory=MSGROrgUnit1BusCategory
&preferredDelivery=MSGROrgUnit1PreDelivery&description=MSGROrgUnit1Description
&orgEntityField1=MSGROrgUnit1Field1&orgEntityField2=MSGROrgUnit1Field2
&orgEntityField3=MSGROrgUnit1Field3
規則
- 如果 orgEntityType 參數等於 'O',memberId 參數等於空字串,則 memberId 欄位會設為空值。
- 呼叫 AuditAddressCmd 作業指令,
以執行其它的參數檢查。
若商店程式開發人員想自訂檢查作業,則得在 AuditAddressCmd 作業指令中新增新程式碼。
- 若指令失敗,則會呼叫 OrgEntityErrorView 檢視指令。一旦執行成功,則會呼叫指定的 URL。
異常狀況
- URL 參數不得為空值,且其長度必須大於 0。
- orgEntityType 參數必須是 O 或 OU。
- 若 orgEntityType 參數為 OU,則 memberId 參數為必要的,
亦即,memberId 參數不得為空值,且必須是一個參照 MEMBER 表格中之列的外來鍵。
- orgEntityName 不得為空值。