區域動作

本產品所提供的大多數區域類型都允許將一或多個「區域動作」定義成顯示在區域標頭中。動作可以顯示為超連結、圖示或按鈕。您也可以提供動作作為 HTML 字串。

備註:區域類型也包含使用 IMPLEMENTOR_​ACTION_​n (動作 n) 參數在區域類型層級定義之動作的參數。產品區域類型很少使用這些參數。此處定義的動作會置換在區域類型定義的任何動作 (如果有的話)。以下明細也適用於區域類型層級動作。

定義區域動作時,是使用下列記憶碼來定義:

記憶碼

描述

有效值

註釋

type=

此記憶碼定義區域標頭中動作的外觀。

LINK

指出動作會顯示為文字超連結。

ICON

指出動作會顯示為圖形圖示。

BUTTON

指出動作會顯示為 HTML 按鈕。

ASIS

指出參數將提供要用於動作的 HTML。

action=

此記憶碼定義按一下連結/圖示/按鈕時要進行的動作。當 type=ASIS 時,會忽略此記憶碼。

NAVIGATION

指出動作為導覽至頁面。

SCRIPT

指出動作為執行業務處理助理指令檔。

navopt=

定義當 action=NAVIGATION 時要使用的導覽選項。

'NAV_​OPT_​CD'

輸入以單引號括住的有效導覽選項參考。

bpa=

定義當 action=SCRIPT 時要執行的指令檔。

'SCRIPT_​CD'

輸入以單引號括住的有效業務處理助理指令檔參考。

icon=

指出當 type=ICON 時要使用的圖示。

DISP_​ICON_​CD

輸入有效顯示圖示的參考。

'path'

輸入圖示的明確路徑,例如 'images/gotoZone.gif'。

asis=

type=ASIS 時,必須指定此記憶碼。這讓您能夠精確定義想要包含在標頭中的 HTML。允許所有有效的 HTML,包括使用 "ora" CSS 類別和 JavaScript 函數。

['HTML']

label=

標籤或工具提示預設會來自導覽選項或業務處理助理指令檔描述。請使用此記憶碼來置換該標籤。

FIELD_​NAME

輸入其標籤應被使用的有效欄位名稱。需要多種語言時,應該一律使用此選項。

'text'

請直接在兩個單引號之間輸入文字。

context=[target1=source1 target2=source2]

這是用來在導覽至頁面或執行業務處理助理指令檔時傳遞內容資料。記憶碼支援傳送多個值的功能。

在每一種情況下,都會先定義目標內容欄位或業務處理助理指令檔變數,後面接著等號,再接著以下一個資料欄中定義的其中一個有效值定義的來源資料。

您可以定義一或多個值,並用空格來區隔您定義的每個內容值,然後用方括弧來框住整組內容值。

FIELD_​NAME

指出應該從入口內容、全域內容或頁面資料模型中具有此名稱的欄位取得值。記憶碼 sourceLoc 是用來定義來源。

xpath

指出應該從此區域中所顯示、由 Xpath 代表的結構欄位取得值。這在區域顯示 UI 對應時有效。

'常數'

指出系統必須傳送定義於兩個單引號之間的值。

sourceLoc=

此記憶碼定義 context 記憶碼中 FIELD_​NAME 值的來源。

如果將此記憶碼保留空白,則預設行為如下:

- 系統會檢查入口內容。

- 如果找不到任何入口內容值,便會檢查全域內容。

- 如果兩個值都無法使用,則會忽略此欄位。

G

指出欄位的值擷取自全域內容。

P

指出欄位的值擷取自入口內容。

D

指出欄位的值擷取自頁面資料模型。

class=

使用此記憶碼以不同的 CCS 樣式置換連結/圖示/按鈕的外觀與風格。

'className1' 'className2'

輸入以單引號括住的一或多個類別。您可以提供多個類別名稱。

style=

請使用此記憶碼,利用指定的 CSS 樣式來置換動作元素的外觀與風格。

Standard style= format.

您可以使用所有可用的 CSS 樣式定義。

範例:

  • type=BUTTON action=SCRIPT bpa='F1-SET-USER' context=[USER_​ID=USER_​ID] label=UPDATE_​LBL

  • type=LINK action=NAVIGATION navopt='gotoUser' context=[USER_​ID=path(schema/userdId)]

  • type=ASIS asis=['<A class="oraLink" href="www.google.com">Search</a>']

備註:如果區域類型已有定義的動作,而您想要單純地移除區域類型動作,則可以使用下列組態來設定區域動作:type=ASIS asis=[]