如果要在網頁上使用動態資料,您需要定義資料來源。關聯式記錄清單是您可以使用的動態資料來源之一。利用關聯式記錄清單,您可以顯示關聯式資料庫表格中的多筆記錄。
當您在頁面上定義關聯式記錄清單之後,其資料即可在網頁上使用。以下是將關聯式記錄清單新增至 Faces JSP 頁面的一些方式:
- 從「頁面資料」視圖中,建立關聯式記錄清單。
如果要在頁面上顯示資料清單,請從「頁面資料」視圖中將它拖曳到頁面上。
- 從選用區的「資料」抽屜中將關聯式記錄清單元件拖曳至頁面上。
下列步驟將說明這種方式。
如果要利用「資料」抽屜將關聯式記錄清單新增至網頁中,請執行下列動作:
- 在選用區中開啟「資料」抽屜。
- 將選用區中的關聯式記錄清單元件拖曳至您要顯示資料的 Faces JSP 頁面。這時會開啟「新增關聯式記錄清單」精靈。
註: 如果這時開啟「目標伺服器」對話框,
請從清單中選取「WebSphere® Application Server 5.1 版」或「WebSphere Application
Server 6.0 版」,並按一下確定。
- 提供記錄清單一個名稱來使用於頁面中。
- 如果您已在專案的其他地方定義關聯式記錄清單,
並且想要使用該清單的資料,請勾選重複使用現有的記錄或記錄清單中的 Meta 資料定義,並按一下瀏覽來選取輸入檔案。
- 如果要自動建立含有資料欄位的資料表,請勾選新增資料控制項。否則,記錄清單會新增至「頁面資料」視圖並可供頁面使用,但不會產生這份清單的控制項。
稍後,您可以將記錄清單從「頁面資料」視圖拖曳至頁面中,來使用資料表顯示它。
- 按下一步。
- 在「記錄清單內容」畫面上,指定連線名稱(或按一下新建來建立新連線)。
- 如果您按一下新建,就會開啟「新連線」畫面。
- 按一下建立新 DB 連線。這時會開啟「新建資料庫連線」精靈。如果需要使用這個精靈建立新資料庫連線的相關資訊,請參閱說明主題「利用精靈連接資料庫」。
- 建立了連線之後,請選取表格並按下一步。
- 在「直欄選項和其他作業」畫面上:
- 選取要併入關聯式記錄清單的欄位。
- 如果要進一步修正記錄清單,您可以按一下下列其中一項作業或進階作業:
- 修改主鍵:會開啟「編輯主鍵」對話框,並列出可用的直欄和主鍵直欄。
請使用箭頭來變更主鍵直欄。
請注意,這樣只會定義這個記錄清單定義的主鍵,而不會變更實際資料庫上的主鍵。
- 次序結果:會開啟「次序」對話框並列出可用的直欄。
選取要排列次序的直欄並選擇如何組織它們(升冪或降冪)。
- 過濾結果:這時會開啟「過濾」對話框。按一下「新增 (+)」按鈕以開啟「條件」對話框。
您可以在這裡過濾記錄,只讓符合特定條件的那些記錄顯示出來。
- 透過關係新增另一個資料庫表格:這時會開啟「建立關係」精靈,您可以從現行資料庫建立現有的關係,
或建立新關係。
- 自動產生金鑰:這時會開啟「產生金鑰」對話框。勾選使用自動產生金鑰,
然後選擇表格和您要用於自動產生金鑰的兩個直欄。
- 設定並行控制項:這時會開啟「並行」對話框。並行控制項可讓您將其他交易無法使用資料資源的期間最小化。
比方說,您有一個長時間執行的交易,它可能長期牽制住資料資源,因此您想要使時間最小化。
您也可以提供直欄層次並行控制項。這可讓您測試是否因為下拉原始資料而使另一筆交易更新了基礎資料來源。
標示為要更新的直欄及其原始值會透過 UPDATE 陳述式中的 WHERE 子句明確地新增,
因此,如果基礎直欄值變更,則該陳述式會失敗。
所以,提供了直欄層次並行控制項。如果自從一開始擷取資料之後未曾更新過基礎直欄,
則會確定擱置的更新項目並釋放鎖定。
如果無法取得鎖定,或自從現行交易開始之後有部分其他交易已更新直欄,
則會回復交易。
- 按下一步。
- 在「配置資料控制項」畫面上:
- 如果您先前已勾選新增資料控制項,
請選取下列其中一種資料控制項來建立:
- 多直欄資料表(每一個資料項目一個表格列)
- 單一直欄資料表(每一個項目多個表格列)
- 單一直欄資料表中的未格式化控制項
- 選取您要顯示的直欄,輸入直欄的標籤,並選擇每一個直欄的控制項類型。
控制項類型可包括「輸出欄位」、「輸出格式化文字」、「組合框」、「輸入欄位」、「輸入文字區域」和其他。
使用上移鍵和下移鍵來變更直欄的次序。
- 按一下選項,可設定其他選項。
這時會開啟「選項」對話框,它含有下列標籤:
- 標籤 - 在記錄或資料表中包含協助工具標籤的選項。
您可以對齊標籤,使每一個標籤置中對齊,或靠左或靠右對齊。
您也可以選擇在每一個標籤之後附加一個冒號,並將每一個標籤的第一個字母大寫。
- 進階 - 在深度旁邊輸入深度層次。
深度層次設定在「頁面資料」視圖中顯示的資料層次數目。
如果您選擇深度 3,則「頁面資料」視圖會顯示含有三個資料層次的關聯式記錄清單(或其他資料來源)。
比方說,如果第一層包括歐洲,第二層包括義大利,第三層包括米蘭,則不會顯示其他的層次(例如米蘭中的位置)。
此外,在米蘭下的層次不會出現在精靈中,也不會產生任何控制項。
勾選使用預設深度,以變更使用者的預設深度層次。勾選只建立資料控制項,只在頁面上建立資料控制項。
如果未勾選這個選項,則會建立資料控制項和其他相關的控制項。
比方說,如果您要建立「輸入文字」元件,且您勾選只建立資料控制項,
則只會在頁面上建立該元件。
不過,如果您沒有勾選這個選項,則會建立「輸入文字」元件和「顯示錯誤」元件、「標籤」元件,
也許還有送出按鈕。勾選在程式碼中併入 <label>
標示來建立 <label> 標示,以增加標籤協助工具。
- 按鈕 - 如果您要更新記錄,則會顯示這個標籤。
您可以選擇要新增送出和刪除按鈕來幫助使用者更新記錄。
- 按一下完成。 資料來源就會定義給這個頁面,並顯示在「頁面資料」視圖中。如果您已勾選新增資料控制項,則會產生控制項。
否則,您必須從「頁面資料」視圖中拖曳它們。
頁面上有了資料表之後,您就可以設定資料表以及資料表所包含的任何其他元件的內容。請注意,
資料表的值資訊已填寫進來。