第 3 篇的各章涵蓋協同作業管理員模組內所能使用的每個元件。
- 匯入
- 匯出
- 協同作業區
- 佇列
- Web 服務
- 文件儲存庫
- 資料來源
- 遞送
- 產生的檔案
為了集中儲存與管理產品資訊, WebSphere Product Center 中建有一個主要型錄。下列各節說明從不同來源收集資料, 並將資訊組合到組織好的型錄結構過程中,所要執行的每一個步驟。
- 「匯入主控台」概觀
- 取得資料來源
- 定義建立匯入輸送所需的項目
- 設定一項匯入輸送
- 將送入檔案載入 WebSphere Product Center 中
匯入是一項將外部來源的資料輸入 WebSphere Product Center 的輸送作業。 匯入最初是用手動方式來配置,之後,就可以根據排定的時程表或隨需應變來執行。 WebSphere Product Center 可讓您從多個來源匯入多種資料類型(項目、二進位檔、種類樹、分類對映等)來完成多種目的(更新、取代、刪除)。
匯入主控台是從不同的資料來源建立型錄的工具。 「匯入主控台」形同一個交換機, 可將所有資料匯入到 WebSphere Product Center。從這裡,您可以檢視、 修改與建立要輸送到 WebSphere Product Center 的資料。
如果要建立匯入, 使用者必須定義與執行多項前往 WebSphere Product Center 的資料與檔案輸送。「匯入主控台」會呈現已建立的輸送清單。
如果要存取匯入主控台,請使用協同作業管理員 > 匯入 > 匯入主控台功能表路徑。
圖 7.1 - 匯入主控台
自訂主控台視圖
主控台可自訂成排序或隱藏直欄。設定會儲存到使用者的設定檔中。如果要自訂「型錄主控台」的視圖,請執行下列動作。
1. 在型錄主控台的右上角,按一下配置按鈕
。這時配置表格會出現在蹦現視窗中。
2. 若要排序直欄,請在「排序」直欄中做出選擇。只能單選。
3. 若要隱藏欄位,請在「隱藏」直欄中做出選擇。可以多選。
4. 在「其他選項」表格中,設定排序順序,以便按照升冪或降冪順序顯示, 並設定每頁所要顯示的列數。
5. 如果要儲存自訂的設定,請按一下儲存。「型錄主控台」會以新自訂的設定出現。
排列匯入清單
- 您可以利用匯入「類型」或匯入「名稱」來排列匯入主控台中的各項匯入。 請按一下「名稱」或「類型」直欄標題名稱來進行排序。
主控台直欄
下表列出匯入主控台的每個直欄。
類型
此圖示代表匯入的類型,有關匯入類型的清單,請參閱前一節「匯入主控台中的圖示」。
名稱
匯入的名稱
已擷取的檔案
這是一份已擷取到 WebSphere Product Center 文件儲存庫的來源檔案下拉選單
擷取
將資料來源手動載入 WebSphere Product Center
載入
將資料來源上傳到指定的型錄
語意
指出匯入要採用「更新」、「取代」或「刪除」類型。
來源
所用的來源檔案名稱
檔案規格/匯入 Script
所用的檔案規格或匯入 Script 名稱
對映
按一下此圖示,可檢視或編輯「檔案至型錄」對映
型錄/型錄樹
匯入所用的型錄與型錄樹
ACG
匯入所用的 ACG
在匯入主控台中建立匯入之前,請執行一些步驟來完成匯入的準備。 這一節說明在建立匯入和排定匯入時程表之前的下列準備作業:
- 取得資料來源
- 備妥資料
- 檢視資料檔
- 建立必要的物件來設定匯入
來源檔案必須已位於可存取的目錄或 FTP 站台中, 才能將資料匯入 WebSphere Product Center 中。請檢視資料檔案, 以確定所用的是最精確的產品資訊,且格式是採用下列這些適合匯入到 WebSphere Product Center 的資料來源之一:
- 以字元界定
- 以標籤界定
- 以逗點區隔的值 (CSV)
- 固定寬度
- XML
附註:來源檔案必須符合上述清單所提及的格式之一,才能繼續進行下一步驟。
檢查來源資料檔案是否可供存取到 WebSphere Product Center 中。如果檔案要透過 FTP 上傳, 請確定對 FTP 站台具備適當的許可權。必要時請聯絡適當的團隊成員。
分析來源資料檔案,並記下檔案結構、欄位與相關聯的屬性。當您在下一步驟中建置檔案規格時, 需用到此資訊。
在設定匯入之前,必須先有若干物件存在。這些物件有許多可以在設定匯入期間建立,但事先完成這些作業會比較容易。 設定匯入至少需要下列物件:
檔案規格 在配置匯入時,需要提供檔案規格。請參閱「資料模型管理員」一節,以取得建立檔案規格的說明。 主要規格 在配置 WebSphere Product Center 型錄結構的格式時需要提供主要規格。其中可能包括階層的規格。 請參閱「資料模型管理員」一節中,以取得建立主要規格的說明。 規格對映 如果要將資料適當遞送到正確的型錄,檔案規格必須對映至正確的型錄/階層。 請參閱「資料模型管理員」一節,以取得對映規格的說明。 利用主要規格建立型錄 建立和對映檔案、型錄和其他相關物件之後,下一步是建立型錄。 請參閱「產品管理員」一節,以取得建立型錄的詳細資訊。
依照「匯入準備」一節中所說明來設定好匯入項目之後,請定義如何將外部檔案資訊移入 WebSphere Product Center 型錄中。 匯入輸送的的定義是藉由建立新匯入來完成的。
圖 7.2 - 「新建匯入」精靈
建立新匯入
請使用協同作業管理員 > 匯入 > 新匯入功能表路徑,或匯入主控台中,按一下新建。 這時會出現「新建匯入」精靈。 請完成「建立匯入」精靈的每個步驟來建立匯入。
1. 匯入名稱
輸入匯入的名稱,並按「下一步」按鈕。
必須提供匯入名稱,以便和其他名稱有所區分。不容許名稱重複。所選的輸送名稱最好是容易理解的。
像「大型電腦中的項目屬性」或「型錄 X 的影像」即為理想的名稱。
2. 選取存取控制群組
請從「選取存取控制群組」下拉功能表中選取存取控制群組。如果存取控制群組不存在, 請按一下「新建」按鈕建立一個。
3. 選取資料匯入類型
從下拉功能表選擇一種資料匯入類型,並按一下「選取」按鈕。可供選擇的值有:
二進位檔輸送 輸送型錄中每個項目(就是影像、文件和 PDF)的二進位檔。 階層輸送 階層輸送包含一個階層,階層設計成用來組織型錄中的所有項目,以便進行瀏覽。 項目輸送 項目輸送包含必要的說明資訊,以便說明要在產品型錄中找到的每個型錄項目。 「項目至種類」對映輸送 「項目至種類」對映輸送是將型錄中的現有項目對映至將隨著傳入資料上傳的階層。 透過此項輸送,也可將內含新項目與適當分類資訊的檔案直接上傳至新型錄中。只要新增任何新種類, 即會更新階層。 4. 選取資料匯入語意
選擇一種匯入輸送語意,並按一下「選取」按鈕。
匯入輸送語意是指定傳入的檔案如何影響目的地型錄中的現有項目。
更新 以送入檔案所指定的項目來更新型錄中所找到的項目,並將只有送入檔案中才有的項目新增到型錄中。 取代 以送入檔案的內容來取代現行型錄的內容。 刪除 從型錄中刪除送入檔案中所指定的任何項目。 5. 選取資料來源
選擇一個資料來源名稱,並按一下「選取」按鈕。資料來源是定義要匯入至 WebSphere Product Center 的資料來源。
在這個步驟中,使用者可以修改或建立新的資料來源。 如果要建立新的資料來源,請按一下「新建」,如果要編輯資料來源,請按一下「編輯」按鈕。
建立新資料來源的步驟包括指定資料來源的名稱以及選取資料來源類型。 資料來源名稱應該儘可能具有描述性。 資料來源包括下列選項:
- 讓 WebSphere Product Center 透過 FTP 擷取
- 取自文件儲存庫(包括 FTP)
- 透過 Web 瀏覽器上傳
6. 選取字集
下一步驟是從「選取字集」下拉功能表中,選取送入檔案的編碼。 請選取與送入檔案相符的字集。 當傳入的檔案含有 26 個英文字母與 10 個數字以外的字元時, 此步驟特別重要。系統預設值為 "Cp1252: Windows Latin-1"。
附註:如果沒有選取適當的字集,匯入期間可能會發生問題。
7. 選取檔案規格
檔案規格定義送入檔案的屬性和格式。 請從下拉功能表中選取現有的檔案規格,或按一下新建來建立新的檔案規格。
8. 選取型錄
型錄用來定義在哪裡將資料匯入 WebSphere Product Center。 請選取現有的型錄,或按一下新建來建立新的型錄。
9. 選取檔案至型錄對映
請選取現有的對映,或按一下新建來建立新的對映。 如果要建立新的對映(或修改現有的對映),請利用下拉選單欄位來比對檔案規格中的每個欄位(左直欄),以符合型錄中的某個直欄(右直欄)。 如果是進階操作(欄位連結、字串操作等),請按一下「表示式編輯器」按鈕。
10. 選取型錄匯入 Script
依預設,一律會建立簡式型錄匯入 Script。 請選取預設的產生之 Script,或按一下新建來建立新的匯入 Script。
11. 選取核准權限
建立匯入輸送的最後一個步驟是選取核准權限。這個選用步驟容許選取一個使用者, 使其負責檢視匯入工作,並得經過其核准才能產生該工作。請選取在起始輸送時,應該通知哪位使用者。
12. 回到「匯入主控台」
到目前為止,已完成匯入輸送的配置,而最後的步驟是執行匯入工作, 以便在型錄中移入資料,而在 WebSphere Product Center 中進行管理。
定義好匯入之後,就可以手動排定匯入的時程表,或設定成隨需應變執行。在執行匯入之前,必須先取得外部資料來源檔。
將檔案載文件儲存庫
在「匯入主控台」中,每一項匯入輸送各有兩個「執行」按鈕,一個位於「擷取」直欄, 一個位於「載入」直欄。
如果要擷取外部傳入的檔案, 請按一下適當匯入輸送之「擷取」直欄的「執行」按鈕。所擷取的直欄會顯示 「沒有檔案可輸送」。在提取檔案時,下拉功能表中會出現檔案選項。
檔案一經提取後,會放在「文件儲存庫」中。「文件儲存庫」用以放置要移入或移出 WebSphere Product Center 的所有檔案與資料。這可在將檔案實際上傳至 WebSphere Product Center 前, 讓使用者有機會先預覽所有的檔案。
啟動匯入
位於「匯入主控台」中的第二個「執行」按鈕會將所提取的檔案從文件儲存庫上傳到 指定的型錄。請從「載入」直欄,按一下「執行」按鈕。
此外可配置一項警示,以透過電子郵件或首頁中的「警示」模組,告知載入已完成。如果指派了核准權限,便可利用使用者首頁中的「警示」模組介面來核准或拒絕輸送。 接著,可透過「產品管理員」模組來管理產品資訊。
修改匯入
如果要修改匯入,最好是刪除舊匯入再建立新匯入。舉例來說, 目前並無方法來選取新檔案規格。如果要使用不同的檔案規格,請建立新匯入, 然後選取適當的檔案規格。
刪除匯入
輸送可以刪除,其方法是按一下每一項輸送第一個直欄中的「刪除」按鈕。
附註:刪除輸送是無法回復的。 這時會出現一個對話框來確認是否要刪除匯入輸送。
二進位檔必須經過壓縮才能匯入至 WebSphere Product Center。舉例來說,如果要匯入一個影像群組, 則在來源目錄中建立一個 *.zip 檔。一旦擷取壓縮檔後, 會將它儲存在 WebSphere Product Center 的文件儲存庫中,然後再解壓縮到文件儲存庫的 /public_html/ctg_files 目錄中。二進位檔可包括 jpg、gif 或 pdf 檔。
圖 7. 4 - 上傳二進位檔輸送
建立二進位匯入
下列步驟是建立二進位檔的匯入輸送。
請使用協同作業管理員 > 匯入 > 匯入主控台功能表路徑,這時會出現匯入主控台。 請按一下「新建」來存取「新建匯入」精靈。 完成精靈中的每一個步驟。
1. 匯入名稱 – 輸入二進位檔輸送的名稱
2. 選取存取控制群組 – 選取輸送所用的存取控制群組。
3. 選取匯入類型 – 選取「二進位檔輸送」
4. 選取匯入語意 – 選取「更新」
5. 選取資料來源 – 選取二進位檔輸送的資料來源,或者新建一個
保留 zip 保存檔中的路徑:Y 或 N
請一律選取「否」。所有的影像檔會儲存在文件儲存庫的 "public_html/ctg_files" 中。 如果您保留保存檔的路徑,則影像會解壓縮到錯誤的目錄中。
6. 輸入文件儲存庫路徑
保留空白,並按「下一步」。系統會假設為文件儲存庫的路徑, 而不需要再輸入路徑。在應用程式解壓縮檔案時,它會將所有影像放到 ctg_files 目錄中。
7. 選取對檔案名稱與路徑採取的動作
接受預設值都不 - 這個選項被告知影像來自下游系統。在此情況下,不論影像檔為大寫或小寫都不會有問題。
8. 選取核准權限 – 必要時可選取要核准匯入的使用者。
這是完成匯入輸送的建立。下個步驟是將壓縮檔上傳至 WebSphere Product Center。
上載壓縮檔
定義好二進位匯入輸送之後,下一步驟是將壓縮檔擷取到 WebSphere Product Center 中。 此輸送應在「擷取檔案」直欄中顯示「沒有檔案可輸送」。
1. 從「匯入主控台」,找出新建的輸送,並從「擷取」直欄按一下「執行!」。
2. 按一下「瀏覽」,選取壓縮檔, 然後按一下「上傳」。zip 檔的路徑會出現在「檔案」欄位中。
3. 回到「匯入主控台」,或檢視文件儲存庫中的檔案, 並選取「協同作業管理員」功能表中的「文件儲存庫」。
所有上傳的檔案會儲存在組織之 "feed_files" 目錄的子目錄中, 它會以匯入輸送的名稱來命名。
一旦壓縮檔上傳至文件儲存庫後,會將之解壓縮。
解壓縮二進位檔
1. 從「匯入主控台」, 在「載入」直欄中按一下「執行!」。WebSphere Product Center 會將影像解壓縮至 ctg_files 目錄。
2. 若要檢查處理載入的狀態, 請按一下「檢查更新的狀態」超鏈結。
當載入完成時,「排程狀態資訊」會顯示「已完成執行」狀態。請按一下文件儲存庫超鏈結, 檢視所有解壓縮的二進位檔。
您可以從外部資料來源中,將現有的匯入表匯入 WebSphere Product Center 中。 建立一項參考表匯入類似於利用「新建匯入」精靈來建立任何其他匯入。
建立參考表匯入
請從匯入主控台中,按一下新建。這時會出現「新建匯入」精靈。
1. 選取唯一輸送名稱。
2. 選取存取控制群組。
3. 選取資料類型"項目輸送"。
4. 選取相關的輸送語意、資料來源和檔案規格
5. 從"選取型錄"欄位中,選取要匯入的參考表
6. 定義檔案至參考表的對映
7. 選取匯入 Script。必要的話,請建立新的匯入 Script。
8. 必要的話,請選取核准權限。
9. 儲存新的匯入輸送。
10. 執行匯入
WebSphere Product Center 可讓您建立針對任何內部或外部目的地所自訂的型錄。型錄可自動發佈給客戶、合作夥伴,以及印刷型錄,或者發佈給公司網站。下列各節說明分送或發佈產品資訊到任何目的地時所用的方法。
- 匯出概觀
- 準備型錄以便匯出
- 建立匯出
- 執行匯出
- 管理匯出
建立匯出是為了將產品資訊分送或發佈給客戶(內部或外部)。 透過 WebSphere Product Center 的彈性架構, 企業可使用單一資料儲存庫,以多個型錄連接多個市場。
透過 WebSphere Product Center 的「匯出主控台」,可執行下列作業:
- 將型錄匯出成任何格式
- 發佈變異項
- 發佈內容的子集
- 合併目的地特有的資料與標準資訊
匯出主控台直欄
類型
此圖示代表聯合的類型;請參閱「匯出主控台中的圖示」一節
名稱
匯出工作的名稱
型錄項目
所要聯合的型錄名稱與項目群組名稱
版本
所要聯合的型錄版本
對映
檢視/編輯型錄規格與目的地規格間的對映性質
目的地規格
目的地規格名稱
檔案類型
所用的型錄匯出 Script 名稱與所設定的參數值。
階層
所用的階層名稱,按一下以檢視或編輯。
工作資訊
聯合工作的詳細資訊。檢視工作的執行時間、狀態、警告與產生的檔案清單。
核准
如果在進行聯合前需經過核准,此直欄中會出現「已同意」或「已拒絕」狀態
警示
若有為聯合配置警示,它會出現在這個直欄中
目的地
聯合的目的地模式
下列各節說明必須有哪些項目,才能設定型錄以便匯出。雖然有些項目可透過設定匯出精靈來執行, 較有益的做法是事先備妥項目,以簡化設定程序。
目的地規格
當在 WebSphere Product Center 中建立匯出工作時, 會需要目的地規格, 以定義目的地檔案的精確需求。目的地規格類似於檔案規格或主要規格,它的每個節點都是用屬性來定義。 在資料匯出期間, 目的地規格會產生一個檔案,此檔案遵循一組預先定義的需求。
項目選項
資料模型管理員的匯出元件允許將某型錄中的某項目群組基本選項推送到特定目的地型錄中。 「基本選項」包含匯出作業所用的型錄、型錄版本與階層。
型錄至目的地對映
「型錄至目的地規格」對映和匯入所用的「檔案至型錄」對映類似, 其中它會指示 WebSphere Product Center 應如何遞送型錄中的欄位。型錄中的欄位會對映至目的地檔中的欄位。必須進行這項對映, 聯合才能成功。
階層
如同「匯入」一章中所述,在 WebSphere Product Center 中, 階層和型錄是分開儲存的。這可讓使用者使用所選的階層來檢視與匯出型錄。
目的地模式
型錄一旦匯出後可送出到多個目的地, 以便進行核准與(或)驗證。聯合的分送元件可讓使用者選取型錄的傳送目的地。型錄可以用電子郵件(在電子郵件主體中)或 FTP 的形式來傳送。
當建立新的匯出時,"建立新匯出"精靈會帶您逐步執行設定匯出的每個步驟,這有助於簡化完成程序。
在精靈的每個步驟期間,您可以使用下列功能按鈕:
編輯
新建
選取
![]()
繼續進行下一步驟
回到「匯出主控台」
設定匯出
請使用協同作業管理員 > 匯出 > 新建匯出,或從匯出主控台中,按一下新建按鈕,這時會出現「目的地上傳」精靈。請完成精靈驅動的 GUI 的每個步驟。
1. 匯出名稱 - 請輸入匯出的新名稱,再按下一步。請建立唯一且很容易識別的名稱。
2. 選取目的地規格 - 規格本身代表最後會匯出之資料的每個欄位的格式、長度和必要性。 必要的話,使用者可以按一下適當的按鈕來建立或編輯目的地規格。
3. 選取型錄 - 請從「選取型錄」下拉欄位中選取任何先前建立的型錄來指定所要匯出的型錄。一般而言, 選擇要匯出的型錄會鎖定特定的客戶。亦即,它只包含特定客戶才有的專屬資訊。
此資訊可包含定價、合約有效日期與客戶產品 ID 等資料。透過「型錄至目的地規格」對映, WebSphere Product Center 可匯出主要或子項型錄中的資料。
4. 選取版本 - 選取型錄版本不但使用者有機會選取要匯出的型錄,它們也可以選取型錄的版本。 WebSphere Product Center 會自動儲存每一個型錄的每一份版本 (只要有上傳或修改的話)。當執行輸送或匯出時, 它也會為型錄建立新版本。此特性可讓使用者匯出同一型錄的舊版本, 舉例來說,萬一不希望將型錄中某些後來新增的項目傳給特定的客戶時,便可如此做。
- 最新的版本 - 請確定每次執行工作時,都會匯出最後的產品資訊,其中包括所有更新項目。 這個選項是"動態"的。
- 任何其他版本 - 請確定每次執行工作時,都會匯出相同的特定型錄版本。 這個選項是"靜態"的。
5. 選取項目群組 - 請從整個型錄中,選取要推送至特定目的地之項目群組的基本選項。 「基本選項」包含聯合作業所用的型錄、型錄版本與階層。您可以利用產品管理員模組的項目選項主控台來檢視和建立項目選項。 選項範例只能用來匯出特定產品系列。
6. 選取階層 - 這個特性可讓使用者匯出某所選型錄階層內每個項目的分類。 雖然選取階層本身即可決定所要匯出的種類, 但這不能確保種類本身會隨輸出檔一起傳送。種類本身必須包含在此項匯出的型錄匯出 Script 中。型錄匯出 Script 會要求配置一個獲授權的使用者,且輸出檔不會包含種類, 除非將之寫到型錄匯出 Script 中。
7. 選取聯合類型 - 藉由選取匯出類型,WebSphere Product Center 提供了供使用者選擇將整個型錄聯合到型錄中或只是將更新聯合到型錄中的選項。 如此便能匯出各種型錄變異。
- 某一版本中的所有項目
- 兩個特定版本間的內容差異
- 自前次聯合以來的內容差異
- 某一版本中之項目的所有影像與二進位檔
- 兩個特定版本之間更新過的影像和二進位檔
- 自前次聯合以來又更新過的影像和二進位檔
如果選取「差異」匯出類型,請選取要針對它來產生差異的第二個型錄版本。 差異類型包括:
- 全部
- 已新增
- 已刪除
- 已修改
- 不變
8. 選取型錄至目的地對映 - 請選取現有的對映,或按一下新建來建立新的對映。 如果要建立新的對映(或修改現有的對映),請利用下拉欄位來比對型錄中的每個欄位(左直欄),以符合目的地規格中的某個欄位(右直欄)。
9. 選取字集 - 請選取一個字集來選擇送出檔的編碼。當送出的檔案含有 26 個英文字母與 10 個數字以外的字元時, 此步驟特別重要。
預設值為 Cp1252:Windows Latin-1。
10.選取分送 - 分送的設計是為了在應用程式本身之內和之外,向個人發出通知。 分送和電子郵件別名類似。藉由在 WebSphere Product Center 中建置這些分送清單,便能夠和 WebSphere Product Center 外的人取得聯繫。必要時, 請建立新分送模式。
11.選取型錄匯出 Script - 在匯出期間,會使用型錄匯出 Script。 它們可在型錄所保留的資料實際匯出到輸出檔之前,用來執行這些資料的進階即時作業。 在匯出期間透過 Scripting 引擎對內容所作的修改, 不是套用在型錄上,而只是當成一次內容修改般套用在輸出檔上。
和匯入類似,當要匯出至外部目標檔時,可採取下列兩種形式: 採一對一方式將型錄中的欄位對映至外部目標檔,或者型錄中的欄位需要先進行部分修改再匯出至外部目標檔。
所有的匯出作業皆需用到 Script。和匯入相反, 在匯出期間必須選取一個 Script。
12.選取核准權限 - 允許選取一個使用者來負責檢視匯出工作以及決定工作的執行時間。請從系統使用者清單中選擇,並按一下「選取」。
13. 回到「聯合主控台」
一旦完成上述所有步驟後,會出現一個訊息框, 通知將匯出設定檔新增到「匯出主控台」中。請按一下畫面底端的倒退箭頭按鈕,以回到「匯出主控台」。此時匯出工作已設定完畢且準備產生。
配置好匯出工作之後,就可以手動產生它,或利用排程器來自動產生。 如果工作還需經過核准, 工作必須經過核准權限同意後才能產生。
手動執行匯出
如果要手動執行匯出工作,請執行下列動作:
1. 使用協同作業管理員 > 匯出 > 匯出主控台功能表路徑來檢視所有匯出工作的清單。
2. 找出所要執行的匯出工作。按一下最左側直欄中的勾選框。
3. 按一下執行按鈕。若有設定核准權限,匯出工作雖會啟動, 但必須經過授權後,才會將檔案匯出至目的地。匯出工作的狀態可透過排程器的「工作主控台」 (位於「資料模型管理員」模組中)來檢視。
驗證匯出進度
當匯出在執行時,使用者可以按一下綠色動畫圖示來檢視匯出的進度。 進度列用來指示匯出的完成進度。 如果要岔斷匯出,請按一下匯出左側的紅色圖示;這時會顯示一個確認對話框。
匯出完成之後,進度列便會消失。 這時會提供一份含有詳細資料的摘要,如通往匯出期間所建立之所有檔案的超鏈結,以及匯出期間所發生的錯誤/警告。
檢視輸出
當產生匯出時,在傳送給所定義的目的地前,會先儲存到文件儲存庫中。如果需要的話, 可檢視與列印所產生之檔案的結果。
檢視匯出結果
如果要檢視輸出結果,請執行下列動作:
1. 從匯出主控台中,按一下「工作資訊」直欄中的狀態按鈕,這時會出現「排程狀態資訊」表格。
2. 按一下「回覆值」直欄中的超鏈結, 此時會出現「作業核准資訊」介面,其中列出所產生的檔案。每一個檔案皆為超鏈結, 當點選時,會開啟一個新視窗,其中顯示檔案的詳細資料。
檢視匯出檔
標準匯出會產生一個標題為 'catalog.out' 的檔案。 您可以檢視這個檔案,將它儲存在本端或網路磁碟機中。
檢視匯出檔
- 如果要檢視匯出檔,請從匯出結果畫面中,按一下 'catalog.out' 超鏈結,這時會在新的瀏覽器視窗中開啟這個檔案。
核准輸出
如果匯出工作配有核准權限, 則必須先經過核准才能執行工作。從核准者的「我的作業清單」圖示中,按一下「核准」直欄中的「核准擱置中」,這時會出現「作業核准資訊」介面。 請同意或拒絕匯出工作,並提供理由。
檢視和修改匯出元件
在「匯出主控台」畫面中,容許使用者檢視與(或)修改匯出工作(幾乎是每一個元件皆可)。使用者可檢視將收到型錄的客戶清單, 「型錄至市場規格」對映,以及型錄排定要聯合的日期與時間。使用者可按一下型錄名稱,以修改所要匯出的型錄。
匯出狀態
如果要檢視匯出工作的狀態,請按一下「工作資訊」直欄中的「排程」按鈕, 此時會出現「排程狀態資訊」。然後按一下「工作資訊」直欄中的「檢視詳細資料」按鈕。
一旦執行完所要匯出的型錄後, 使用者可檢查下列的工作詳細資料:
- 工作資訊
- 排程資訊
- 執行時間
- 工作狀態
- 回覆值
檢視匯出狀態
如果要檢視匯出工作的工作狀態,請執行下列動作:
- 從匯出主控台中,按一下「工作資訊」直欄中的排程按鈕。會出現「排程狀態資訊」表格,其中顯示聯合工作的詳細資訊。
刪除匯出
必要時,可建立與刪除匯出工作。
刪除匯出
如果要刪除匯出工作,請執行下列動作:
1. 從匯出主控台中,找出要刪除的聯合工作。按一下最左側直欄中的勾選框。
2. 按一下「刪除」按鈕,這時會從主控台中刪除匯出工作。
如果匯入或匯出的執行出問題,工作摘要上會顯示錯誤或警告的超鏈結。
- 錯誤通常是較嚴重的問題,而足以妨礙項目的處理成功 (亦即,未提供主要鍵或未提供必要欄位)。
- 警告通常是較不嚴重的問題, 應不致於妨礙項目的處理成功(亦即,欄位太長)。
有時工作將無法順利完成,並顯示錯誤(而非顯示摘要)。請仔細記錄發生問題的情況,記下錯誤訊息,以便進一步分析。
已實作「佇列」新特性來維護多種佇列類型與多個傳訊通訊協定。佇列形同一個閘道, 可處理和外部來源/目的地(包括 EAI 平台與 Web 伺服器)間的入埠與離埠傳訊。
附註:請繼續「實作傳訊組織架構」一節,以取得如何設定「傳訊組織架構」的相關資訊。
以下的定義詞彙可供您參考:
- 佇列 - 這是一種 WebSphere Product Center 建構,用來作為訊息的接收和傳輸點。會有一個 Script 以支援每一個佇列。
- 訊息 - 這是一份 UCCnet、EAI 平台、資料儲存池或其他訊息來源所提供的 XML 文件
透過這種新佇列特性,訊息可當成程序的一部分, 因此,當匯入或匯出工作時,即會將狀態訊息傳給所有必要的當事人。
存取佇列主控台
協同作業管理員 > 佇列 > 佇列主控台功能表路徑可用來顯示「佇列主控台」。
檢視佇列的詳細資料
若要檢視佇列的詳細資料,請按一下佇列名稱,此時會出現「佇列詳細資料」畫面。其中提供的資訊如下:
- 佇列名稱
- 說明
- 通訊協定
- Script
檢視佇列中的訊息
「佇列主控台」中的「訊息」直欄含有一個超鏈結, 可列出佇列已收到的訊息數。請按一下訊息數, 以檢視訊息的內容。
在佇列中搜尋訊息
1. 如果要在佇列中搜尋某個訊息, 請使用「協同作業管理員」>「佇列」>「訊息主控台」功能表路徑。會出現「佇列訊息搜尋」畫面。
2. 選取下列欄位的值
- 起始的送達日期
- 結束的送達日期
3. 按一下「搜尋」;結果會顯示在下列的「佇列訊息」表格中。
建立佇列
1. 使用「協同作業管理員」>「佇列」>「新佇列」功能表路徑。
2. 輸入必要的資訊:
佇列名稱:請輸入佇列的名稱
說明:請輸入佇列的說明
通訊協定:請從傳訊通訊協定清單中挑選,以供外部來源與佇列通訊時使用。
Script:請從可執行的預先撰寫 Script 清單中挑選,以便在佇列間傳遞訊息。目的地/來源的典型訊息包括:
- 工作流程協同作業區,工作流程步驟中的輸入或輸出 Script 支援這個項目
- 型錄,前處理、後處理或後儲存 Script 支援這個項目
WebSphere Product Center 所實作的傳訊組織架構可和下列目標 EAI 平台整合:
- IBM WBI
- SeeBeyond
- Tibco
- WebMethods
所選的平台應為程式提供一個可靠的傳輸機制以及一致的介面, 以便跨越不同系統或平台彼此通信。
WebSphere Product Center 的傳訊組織架構可支援下列程序:
- 接收內含項目集的訊息,包括提供收到時的確認通知訊息。
- 傳送內含項目集的訊息,包括在傳輸後接收確認通知訊息。
WebSphere Product Center 還附有剖析與建立 XML 文件的功能, 並且能夠傳送訊息給 EAI 平台佇列, 以及收集 EAI 平台佇列所發的訊息。訊息會定義成外部來源所提供的 XML 文件。此功能全可供 WebSphere Product Center Scripting 引擎存取。若要讓 WebSphere Product Center 與 EAI 平台配接器間可以交談, 必須安裝可利用此項功能的 Script。
WebSphere Product Center 支援佇列, 而此項建構形同傳訊中的接收與傳輸點。WebSphere Product Center 佇列形同一個閘道, 可處理和外部來源/目的地間的入埠與離埠傳訊,且 WebSphere Product Center Scripting 作業支援每一個佇列。
佇列提供的功能如下:
可設定一個訊息傳輸通訊協定,以供外部訊息來源和佇列通訊時使用, 並提供下列的訊息傳輸通訊協定:
- MQ
- JMS 點對點
- JMS 發佈和訂閱
- HTTP
- HTTP/S
執行 Script,以便在佇列間傳送訊息。典型的目的地訊息/來源包括 -
- 工作流程協同作業區 - 工作流程步驟中的輸入或輸出 Script 支援這個項目
- 型錄 - 前處理、後處理或後儲存 Script 支援這個項目。
下表描述傳訊功能的組織架構:
- 外部來源傳送訊息給 EAI 平台。此作業的處理方式會因外部來源而異, 且不會影響 WebSphere Product Center 擷取訊息的方式。
- EAI 平台的設定應包含一個入埠與離埠佇列。此項設定由協力廠商來完成, WebSphere Product Center 唯一需要知道的資訊(為了接收與傳送訊息)是 WebSphere Product Center 所要存取之佇列的識別。
- 由於檔案會放到 EAI 平台佇列中,在 WebSphere Product Center 上設定一個對應的佇列, 便能夠透過支援的通訊協定(MQ、HTTP/s 或 JMS)接收訊息。
- 透過 WebSphere Product Center Script,可剖析主體的訊息,以取得訊息類型、 訊息 ID 與訊息來源。此資訊會遞送至為放置所有訊息而建立的目標 WebSphere Product Center 型錄中。
- 發生在 D 中的事件會使用工作流程來追蹤, 一旦訊息記錄成功,事件會觸發「確認通知工作流程」,以便將新記錄從訊息型錄移出到協同作業區設定中。
- 「確認通知工作流程」會將確認通知訊息傳給訊息來源以進行確認。當完成確認時, 「確認通知工作流程」會將訊息移回型錄中。
若要進行此程序,必須建置一個傳訊組織架構。
建置傳訊組織架構
下列程序描述整合 EAI 平台組織架構的建議做法。此程序可根據特定需求來自訂。
接收訊息
本節說明「接收內含項目集的訊息」程序,包括提供收到時的確認通知訊息。支援「接收訊息」程序的程序有兩種:「設定」與「執行時期」。這個程序是通用的,適用於大部分用途。
設定
1. 技術商業程序分析師將建立下列:
2. 技術商業程序分析師建置一個包含 Script 的入埠佇列。Script 支援下列三種功能 - 訊息的接收、 訊息主體的剖析以及遞送。
訊息的接收
Script 中的「訊息的接收」區段可支援下列功能:
- 透過支援的通訊協定(包括 MQ、HTTP/S 或 JMS)從來源取得訊息
- 剖析訊息主體,以取得訊息類型、訊息 ID、訊息來源
- 在內含訊息類型、訊息 ID、傳送者 ID 與日期時間的訊息型錄中建立記錄
- 觸發「確認通知工作流程」事件。請參閱下列的「確認通知工作流程」功能。
訊息主體的剖析
Script 中的「訊息主體的剖析」區段可支援下列功能:
- 以參數方式包含「來源至目的地」對映名稱與目標型錄名稱
- 根據「來源至目的地」對映名稱與目標型錄名稱,來剖析訊息主體, 以呈現項目集
訊息的遞送
Script 中的「遞送」區段可支援下列功能:
在目標型錄中新增/修改/刪除項目集中的項目
- 技術商業程序分析師設定確認工作流程,以傳送接收確認訊息。工作流程的功能如下:
- 在「確認通知工作流程」的一個步驟中,將新記錄從訊息型錄移出至協同作業區中。
- 「確認通知工作流程」中的下一步是傳送確認通知訊息給訊息來源,其含有訊息 ID、 傳送者 ID、日期時間以及訊息來源所需之任何指令(例如:已收到)。
- 「確認通知工作流程」中的下一步是移入訊息型錄記錄。
執行時期
一旦適當配置設定後,應會發生下列的執行時期事件。
1. 經由佇列 Script 的「訊息接收」區段,佇列將會收到訊息。
2. 佇列 Script 的「訊息接收」區段會剖析訊息主體,以取得訊息類型、訊息 ID、傳送者 ID
3. 佇列 Script 的「訊息接收」區段會在訊息型錄中建立記錄,其含有訊息類型、 訊息 ID、傳送者 ID 與日期時間
4. 佇列 Script 的「訊息接收」區段會在「確認通知工作流程」的一個步驟中,將新記錄從訊息型錄移出至協同作業區中。
5. 「確認通知工作流程」中的下一步是傳送確認通知訊息給訊息來源,其含有訊息 ID、 傳送者 ID、日期時間以及訊息來源所需之任何指令(例如:已收到)。
6. 「確認通知工作流程」中的下一步是移入訊息型錄記錄。
7. 佇列 Script 的「訊息主體剖析」區段會根據對映名稱與目標型錄名稱,來剖析訊息主體 (使用以下所引用的新 Script 作業),以呈現項目集
8. 佇列 Script 的「遞送」區段會使用現有的 Script 作業(對型錄進行新增/修改/刪除) 在目標型錄中新增/修改/刪除項目集中的項目。
建立 WebSphere Product Center 入埠/離埠佇列
WebSphere Product Center 入埠與離埠佇列是使用「佇列主控台」來建立。在建立任何佇列前, 必須先從「Script 主控台」建立一個觸發 Script。觸發 Script 會出現在「新佇列」畫面的「觸發 Script 路徑」下拉欄位中。
1. 在佇列主控台中,按一下新建。
2. 在「佇列詳細資料」畫面中,輸入佇列名稱、說明; 請選取一個通訊協定與觸發 Script 路徑。觸發 Script 會以「訊息佇列處理器」類型建立在「Script 主控台」中。
3. 按一下儲存。
WebSphere Product Center Script 作業在撰寫 WebSphere Product Center Script 應用程式方面提供頗大的彈性, 可讓您在每一個 Script 作業的引數中定義功能。本節中指出的下列 Script 作業用以支援使用 MQ 或 JMS 之 WebSphere Product Center 所支援的傳訊特性。這些方法容許從外部佇列匯入與匯出訊息。
附註:本節所列的 Scripting 作業可能會有變動。請參閱「Script 沙坑」,以取得最新的 Script 作業。
MQ Scripting 作業
在建立 Script 應用程式時,Script 作業 mqGetQueueMgr 會傳回處理常式給 MQQueueManager; 您可使用該控點,先建立多項 MQ 作業,然後再呼叫 mqDisconnect 釋放控點。
mqGetQueueMgr
- 原型:MQQueueManager mqGetQueueMgr(String hostname, String port, String channel, String queueMgrName)
- 說明:使用給定的內容來建立並傳回新 MQ 佇列管理程式。
mqDisconnect
- void MQQueueManager::mqDisconnect()
- 切斷和給定佇列管理程式間的連線。
mqSendTextMsg
- 原型:MQMessage MQQueueManager::mqSendTextMsg(String msgText, String queueName, String queueOpenOptions, String messagePutOptions)
- 說明:經由 queueName 傳送 String msgText 中所提供的訊息。傳回 MQMessage
附註:如果試圖利用 mqSendReply 來傳送給定訊息的回覆,且使用了 mqSendTextMsg,就會傳回錯誤。 若要避免此錯誤,請使用 mqSendTextMsgWithReply
mqSendTextMsgWithReply
- 原型:MQMessage MQQueueManager::mqSendTextMsgWithReply(String msgText, String queueName, String replyQueueName, String queueOpenOptions, String messagePutOptions)
- 說明:經由 queueName 傳送 String msgText 中所提供的訊息。會指定回覆佇列。傳回 MQMessage 物件。
mqGetTextFromMsg
- 原型:String mqGetTextFromMsg(MQMessage mqMessage)
- 說明:傳回內含整個 MQMessage 內容的字串,包括標頭。
mqGetReceivedMsg
- 原型:MQMessage MQQueueManager::mqGetReceivedMsg(String queueName, String queueOpenOptions, String messageGetOptions)
- 說明:從 queueName 接收訊息。 以 MQMessage 方式傳回訊息或空值。
附註:當擷取訊息時,會將訊息從佇列中移除。 除非指定訊息 ID,否則,會取得佇列中的第一個訊息。
mqSendReply
- 原型:MQMessage MQQueueManager::mqSendReply(MQMessage receivedMsg, String msgText, String passedInQueueOpenOptions, String passedInMessagePutOptions)
- 說明:傳送對給定訊息的回覆,但不指出成功或失敗。
mqSendReplyWithStatus
- 原型:MQMessage MQQueueManager::mqSendReplyWithStatus(MQMessage receivedMsg, String msgText, String status, String passedInQueueOpenOptions, String passedInMessagePutOptions)
- 說明:傳送對給定訊息的回覆,其中設有回饋欄位, 以指出給定的狀態。狀態必須是下列之一(大寫或小寫):SUCCESS、FAIL、VALCHANGE、VALDUPES、 MULTIPLE_HITS、FAIL_RETRIEVE_BY_CONTENT、BO_DOES_NOT_EXIST、UNABLE_TO_LOGIN、APP_RESPONSE_TIMEOUT、NONE。
附註:只能使用一個狀態值。
mqGetXMLMessageContent
- 原型:String mqGetXMLMessageContent(String orgXmlMsg)
- 說明:捨棄輸入字串開頭的任何無用字元,以取得 XML 文件。 更精確地來說, 其行為如下: 如果輸入字串的格式為 A + B,其中 B 為有效的 XML 文件, A 為任何字串(可能是空的),此作業會傳回 B。 否則,會傳回空值。
附註:請利用這個方法來剖析送入的訊息。
mqGetResponseToMsg
- 原型:MQMessage MQQueueManager::mqGetResponseToMsg(MQMessage outgoingMessage, String queueOptions, String messageOptions)
- 說明:從給定佇列取得對給定訊息的回應。
mqGetMessageDiagnostics
- 原型:String mqGetMessageDiagnostics(MQMessage message)
- 說明:傳回內含給定訊息之相關診斷資訊的字串。
mqGetMessageId
- 原型:String MQMessage::mqGetMessageId()
- 說明:以字串形式(內含一個十六進位數字)傳回給定訊息的 ID。
mqGetReceivedMsgByMessageID
- 原型:MQMessage MQQueueManager::mqGetReceivedMsgByMessageID(String queueName, String messageId, String passedInQueueOpenOptions, String passedInMessageGetOptions)
- 說明:在給定佇列中尋找該給定訊息 ID 的訊息。 ID 是以字串形式(內含一個十六進位數字) 來傳遞的。 如果給定佇列中沒有這樣的訊息,則會傳回空值。
JMS Script 作業
在建立 Script 應用程式時,Script 作業 jmsGetConnectionFactory 會傳回處理常式給 QueueConnectionFactory; 您可使用該控點,先建立多項 JMS 作業,然後再呼叫 jmsDisconnect 釋放控點。
jmsGetContext
- 原型:Context jmsGetContext(String url, String jndiFactory)
- 說明:建立一個 JMS 環境定義。
jmsGetConnectionFactory
- 原型:QueueConnectionFactory Context::jmsGetConnectionFactory(String jmsFactory)
- 說明:使用指定的環境定義來建立並傳回 JMS Connection Factory。
jmsGetMQConnectionFactory
- 原型:QueueConnectionFactory jmsGetMQConnectionFactory(String mqQueueManager, String mqHostname, String mqChannel, Integer mqPort)
- 說明:建立並傳回 JMS Connection Factory, 以便和 MQ 佇列通信。請注意,在取得 MQ Connection Factory 時不需要提供環境定義, 但如果要連接其他 JMS 佇列,則需要提供環境定義。
jmsGetQueueByName
- 原型:javax.jms.Queue jmsGetQueueByName(Context ctx, String name)
- 說明:從給定的 JNDI 名稱與環境定義,傳回 javax.jms.Queue 物件。
jmsGetQueueConnection
- 原型:QueueConnection QueueConnectionFactory::jmsGetQueueConnection()
- 說明:從給定的 Connection Factory 傳回 JMS 佇列連線。
jmsGetQueueSession
- 原型:QueueSession QueueConnection::jmsGetQueueSession()
- 說明:從給定的 Connection Factory 傳回 JMS 佇列連線。
jmsDisconnect
- 原型:void QueueSession::jmsDisconnect(QueueConnection qcon)
- 說明:切斷和給定佇列管理程式間的連線。
jmsCreateTextMsg
- 原型:Message QueueSession::jmsCreateTextMsg(String msgText)
- 說明:使用 QueueSession 資訊,以所提供的文字來建立新 JMS TextMessage。
jmsSendMsg
- 原型:Message QueueSession::jmsSendMsg(Message msg, String queueName[, HashMap properties, Message messageToReplyTo])
- 說明:透過 queueName 名稱的佇列傳送訊息 MSG,並傳回 MSG 或空值。若有提供 MESSAGETOREPLYTO, 則會從中讀取對佇列的回覆與訊息 ID。PROPERTIES 是一個從字串索引鍵至字串值的對映。會有三個特殊的索引鍵:"WPC_REPLY_TO_QUEUE"、 "WPC_COPY_CORRELATION_ID_BYTES" 與 "WPC_COPY_CORRELATION_ID"。若有提供 WPC_REPLY_TO_QUEUE, 則會置換所提供之 MESSAGETOREPLYTO 中的 QUEUENAME 或「回覆目的地」佇列。MESSAGETOREPLYTO 中的「回覆目的地」佇列會置換 QUEUENAME。"WPC_COPY_CORRELATION_ID" 與 "WPC_COPY_CORRELATION_ID_BYTES" 會將相互關係 ID 從 MESSAGETOREPLYTO 改複製成 MSG。這兩者皆可提供。其值必須是 Boolean 值(而不是上述的字串)
jmsReceiveMsgFromQueue
- 原型:JMSMessage QueueSession::jmsReceiveMsgFromQueue(javax.jms.Queue queue, Integer timeout[, String messageSelector, JMSMessage messageToReceiveReplyFor])
- 說明:接收 JMS 訊息。會在 TIMEOUT 毫秒後逾時。如果 INBOUNDQUEUE 非空值, 則會查看該佇列。如果 INBOUNDQUEUE 為空值,且 MESSAGETORECEIVEREPLYFOR 非空值, 則會查看 MESSAGETORECEIVEREPLYFOR 之「回覆目的地」欄位中所定義的佇列。如果 INBOUNDQUEUE 為空值, 且 MESSAGETORECEIVEREPLYFOR 為空值,則會擲出 AustinException。現在我們知道要使用哪個佇列。如果 MESSAGESELECTOR 與 MESSAGETORECEIVEREPLYFOR 皆為空值, 則會從該佇列中選取第一個訊息。否則,會從符合 MESSAGESELECTOR 與 MESSAGETORECEIVEREPLYFOR 所定義之所有條件的佇列(若有的話)選取第一個訊息。如果 MESSAGETORECEIVEREPLYFOR 非空值, 則會拒絕任何其相互關係 ID 不是 MESSAGETORECEIVEREPLYFOR 之訊息 ID 的訊息。如果 MESSAGESELECTOR 非空值, 則會拒絕任何未符合 messageSelector 中所定義之條件的訊息。如果找不到適當訊息,則會傳回空值。
jmsGetTextFromMsg
- 原型:String Message::jmsGetTextFromMsg()
- 說明:傳回內含整個 JMS 內容的字串,包括標頭。
jmsGetMessageID
- 原型:String Message::getJMSMessageID()
- 說明:傳回內含 JMS 訊息 ID 的字串。
jmsGetMessageCorrelationID
- 原型:String Message::getJMSMessageCorrelationID()
- 說明:傳回內含 JMS 訊息之相互關係 ID 的字串。
jmsGetMessageProperties
- 原型:HashMap Message::getJMSMessageProperties()
- 說明:傳回一個從字串內容名稱至這些優先順序之字串值的雜湊對映。
jmsSendMsgToQueue
- 原型:JMSMessage QueueSession::jmsSendMsgToQueue(JMSMessage msg, javax.jms.Queue outboundQueue [, HashMap properties, JMSMessage messageToReplyTo,])
- 說明:傳送訊息 MSG,並傳回 MSG 或空值。除非 OUTBOUNDQUEUE 為空值, 否則會將訊息傳至 OUTBOUNDQUEUE 指定的佇列中。如果 OUTBOUNDQUEUE 為空值, 則會將 MSG 傳至 MESSAGETOREPLYTO 的「回覆目的地」佇列(若有提供 MESSAGETOREPLYTO 的話)。如果 OUTBOUNDQUEUE 為空值, 且未提供 MESSAGETOREPLYTO,則會擲出 AustinException。若有提供 MESSAGETOREPLYTO, 則會從中讀取訊息 ID。PROPERTIES 是一個從字串索引鍵至字串值的對映。會有一個特殊(非 JMS)索引鍵: WPC_INCOMING_REPLY_QUEUE。WPC_INCOMING_REPLY_QUEUE 代表一個 javax.jms.Queue 物件, 而外部應用程式應將此訊息的回覆傳給此物件。
jmsSetMessageText
- 原型:void Message::setJMSMessageText(String msgText)
- 說明:設定為 JMS TextMessage 所提供文字。只支援 JMS TextMessage 類型。
Web 服務主控台
Web 服務主控台可讓使用者利用 SOAP_HTTP 來建立及管理 Web 服務。您可以撰寫 WSDL Script 來定義服務, 以及建立實作 Script 來控制服務的執行方式。
Web 服務主控台直欄
Web 服務主控台包含下列直欄。
名稱 Web 服務的名稱。按一下名稱來檢視 Web 服務的詳細資料。 說明 用來描述 Web 服務的簡要說明 通訊協定 SOAP_HTTP 是目前唯一可用的通訊協定 交易 服務的交易數目。 按一下數字來檢視交易,或按一下「刪除」按鈕來從主控台中移除 Web 服務 管理 Web 服務
存取 Web 服務主控台
若要存取 Web 服務主控台,請使用協同作業管理員 > Web 服務 > Web 服務主控台功能表路徑。
建立新的 Web 服務
請使用下列功能表路徑:協同作業管理員 > Web 服務 > 新建 Web 服務。這時會出現 "Web 服務詳細資料"。
請將適當資訊輸入下列欄位中:
Web 服務名稱 請輸入 Web 服務的名稱。這個名稱會成為 SOAP 服務的 URL 的一部分。它不能包含任何空白字元。例如: Web 服務說明 請輸入 Web 服務的說明。 通訊協定 Web 服務所用的通訊協定。目前只支援 SOAP over HTTP 通訊協定。預設值是 “SOAP_HTTP”。 URL 提供可用來存取服務的 URL。儲存 Web 服務之後,會自動移入這個欄位。
WSDL URL 可用來存取 Web 服務的 WSDL 之 URL。 儲存 Web 服務之後,會自動移入這個欄位。 WSDL 請輸入這個服務的 WSDL。 WSDL 文件是服務的介面、URL 和通訊協定的說明,採用 XML 格式。 您必須手動輸入這份文件,以下是一份範例 WSDL 文件。 您必須輸入 Web 服務的有效 XML,才能順利儲存。 實作 Script 請輸入實作這個服務的 Trigo Script。 服務的送入參數可以在 "soapParams" 陣列變數中取得。 服務的回覆值必須是字串,且可以寫入 "out" 寫出器變數中。 如果要傳回 SOAP 錯誤,請將錯誤碼寫入 "soapFaultCode" 寫出器變數中,將錯誤訊息寫入 "soapFaultMsg" 寫出器變數中。 以下是範例實作 Script。 要儲存要求嗎? 如果勾選這個項目,Trigo 會將所有送入要求的參數儲存在文件儲存庫中。 您可以從交易主控台中使用它們。 要儲存回覆嗎? 如果勾選這個項目,Trigo 會將所有回應內容儲存在文件儲存庫中。 您可以從交易主控台中使用它們。 已部署 如果勾選這個項目,就會部署服務。 否則,便無法使用這項服務。 範例實作 Script 和 WSDL 文件
範例實作 Script 和 WSDL 文件的下列設計會檢查送入 SOAP 要求的參數數目。 如果有正好四個參數,它會傳回列出這些參數的字串。 如果參數數目超出或不到四個,就會擲出 SOAP 錯誤。
實作 Script
nParams = soapParams.size();if (nParams != 4){
soapFaultCode.writeln("WRONG_NUM_PARAMS");
soapFaultMsg.writeln("Wrong number of parameters. This service requires 4. You have " + nParams + " parameters.");}
else{
out.writeln("Success.");
for (i = 0; i < nParams; i++)
{
out.writeln("Parameter " + (i + 1) + " is " + soapParams[i]);
}
}
WSDL
<?xml version="1.0" encoding="UTF-8"?><wsdl:definitions targetNamespace="http://my.trigo-instance.com/soap/services/CheckParams"xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:apachesoap="http://xml.apache.org/xml-soap"
xmlns:impl="http://my.trigo-instance.com/soap/services/CheckParams"
xmlns:intf="http://my.trigo-instance.com/soap/services/CheckParams"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<wsdl:message name="invokeRequest">
<wsdl:part name="param1" type="xsd:string"/>
<wsdl:part name="param2" type="xsd:string"/>
<wsdl:part name="param3" type="xsd:string"/>
<wsdl:part name="param4" type="xsd:string"/>
</wsdl:message>
<wsdl:message name="invokeResponse">
<wsdl:part name="invokeReturn" type="xsd:string"/>
</wsdl:message>
<wsdl:portType name="CheckParams">
<wsdl:operation name="invoke" parameterOrder="param1 param2 param3 param4">
<wsdl:input message="intf:invokeRequest" name="invokeRequest"/>
<wsdl:output message="intf:invokeResponse" name="invokeResponse"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="CheckParamsSoapBinding" type="intf:CheckParams">
<wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="invoke">
<wsdlsoap:operation soapAction=""/>
<wsdl:input name="invokeRequest">
<wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
namespace="http://DefaultNamespace"
use="encoded"/>
</wsdl:input>
<wsdl:output name="invokeResponse">
<wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
namespace="http://my.trigo-instance.com/soap/services/CheckParams"
use="encoded"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="CheckParamsService">
<wsdl:port binding="intf:CheckParamsSoapBinding"
name="CheckParams">
<wsdlsoap:address location="http://my.trigo-instance.com/soap/services/CheckParams"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>管理交易
存取交易主控台
若要搜尋所有 Web 服務交易,請使用協同作業管理員 > Web 服務 > 交易主控台功能表路徑來檢視交易主控台。
檢視 Web 服務交易
1. 在交易主控台中,從 Web 服務交易表格檢視交易清單。
2. 按一下回應或要求直欄中的「檢視」按鈕。交易詳細資料會在新的瀏覽器視窗中顯示。
搜尋 Web 服務交易
1. 在交易主控台中,從「Web 服務交易搜尋」表格的開始送達日期和結束送達日期欄位中,選取一個日期範圍。
2. 按一下搜尋按鈕。所有交易結果會在搜尋表格下方的「Web 服務交易」表格中顯示。
「文件儲存庫」是 WebSphere Product Center 中用來儲存每一個送入和送出檔案的區域。這包括匯入 Script、 報告與規格檔案。為方便審核,它會提供搜尋功能。
每一個行經 WebSphere Product Center 的檔案會複製與儲存到「文件儲存庫」中。因此, 「文件儲存庫」可當成備份引擎來利用。
「文件儲存庫」具有結構性,亦即,GUI 會提供儲存在 Oracle 資料庫中之檔案的超鏈結。實質上,它們是檔案位置的指標。
透過「文件儲存庫」,使用者可採用下列方式來管理檔案:
- 檢視檔案的內容與詳細資料
- 控制檔案的存取
- 檢視文件的審核日誌
- 刪除檔案
圖 10.1 文件儲存庫
存取文件儲存庫
您可以利用下列工具列路徑來存取文件儲存庫:協同作業管理員 > 文件儲存庫。
「文件儲存庫」是以檔案目錄結構方式呈現。請按一下任何資料夾/子資料夾, 以檢視目錄中的檔案。會顯示完整的文件路徑。
檢視文件詳細資料
「文件儲存庫」提供每一份文件的詳細資料。這包括審核日誌資訊,其中顯示文件的存取時間與存取者。
- 若要檢視文件的詳細資料,請按一下「檢視」圖示。
檢視文件內容
- 若要檢視文件內容,請從「文件詳細資料」表格中按一下「取得內容」超鏈結。文件的內容會出現在新視窗中。
控制文件存取
「文件儲存庫」容許控制文件的存取。您可以選取「存取控制群組 (ACG)」,或者建立新的 ACG。
1. 如果要控制哪個使用者群組可以存取文件,請按一下文件名稱旁的鎖和鑰匙按鈕。 這時會出現「文件儲存庫存取詳細資料」表格。
2. 如果已建立 ACG,請從下拉欄位中選取一個 ACG。否則,請按一下「新建」,建立新 ACG。您可以控制使用者群組來建立、檢視或刪除文件。
3. 選好 ACG 之後,請按一下儲存來保留文件的控制設定。
刪除文件
「文件儲存庫」可讓您透過文件儲存庫來刪除檔案,請按一下文件名稱旁的垃圾桶圖示,將它從文件儲存庫中刪除。
請注意!一旦刪除檔案後,即無法還原!會出現一個對話框,以確認刪除。按一下「取消」會取消刪除作業。
資料來源是一個 WebSphere Product Center 實體,用來定義資料匯入 WebSphere Product Center 的方式。 外部資料可出自不同的位置或資料庫, 並且可使用各種不同的方法來存取。例如,您可能希望匯入資料庫中的資料,匯入 FTP 伺服器中的檔案, 或者匯入您本端檔案系統中的資料。不論您選擇哪一種, 皆需要提供特定的配置參數,才能存取資料。「資料來源」含括了這些參數, 並可以單一實體名稱方式來操作它們, 如此一來只要設定來源的詳細資料,即可在整個產品中重複使用。
建立資料來源
如果要建立新的資料來源,請從資料來源主控台中,按一下「新建」按鈕。 (您也可以利用編輯工具按鈕來修改現有的資料來源)。 這時會出現「建立資料來源」精靈。完成精靈中的每一個步驟。
1. 資料來源 - 請輸入資料來源的名稱。
2. 選取資料來源類型 - 建立新資料來源的步驟包括指定資料來源的名稱。如果是匯入作業,名稱應儘可能是說明性的。例如, 「透過瀏覽器上傳」或「透過 FTP 擷取」。選好資料來源類型之後,請按一下選取。
可能的資料來源類型包括:
讓 WebSphere Product Center 透過 FTP 擷取
當使用者選取此選項時,是告訴 WebSphere Product Center 連接指定的 FTP 伺服器, 以擷取所要上傳的資料檔。WebSphere Product Center 會要求使用者指定下列的額外資訊, 如此才能連接 FTP 伺服器並擷取正確的檔案:伺服器位址與埠號、使用者名稱與密碼、檔名與其所在的目錄。取自文件儲存庫(包括 FTP)
文件儲存庫是 WebSphere Product Center 的一個區段,用來儲存已匯入 WebSphere Product Center 或 WebSphere Product Center 所產生準備匯出的每份單一文件。 如此一來, 便可以從該「文件儲存庫」將檔案提取到某一項輸送中。透過 Web 瀏覽器更新
此選項是使用「瀏覽」功能來探究與選取位於您硬碟(或網路上任何可存取的磁碟機)上的檔案, 以手動將檔案匯入至 WebSphere Product Center。3. 提供資料來源的詳細資料- 要提供的資料來源詳細資料會隨著第 2 步驟的選擇而不同。
如果選取的資料來源類型是... 需要其他資訊 讓 WebSphere Product Center 透過 FTP 擷取 輸入下列各項的值:
- 伺服器位址
- 伺服器埠
- 使用者名稱
- 密碼
- 檔案名稱
- 目錄
取自文件儲存庫(包括 FTP) 請輸入文件在 WebSphere Product Center 文件儲存庫中的完整路徑 透過 Web 瀏覽器更新 不需要其他詳細資料。 4. 完成「建立資料來源」精靈的每個步驟之後,請返回資料主控台。
編輯資料來源
- 從資料來源主控台中,尋找要刪除的資料來源,再按一下編輯按鈕。這時會出現「建立資料來源」。請依照需要來變更資料來源配置。
刪除資料來源
- 從資料來源主控台中,尋找要刪除的資料來源,再按一下刪除按鈕。這時會從資料來源主控台中移除資料來源。
分送主要是容許在應用程式本身之內外通知個人。分送和電子郵件別名類似。藉由在 WebSphere Product Center 中建置這些分送清單,便能夠和 WebSphere Product Center 外之人取得聯繫。
「遞送主控台」顯示先前所建而儲存在 WebSphere Product Center 中的所有分送。透過這個主控台, 使用者可修改或刪除任何現行的分送,並建立新分送或分送群組。分送群組純粹是一個由先前所建置之分送組合而成的群組名稱。
型錄一旦匯出後可送出到多個目的地, 以便進行核准與(或)驗證。匯出的分送元件可讓使用者選取型錄的傳送目的地。型錄可採用電子郵件(電子郵件主體) 或 FTP 形式來送出。實質上,分送也可以稱為「目的地模式」。
建立新分送
如果要建立新分送,請執行下列動作:
- 按一下協同作業管理員 > 遞送 > 遞送主控台,這時會出現「遞送主控台」介面。
- 按一下新分送按鈕。這時會出現「分送」精靈。完成精靈中的每一個步驟。
1. 分送名稱 - 請輸入分送的名稱,再按下一步。
2. 選取分送類型 - 請選擇一個分送類型,再按下一步。請選取下列選項之一:
- Ariba 型錄上載
- 自訂
- 電子郵件
- FTP
- 公佈
3. 分送模式 - 根據所選的分送類型,依照需要來輸入必要的資訊。 請按一下儲存來儲存分送設定。
建立遞送群組
- 按一下協同作業管理員 > 遞送 > 遞送主控台,這時會出現「遞送主控台」介面。
- 按一下新建分送群組按鈕。 這時會出現「分送群組」表格。 完成精靈中的每一個步驟。
2. 在「群組名稱」欄位中,輸入分送的名稱。
3. 從可用的分送清單中選取一個分送名稱,再按一下新增或移除來建立群組。
4. 按一下儲存來儲存分送群組設定。這時遞送主控台會出現新的分送群組。
刪除分送
- 如果要從遞送主控台中刪除某項分送或分送群組,請按一下分送或分送群組名稱旁的刪除按鈕。