OrgEntityUpdate 指令
這個指令會更新組織或組織單位的相關資訊。
請搭配 SSL(安全 Sockets 層次)使用此指令,以確保資訊皆經過加密。
其做法是鍵入指令與 HTTPS 安全通信協定。
參數值
- http://host_name/path/
-
(必要)WebSphere Commerce Server 和架構路徑的完整名稱。
- langId
- 設定或重設在階段作業期間的屬意語言;
有關商店的支援語言可在 STORELANG 表格中找到。
- forUser
- 將代替其執行指令之使用者的登入 ID;只有具備處理訂單權限的人才可指定這個參數。
- forUserId
- 與 forUser 相同,但卻是 USERS 表格中之內部使用者 ID 所指的使用者。
- URL
-
(必要)當指令順利完成時所要呼叫的 URL。
- orgEntityId
-
(必要)這個組織或組織單位的 ID;它是參照 MEMBER 表格的外來鍵。
- orgEntityType
-
所要更新之組織實體的類型:
O=組織
OU=組織單位
- distinguishedName
-
組織或組織單位的識別名稱,供 LDAP 使用。
- memberId
-
(如果 orgEntityType=OU,就是必要的)要更新之上層組織或組織單位的成員 ID;它是參照 MEMBER 表格的外來鍵。
如果是組織 (orgEntityType=O),這就不是必要的參數。
如果是組織單位 (orgEntityType=OU),則是必要的參數,且應該含有組織或組織單位的母項成員 ID。
- legalId
-
已登錄的組織識別碼;組織單位可為空值。
- businessCategory
-
說明組織或組織單位所執行的商業種類。
- orgEntityName
-
組織或組織單位的名稱。
- preferredDelivery
-
遞送時應採用的方法。
- 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
- 登錄者所代表的組織內的單位名稱。
- orgEntityField1 到 orgEntityField3
-
可自訂的欄位。
- shippingGeoCode
- 視地理區域而定的出貨代碼,對稅金軟體特別有用。
- taxGeoCode
- 視地理區域而定的稅金代碼,對於稅金軟體特別有用。
- packageSuppression
- 1=此指示碼表示在出貨時要在包裝中夾帶廣告傳單
- 0=此指示碼表示在出貨時不要在包裝中夾帶廣告傳單
這個欄位沒有預設值。如果欄位維持沒有使用,資料庫中會保留空值。
- administratorLastName
- 管理者的姓氏。
- administratorFirstName
- 管理者的名字
- administratorMiddleName
- 管理者的別名。
範例
下列範例會將組織單位更新成組織。 https://myhostname/webapp/wcs/stores/servlet/OrgEntityUpdate?URL=orgEntityManage.htm
&orgEntityID=54&orgEntityType=O
規則
- 呼叫 AuditAddressCmd 作業指令來執行其它參數檢查。
若商店程式開發人員想自訂檢查作業,則得在 AuditAddressCmd 作業指令中新增新程式碼。
- 組織的 memberId 參數是選用的。如果要將組織的 memberId 設為空值,memberId 應該等於空字串。
- 若指令失敗,則會呼叫 OrgEntityErrorView 檢視指令。一旦執行成功,則會呼叫指定的 URL。
異常狀況
- URL 參數不得為空值,且其長度必須大於 0。
- orgEntityType 參數應為空值,且必須是 'O' 或 'OU'。
- 如果將 O 更新成 OU,且這個 O 的 memberId 欄位是空值,則 memberId 參數不應是空值。
- 如果 memberId 參數不是空值,它必須是參照 ORGENTITY 表格的外來鍵。