資料欄參數
資料總管區域可用來透過一或多個 SQL 陳述式選取要顯示的資料。針對每個 SQL 陳述式,此區域最多可設定 20 資料欄,這些資料欄包含用於顯示輸出資料的格式定義。
這些參數適用於區域類型
-
資訊資料總管 - 單一 SQL (F1-DE-SINGLE)。參數會遵循第 x 資料欄的描述模式。
-
資訊資料總管 - 多重 SQL (F1-DE)。針對此區域類型,會執行所有 SQL 且區域會顯示所有結果的聯集。參數會遵循 SQL y 的第 x 資料欄描述模式。有一些記憶碼在同一資料欄的資料列內不同時會沒有意義。例如,資料欄標籤。針對這些記憶碼,只會為該資料欄考量 SQL 1 中的值。下表指出哪些記憶碼遵循此規則。
-
查詢資料總管 - 多重 SQL (F1-DE-QUERY)。針對此區域類型,只會執行一個 SQL。SQL y 條件參數可用來控制此行為。系統將會執行第一個符合條件 (或未被植入條件的) 的 SQL。參數會遵循 SQL y 的第 x 資料欄描述模式。
下列各節描述各種類型的記憶碼。
來源記憶碼
此表描述控制資料欄中資料導出方式的記憶碼。
記憶碼 |
描述 |
有效值 |
註釋 |
---|---|---|---|
source= |
定義資料欄值的導出方式。 |
SQLCOL |
指出資料欄值的來源為 SQL 陳述式中的資料欄。此類型的資料欄必須也參考 sqlcol= 記憶碼。 |
BO |
指出資料欄值的來源為業務物件。此類型的資料欄必須也參考 bo=、input= 及 output= 記憶碼,以定義與業務物件互動的方式。 |
||
BS |
指出資料欄值的來源為業務服務。此類型的資料欄必須也參考 bs=、input= 及 output= 記憶碼,以定義與業務服務互動的方式。 |
||
SS |
指出資料欄值的來源為服務指令檔。此類型的資料欄必須也參考 ss=、input= 及 output= 記憶碼,以定義與服務指令檔互動的方式。 |
||
FORMULA |
指出此資料欄值的來源是公式計算。此類型的資料欄必須也參考 formula= 記憶碼。 |
||
SETFUNC |
指出此資料欄值的來源是 SQL 陳述式中資料列值的超集計算。此類型的資料欄必須也參考 setfunc= 記憶碼。 |
||
ICON |
指出此資料欄值的來源為顯示圖示參考 (亦即圖示將顯示在資料欄中)。此類型的資料欄必須也參考 icon= 記憶碼以定義圖示參考。 |
||
FKREF |
指出此資料欄值的來源為外來索引鍵參考 (表示外來索引鍵參考的內容功能表和資訊字串將顯示在資料欄中,並針對導覽啟用)。此類型的資料欄必須也參考 fkref= 和 input= 記憶碼,以定義呼叫外來索引鍵參考的方式。 備註:若要顯示外來索引鍵的資訊,但不啟用導覽,請參考常見使用案例以取得建議的技術。
|
||
SPECIFIED |
指出此資料欄值的來源是藉由將文字與其他資料欄值串連來指定。此類型的資料欄必須也參考 spec= 記憶碼。 |
||
MSG |
指出此資料欄的來源是來自訊息資料表的訊息 (以及任何替代變數)。此類型的資料欄必須也參考 msg= 記憶碼。 |
||
sqlcol= |
當 source=SQLCOL 時,定義 SQL 陳述式中的資料欄。 |
COLUMN_NAME |
輸入 SELECT 陳述式中所擷取資料欄的名稱。請注意,如果 Select 陳述式針對資料欄使用別名,就應該在此處參考該別名。 |
x |
x 是一個依資料欄在 SELECT 陳述式中相對位置參考資料欄的整數值。例如,sqlcol=3 會顯示 SELECT 陳述式中的第三個資料欄。 |
||
bo= |
當 source=BO 時,定義要叫用的業務物件。 此記憶碼必須與 input= 和 output= 記憶碼搭配使用,以定義向業務物件傳送/接收資訊的方式。 |
'業務物件代碼' |
|
bs= |
當 source=BS 時,定義要叫用的業務服務。 此記憶碼必須與 input= 和 output= 記憶碼搭配使用,以定義向業務服務傳送/接收資訊的方式。 |
'業務服務代碼' |
|
ss= |
當 source=SS 時,定義要叫用的服務指令檔。 此記憶碼必須與 input= 和 output= 記憶碼搭配使用,以定義向服務指令檔傳送/接收資訊的方式。 |
'服務指令檔代碼' |
|
fkref= |
當 source=FKREF 時,定義用來擷取資料欄資訊的外來索引鍵參考。 此記憶碼必須與 input= 記憶碼搭配使用,以定義如何將資訊傳送至外來索引鍵參考來建立資訊。 |
Cx |
這意謂著外來索引鍵參考是在稍早的資料欄中定義。例如,如果資料欄 1 定義外來索引鍵參考值,請定義 C1。 |
COLUMN_NAME |
這意謂著外來索引鍵參考已由 SELECT 陳述式擷取。值應該與 SELECT 子句中定義的名稱相符。 |
||
'外來索引鍵參考代碼' |
這意謂著是以直接方式定義外來索引鍵參考。例如 'F1-ROLE'。 |
||
formula= |
當 source=FORMULA 時,定義要使用的公式。 範例:
|
公式可以包含數值常數、運算子及資料欄參考。 |
針對資料欄參考,請使用 Cx 格式,其中 x 代表資料欄編號。 |
如需有關所支援函數的資訊,請參考表示式剖析器。 |
|||
setfunc= |
當 source=SETFUNC 時,定義要對所指定資料欄的資料列套用的函數。 |
function(Cx) |
Cx 代表其資料列應套用函數且函數為下列其中之一的資料欄:
|
input= |
這可用來定義一或多個傳遞給業務物件、業務服務、服務指令檔及外來索引鍵參考的輸入欄位和值。 語法如下:[ELEMENT_NAME=ELEMENT_REF ELEMENT_NAME=ELEMENT_REF ...] 換句話說,輸入值列表是以中括號括住並以空格分隔。每個傳遞的值會先定義 ELEMENT_NAME,即目標中元素/欄位的名稱。ELEMENT_REF 是傳入的值。下一資料欄則指出 ELEMENT_REF 的可能值。 |
Cx | Cx 代表先前資料欄的值。如果要傳遞的值在第一資料欄中,請參考 C1。 |
COLUMN_NAME | 這意謂著要傳入的值已由 SELECT 陳述式擷取。值應該與 SELECT 子句中定義的名稱相符。 | ||
'文字值' | 這意謂著應傳入單引號所括住的文字值。 | ||
userTimeZone | 這意謂著應傳入目前使用者的時區。這通常與業務服務 F1-ShiftDateTime 搭配使用,以將採用儲存時區的資料轉換成使用者的時區來顯示。 | ||
installationTimeZone | 這意謂著應傳入安裝時區。這通常與業務服務 F1-ShiftDateTime 搭配使用,以將採用儲存時區的資料轉換成安裝時區來顯示。 | ||
範例:
|
|||
output= |
這是用來定義從用來植入此資料欄之業務物件、業務服務或服務指令檔中擷取的元素名稱。 |
elementName |
範例:output=personInfo |
pagingkey= |
只有在設定啟用分頁參數之後,才適用此記憶碼。它指出此資料欄是 SQL 陳述式用來協調所有結果之分頁的其中一個索引鍵。只有當 source=SQLCOL 時,才可以指定此記憶碼。 快速路徑:如需詳細資訊,請參考分頁組態。
|
Y |
|
N |
這是預設值,也就是說,您完全不需要指示 pagingkey=N 來表示該資料欄不是其中一個分頁索引鍵。 |
格式記憶碼
此表描述控制資料欄格式化方式的記憶碼。
記憶碼 |
描述 |
有效值 |
註釋 |
---|---|---|---|
type= |
定義資料欄值的格式化方式。 備註:圖示與外來索引鍵資料欄。source= 來源記憶碼可用來指出應從圖示參考或外來索引鍵 (FK) 參考導出資料欄。如果您使用這些來源中的任何一個,type= 記憶碼便不相關,因為圖示或內容功能表/資訊字串將顯示在資料欄中。
|
STRING |
此類型的資料欄會擷取字串。這是預設值。 |
DATE |
此類型的資料欄會擷取日期,且顯示這些資料欄時,會使用使用者的顯示設定檔來顯示。 |
||
TIME |
此類型的資料欄會擷取時間 (採用資料庫格式),且顯示這些資料欄時,會使用使用者的顯示設定檔來顯示。 |
||
DATE/TIME |
此類型的資料欄會擷取日期和時間 (採用資料庫格式),且顯示這些資料欄時,會使用使用者的顯示設定檔來顯示。 |
||
MONEY |
此類型的資料欄會擷取貨幣欄位。此類型的資料欄也可以參考 cur= 記憶碼。如果未指定 cur 記憶碼,則會使用安裝記錄上的幣別代碼。 |
||
NUMBER |
此類型的資料欄會擷取數值欄位。此類型的資料欄也可以參考 dec= 記憶碼。 |
||
label= |
定義資料欄的置換標籤。標籤會顯示在資料欄的標題和區域的拖放區中。 如果未定義此記憶碼,系統就會使用資料欄的預設標籤。資料欄預設標籤的來源會依據資料欄的來源而有所不同。請注意,有些來源沒有預設值,省略此記憶碼將導致標籤空白。 備註:
就「資訊資料總管 - 多重 SQL」區域類型 (F1–DE) 而言,系統會使用 SQL 1 中的資料欄定義來定義標籤。 |
FIELD_NAME |
輸入其標籤應用來作為資料欄標籤的有效欄位名稱。需要多種語言時,應該一律使用此選項。 |
'text' |
直接定義文字。 |
||
cur= |
當 type=MONEY,且不應使用安裝記錄的幣別時,定義所套用的幣別代碼。 |
Cx |
這意謂著幣別代碼是在稍早的資料欄中定義。例如,如果資料欄 1 定義幣別代碼,請定義 C1。 |
COLUMN_NAME |
這意謂著幣別代碼已由 SELECT 陳述式擷取。值應該與 SELECT 子句中定義的名稱相符。 |
||
'幣別代碼' |
這意謂著是以直接方式定義幣別代碼。例如 'USD'。 |
||
dec= |
當 type=NUMBER 時,定義小數位數。 此為選擇性。如果提供,就應該是整數。如果未提供,小數位數將預設為安裝記錄上所指定幣別代碼上定義的小數位數。 |
nR |
n 是要顯示的小數位數。在小數位數後面加上 R 表示系統應將小數位數進位/捨去。只指定 n (沒有 R) 表示應將小數位數截斷。例如,輸入 dec=4 會顯示 4 位小數位數並將剩餘位數截斷。 備註:僅限格式設定。此記憶碼僅用於格式設定,不會影響用於後續計算的精確度。例如,如果從資料庫擷取的資料欄包含 6 位有效數字而 dec=0,則顯示資料欄時將無小數位數 (截斷),不過,後續計算中對該資料欄的任何參考都將使用 6 位小數位數。例如,如果某個公式或 Set 函數中參考該資料欄,便會使用所有 6 個小數位數。
|
char= |
此記憶碼會將特殊字元套用至資料欄值。 |
'x[]x' |
x 會參考要顯示的文字值,而 [ ] 則定義字元的相對位置 (在值之前或之後)。 如果您想要將字元置於值之前,只需包含 [ ] 即可。例如,char='%' 會將百分比符號放在值後面。如果您想要將 'minutes' 一字放在值之前,請輸入 char='minutes [ ]'。如果您想要輸出類似 BUDGET $123.12 (YTD) 的值,請輸入 char='BUDGET [ ] (YTD)'。 |
suppress= |
這是用來指出不應該顯示某個資料欄。 如果資料欄僅定義來供後續資料欄使用 (例如,如果有公式使用兩個其他資料欄來導出資料欄公式),系統就會隱藏該資料欄。在此情況下,可以隱藏公式中參考的資料欄。 備註:
就「資訊資料總管 - 多重 SQL」區域類型 (F1–DE) 而言,系統會將 SQL 1 中資料欄定義的設定套用至所有後續 SQL。 |
true |
|
false |
這是預設值,也就是說,您完全不需要指示 suppress=false 來表示應該顯示該欄位。 |
||
suppressSearch= |
這是用來指出以僅搜尋模式叫用區域時,不應該顯示某個資料欄。 備註:
就「資訊資料總管 - 多重 SQL」區域類型 (F1–DE) 而言,系統會將 SQL 1 中資料欄定義的設定套用至所有後續 SQL。 |
true |
|
false |
這是預設值,也就是說,您完全不需要指示 suppressSearch=false 來表示應該顯示該欄位。 |
||
suppressExport= |
這是用來指出匯出時不應下載資料欄。 備註:
就「資訊資料總管 - 多重 SQL」區域類型 (F1–DE) 而言,系統會將 SQL 1 中資料欄定義的設定套用至所有後續 SQL。 |
true |
|
false |
這是預設值,也就是說,您完全不需要指示 suppressExport=false 來表示下載時應該包含該欄位。 |
||
width= |
這是用來置換資料欄寬度 (像素數)。預設值為資料欄中任何儲存格的最大寬度。 |
n |
n 是介於 0 到 999 之間的數字。 備註:
如果資料中沒有可用的中斷點,資料欄就會比指定的像素數長。 資料欄標籤 (顯示在資料欄標題中) 的長度也可能使寬度比所指定的寬度寬。 就「資訊資料總管 - 多重 SQL」區域類型 (F1–DE) 而言,系統會根據 SQL 1 中的資料欄定義來設定寬度。 |
color= |
這是用來置換資料欄的文字顏色。 |
有效的 HTML「具名」顏色 |
例如 color=yellow。 備註:如需瞭解 HTML 顏色 'red' 的使用及其對輔助功能的影響,請參考顏色對比。
|
有效的 RGB 顏色模型組合 |
例如 color=#E0292F 或 color=#CCCCCC。請注意,必須使用 #。 |
||
bgcolor= |
這是用來置換資料欄的背景顏色。 |
有效的 HTML「具名」顏色 |
類似於 color= 記憶碼。 |
有效的 RGB 顏色模型組合 |
類似於 color= 記憶碼。 |
||
order= |
定義資料欄的預設排序順序。 |
ASC |
指出順序為遞增。這是預設值,也就是說,不需要指示 order=ASC。 |
DESC |
指出順序為遞減。 |
||
rowHeader= |
指定資料欄作為資料列標頭以用於輔助功能。 |
true |
預設會針對輔助功能工具,將資料總管結果的第一個資料欄識別為資料列標頭。如果第一資料欄中的資料不會唯一識別資料列,請使用此記憶碼來明確將不同資料欄或多個資料欄標示為資料列標頭。 備註:就「資訊資料總管 - 多重 SQL」區域類型 (F1–DE) 而言,系統只會查看 SQL 1 中已定義此記憶碼的資料欄,並將其套用至這些資料欄的所有結果。
|
點選記憶碼
此表描述定義資料欄值是否可供點選的記憶碼,以及如果可點選,點選後應發生什麼情況。
記憶碼 |
描述 |
有效值 |
註釋 |
---|---|---|---|
navopt= |
定義當使用者按一下資料欄時,參考目標交易或指令檔的導覽選項。 請注意,此記憶碼應與 context= 記憶碼搭配使用,以定義要將哪些資訊傳送至導覽選項的目標交易。 如果 source=FKREF,就會忽略此記憶碼,因為外來索引鍵參考代碼會定義超連結目標。 |
Cx |
這意謂著導覽選項代碼是在稍早的資料欄中定義。例如,如果資料欄 1 定義導覽選項,請定義 C1。 |
COLUMN_NAME |
這意謂著導覽選項已由 SELECT 陳述式擷取。值應該與 SELECT 子句中定義的名稱相符。 範例:navopt=MAIN_PORTAL |
||
'導覽選項代碼' |
這意謂著是以直接方式定義導覽選項。例如 navopt='userMaint'。 |
||
context= |
這可用來定義一或多個傳遞給要與 navopt= 記憶碼搭配使用之目標導覽選項的內容欄位和值。 語法如下:[FIELD_NAME=FIELD_REF FIELD_NAME=FIELD_REF ...] 換句話說,輸入值列表是以中括號括住並以空格分隔。每個傳遞的值會先定義 FIELD_NAME,即導覽選項中內容欄位的名稱。FIELD_REF 是傳入的值。下一資料欄則指出 FIELD_REF 的可能值。 |
Cx |
Cx 代表先前資料欄的值。例如,如果要傳遞的值在第一資料欄中,請參考 C1。 |
COLUMN_NAME |
這意謂著要傳入的值已由 SELECT 陳述式擷取。值應該與 SELECT 子句中定義的名稱相符。 |
||
'文字值' |
這意謂著應傳入單引號所括住的文字值。 |
||
bpa= |
指出業務處理助理指令檔應在使用者按一下資料欄時執行,並指出要執行的業務處理助理指令檔。 請注意,此記憶碼應與 tempstorage= 記憶碼搭配使用,以定義執行指令檔時將起始的暫存值。 如果 source=FKREF,就會忽略此記憶碼,因為外來索引鍵參考代碼會定義超連結目標。 |
Cx |
指出業務處理助理指令檔是在先前的資料欄中定義。 |
COLUMN_NAME |
這意謂著業務處理助理指令檔已由 SELECT 陳述式擷取。值應該與 SELECT 子句中定義的名稱相符。 |
||
'業務處理助理指令檔代碼' |
這意謂著是以直接方式定義業務處理助理指令檔。 |
||
tempstorage= |
這可用來定義使用 bpa= 記憶碼時,起始暫存變數的方式。 語法如下:[FIELD_NAME=FIELD_REF FIELD_NAME=FIELD_REF ...] 換句話說,輸入值列表是以中括號括住並以空格分隔。每個傳遞的值會先定義 FIELD_NAME,即暫存中欄位的名稱。FIELD_REF 是傳入的值。下一資料欄則指出 FIELD_REF 的可能值。 |
Cx |
Cx 代表先前資料欄的值。例如,如果要傳遞的值在第一資料欄中,請參考 C1。 |
COLUMN_NAME |
這意謂著要傳入的值已由 SELECT 陳述式擷取。值應該與 SELECT 子句中定義的名稱相符。 |
||
'文字值' |
這意謂著應傳入單引號所括住的文字值。 |
||
list= |
這可用來啟用此資料欄的工作列表功能。 您可以視需要植入 listdesc= 記憶碼,以置換將放在工作列表區域中的文字。 |
true |
設定 list=true 將使得工作列表圖示出現在資料欄標頭中。如果使用者按一下資料欄,就會將輸出中的所有資料列植入工作列表區域中。 備註:就「資訊資料總管 - 多重 SQL」區域類型 (F1–DE) 而言,輸出可能會顯示多個 SQL 陳述式的結果聯集。在此情況下,如果部分 (而非全部) SQL 陳述式為指定的資料欄設定 list=true,當使用者按一下圖示時,便只有設定此記憶碼之陳述式的儲存格中資料會被放入工作列表中。另請注意,建立區域時,在決定哪些資料欄應該有工作列表圖示時,系統只會查看 SQL 1 中資料欄的組態。
|
listdesc= |
這是使用 list= 記憶碼時的選擇性記憶碼。它可用來置換放在工作列表區域中的文字。 |
Cx |
Cx 代表先前資料欄的值。例如,如果要使用的文字在第一資料欄中,請參考 C1。 |
listbroadcast= |
指出也要在工作列表區域中提供資料欄的廣播資訊。這意謂著可以使用工作列表以和資料總管相同的方式將資訊廣播至入口。 |
true |
使用此設定來開啟功能。 |
常見使用案例
此區段提供一些通用組態,可供新建立的區域複製及貼上。
使用案例 |
程式碼片段 |
---|---|
顯示 SQL 陳述式中已擷取的查尋值描述。業務服務會檢查置換標籤。 |
source=BS bs='F1-GetLookupDescription' label=FLD_NAME input=[fieldName='FLD_NAME' fieldValue=FLD_NAME] output=description |
顯示外來索引鍵與其資訊,但隱藏導覽。(當您的外來索引鍵是區域中的其他資訊,但啟用導覽會造成混淆時,這會相當實用。若要顯示外來索引鍵參考及其資訊並針對導覽啟用,請使用上述 FKREF 的來源。) 第一個範例是假設您知道外來索引鍵參考。第二個範例使用接收維護物件作為輸入的業務服務。 |
source=BS bs='F1-GetForeignKeyReference' input=[input/fkReference=FK_REF_CD input/fkValue1=BUS_OBJ_CD] output=output/infoDescription label=DESCR |
source=BS bs='F1-GetFKReferenceDetails' input=[input/maintenanceObject='F1-EXT LKUP' input/pkValue1=BUS_OBJ_CD input/pkValue2=C1] output=output/infoDescription label=DESCR |
|
顯示一般物件的外來索引鍵 (包括對應的導覽連結),該物件不一定有外來索引鍵參考。如果有外來索引鍵參考存在,則會顯示其資訊,否則不會顯示。 標準外來索引鍵服務會假設所有資料列都有外來索引鍵明細。服務指令檔 F1FKInfoOpt 提供相同的外來索引鍵明細,但外來索引鍵明細不存在時不會發生錯誤。若要建立外來索引鍵描述和連結,指令碼必須使用兩次;其中一個資料欄會取得導覽明細,另一個資料欄則取得描述。後者會參考導覽明細資料欄,並叫用業務處理助理指令檔以執行動態導覽。 |
此資料欄會取得導覽明細: source=SS ss='F1FKInfoOpt' input=[input/fkReference=C9 input/fkValue1=C6 input/fkValue2=C7] output=output/navigationOption suppress=true 此資料欄會建構外來索引鍵描述和連結: source=SS ss='F1FKInfoOpt' input=[input/fkReference=C9 input/fkValue1=C6 input/fkValue2=C7] output=output/infoDescription label=F1_APPSEC_COMP_DESCR bpa='F1ApsecNav' tempstorage=[navopt=C15 pkField1=C10 pkValue1=C6 pkField2=C11 pkValue2=C7] list=true |