PunchOutSetup 指令
在從申請方使用者的採購系統收到 PunchOutSetup 訊息時,會使用這個控制程式指令。它執行買方組織的鑑別,
並將申請方使用者登錄為買方組織的成員(如果該使用者尚未登錄的話)。
附註:CIData 介面會攫取參數,因為通信協定之間的參數名稱可能會變動。初始時,PunchOutSetup 是使用預設的施行類別 CIDataImpl 來處理參數。您可以加以自訂,方法為擴充 PunchOutSetup 指令類別,並置換受保護的方法 initializeData() 來使用不同的 CIData 介面施行。
參數值
- http://host_name/path/
- (必要)WebSphere Commerce Server 和架構路徑的完整名稱。
- protocolName
- (必要)正在使用的通信協定的名稱。
- protocolVersion
- (必要)通信協定的版本。 若為使用 XML 訊息的通信協定,protocolName 和 protocolVersion 可宣告為映射範本 XML 檔案中的常數。
- logonId
- 採購買方管理者群組的登入 ID。這是非 HTTP/XML 通信協定的必要輸入欄位。 若為使用 XML 訊息的通信協定,
認證元素必須映射至 logonId 和 logonPassword 參數。
- logonPassword
- 採購買方管理者群組的登錄密碼。這是非 HTTP/XML 通信協定的必要輸入欄位。
- reqid
- (必要)通信協定的買方組織所使用的變動參數名稱。
這個參數是由 PROCBUYPRF 表格中的 REQIDPARM 欄位指定。
- supplierIdType
- (必要)供應商的代碼類型。這個參數是由 ORGCODE 表格中的 CODETYPE 欄位指定。
- supplierId
- (必要)supplierIDType 下的供應商的識別。這個參數是由 ORGCODE 表格中的 CODE 欄位指定。
- buyerIdType
- (必要)採購買方的代碼類型。這個參數是由 ORGCODE 表格中的 CODETYPE 欄位指定。
- buyerId
- (必要)buyerIdType 下的採購買方組織的識別。
這個參數是由 ORGCODE 表格中的 CODE 欄位指定。
- logonMode
- (必要)代表不同的登入模式,例如建立、視察或編輯。
- buyerCookie
- (必要)回應時送回採購系統的採購系統階段作業 Cookie。這可讓採購系統識別提出申請的買方。
- orderApprovalURL
- (必要)用於傳送訂單至採購系統的 URL。
- orderId
- 訂單參考號碼。如果使用 logonMode edit 呼叫了指令以更新先前已提交至採購系統的訂單,就會使用這個號碼。
操作方式
PunchOutSetup 指令呼叫下列作業指令:
- AuthenticationHelper
- DBProcurementAuthentication
- RegisterRequisitioner
若為 HTTP/XML 通信協定,在映射進入的 XML 訊息 PunchOutSetup 時會呼叫 PunchOutSetup 指令。若為透過瀏覽器通信協定的 HTTP,
則是直接從申請方使用者的瀏覽器中呼叫這個指令。
PunchOutSetup 指令會判定要使用的檢視和錯誤作業,
其判定方法為使用通信協定 ID、買方組織 ID,以及訊息名稱 PunchOutSetup(PunchOutSetup
定義於 PROCMSGVW 表格中的 MSGNAME 直欄)來查看 PROCMSGVW 表格。如果找不到任何項目,
表示項目是空值,或是指令在決定通信協定和買方組織之前失敗,
則使用預設的檢視和錯誤作業 PunchOutSetupOKView 和 PunchOutSetupErrorView。
