如果要在網頁上使用動態資料,您需要定義資料來源。關聯式記錄是您可以使用的動態資料來源之一。利用關聯式記錄作為資料來源,使用者可以在網頁上建立、讀取、更新或刪除記錄。
如果要利用「資料」抽屜將關聯式記錄新增至網頁中,請執行下列動作:
- 在選用區中開啟「資料」抽屜。
- 將選用區中的關聯式記錄拖曳至 Faces JSP 頁面。 這時會開啟「新增關聯式記錄」精靈。
- 指定要在頁面內參照記錄的名稱。
- 如果您已在專案的其他地方定義關聯式記錄,
並且想要使用該記錄的資料,請勾選重複使用現有的記錄或記錄清單中的 Meta 資料定義,並按一下瀏覽來搜尋輸入檔案。
- 如果要將資料控制項自動新增至頁面,請勾選新增輸入/輸出控制項,以在網頁中顯示記錄。如果您沒有勾選這一項,關聯式記錄會新增至頁面程式碼檔和「頁面資料」視圖中,
但資料元件不會新增至 Faces JSP 檔中。如果稍後要新增控制項,只要將記錄拖曳至頁面即可。 (請注意,將關聯式記錄新增至頁面的另一替代方式是使用「頁面資料」視圖而非「資料」抽屜。
首先,您要透過「頁面資料」視圖建立關聯式記錄,然後將記錄拖曳至網頁。)
- 在「建立控制項」區段中,當您將記錄拖曳至頁面時,請選取下列一個控制項:
- 顯示現有的預記錄(唯讀):
預設元件通常是「輸出文字」元件,不過要視內容的執行時期類型而定。資料記錄已起始設定為包含現有的記錄中的資料。
- 更新現有的記錄:預設元件是輸入欄位元件。
資料記錄已起始設定為包含現有的記錄中的資料。
- 建立新記錄:預設元件是輸入欄位元件。
資料記錄已起始設定為空白記錄。
記錄顯示為資料庫中的新列。
- 按下一步。 這時會開啟「記錄內容」畫面。
- 指定連線名稱,或按一下新建來建立新的連線。
- 如果您按一下新建,就會開啟「新連線」畫面。
- 按一下建立新 DB 連線。這時會開啟「新建資料庫連線」精靈。如果需要使用這個精靈建立新資料庫連線的相關資訊,請參閱說明主題「利用精靈連接資料庫」。
- 從資料來源中選取您要使用的表格。
- 按下一步。 這時會開啟「直欄選項和其他作業」畫面。
- 在「直欄選項和其他作業」畫面上:
- 選取要併入關聯式記錄的直欄(欄位)。
- 如果要進一步修正記錄,您可以按一下下列其中一個作業或進階作業:
- 修改主鍵:會開啟「編輯主鍵」對話框,並列出可用的直欄和主鍵直欄。
請使用箭頭來變更主鍵直欄。
- 次序結果:會開啟「次序」對話框並列出可用的直欄。
選取要排列次序的直欄並選擇如何組織它們(升冪或降冪)。
- 過濾結果:這時會開啟「過濾」對話框。按一下「新增 (+)」按鈕以開啟「條件」對話框。
您可以在這裡過濾記錄,只讓符合特定條件的那些記錄顯示出來。
- 透過關係新增另一個資料庫表格:這時會開啟「建立關係」精靈,您可以從現行資料庫建立現有的關係,
或建立新關係。
- 自動產生金鑰:這時會開啟「產生金鑰」對話框。勾選使用自動產生金鑰,
然後選擇表格和您要用於自動產生金鑰的兩個直欄。
- 設定並行控制項:這時會開啟「並行」對話框。選擇衝突直欄 [這裡需要更多說明]
- 按下一步。
這時會開啟「配置資料控制項」畫面
- 在「配置資料控制項」畫面上:
- 選取您要顯示的欄位、變更顯示在欄位旁的標籤,
以及選取要使用的控制項類型。根據您選擇要顯示、更新或建立記錄而定,控制項類型可包括「輸出欄位」、「輸出格式化文字」、「組合框」、「輸入欄位」、「輸入文字區域」和其他等等。
使用上移鍵和下移鍵來變更欄位的次序。
- 如果您想要建立其他選項,請按一下選項。
這時會開啟「選項」對話框。
- 在「選項」對話框的「標籤」標籤上,您可以對齊標籤,使每一個標籤置中對齊,或靠左或靠右對齊。
您也可以選擇在每一個標籤之後附加一個冒號,並將每一個標籤的第一個字母大寫。
- 在「進階」標籤上,您可以在深度旁邊輸入深度層次。
深度層次設定在「頁面資料」視圖中顯示的資料層次數目。
如果您選擇深度 3,則「頁面資料」視圖會顯示含有三個資料層次的關聯式記錄清單(或其他資料來源)。
勾選使用預設深度,以變更使用者的預設深度層次。勾選只建立資料控制項,只在頁面上建立資料控制項。
如果未勾選這個選項,則會建立資料控制項和其他相關的控制項。
比方說,如果您要建立「輸入文字」元件,且您勾選只建立資料控制項,
則只會在頁面上建立該元件。
不過,如果您沒有勾選這個選項,則會建立「輸入文字」元件和「顯示錯誤」元件、「標籤」元件,
也許還有送出按鈕。勾選在程式碼中併入 <label>
標示來建立 <label> 標示,以增加標籤協助工具。
- 如果您選擇要更新記錄,「按鈕」標籤也會顯示在「選項」對話框上。
在「按鈕」標籤上,您可以選擇要包括送出按鈕
(來送出任何更新項目)和刪除按鈕(來刪除記錄)。
- 如果您選擇要建立記錄,「按鈕」標籤會顯示在「選項」對話框上。
在「按鈕」標籤上,您可以選擇要包括送出按鈕(來送出新建的記錄)。
- 按一下完成。 這時會根據您選取的項目,開啟包含列和其他元件的 HTML 表格。
比方說,如果您選擇要更新現有的記錄,就會顯示一個輸入文字元件,
它可能包括用來執行更新記錄和刪除記錄動作的送出和刪除按鈕。
請注意,新 UI 元件的
值資訊已填入其「內容」視圖中。
當您建立資料記錄時,會設定預設過濾條件來決定要顯示的記錄。
過濾條件會尋找主鍵直欄符合參數值的記錄(該參數名稱符合主鍵直欄名稱)。
這樣就可以很容易地設定更新或詳細資料頁面。當您鏈結到這個頁面時,應該使用這個參數來傳遞主鍵直欄的值給它。
否則,網頁只會顯示它讀取到的第一筆記錄的值。
您可以配置資料記錄來變更過濾條件。