資料欄參數

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= 記憶碼搭配使用，以定義向服務指令檔傳送/接收資訊的方式。

'服務指令檔代碼'

icon=

定義當 source=ICON 時要使用的圖示。

Cx

這意謂著「顯示圖示」代碼是在稍早的資料欄中定義。例如，如果資料欄 1 定義圖示代碼值，請定義 C1。

COLUMN_​​NAME

這意謂著「顯示圖示」代碼已由 SELECT 陳述式擷取。值應該與 SELECT 子句中定義的名稱相符。

'image'

這意謂著是以直接方式定義影像檔。例如 '/images/treeRootObject.gif'。

'Display Icon Code'

這意謂著是以直接方式定義「顯示圖示」代碼。例如 'F1EDIT'。

fkref=

當 source=FKREF 時，定義用來擷取資料欄資訊的外來索引鍵參考。

此記憶碼必須與 input= 記憶碼搭配使用，以定義如何將資訊傳送至外來索引鍵參考來建立資訊。

Cx

這意謂著外來索引鍵參考是在稍早的資料欄中定義。例如，如果資料欄 1 定義外來索引鍵參考值，請定義 C1。

COLUMN_​​NAME

這意謂著外來索引鍵參考已由 SELECT 陳述式擷取。值應該與 SELECT 子句中定義的名稱相符。

'外來索引鍵參考代碼'

這意謂著是以直接方式定義外來索引鍵參考。例如 'F1-ROLE'。

formula=

當 source=FORMULA 時，定義要使用的公式。

範例：

• formula=C1*.90/C2

• formula=(C1/C2)*100

公式可以包含數值常數、運算子及資料欄參考。

針對資料欄參考，請使用 Cx 格式，其中 x 代表資料欄編號。

如需有關所支援函數的資訊，請參考表示式剖析器。

setfunc=

當 source=SETFUNC 時，定義要對所指定資料欄的資料列套用的函數。

function(Cx)

Cx 代表其資料列應套用函數且函數為下列其中之一的資料欄：

• MAX。這會導出資料欄中所有資料列的最大值。

• MIN。這會導出資料欄中所有資料列的最小值。

• TOT。這會導出資料欄中所有資料列的總和 (總計值)。

• ACC。這會導出到目前資料列為止之所有資料列且包含目前資料列的累積總計。

input=

這可用來定義一或多個傳遞給業務物件、業務服務、服務指令檔及外來索引鍵參考的輸入欄位和值。

語法如下：[ELEMENT_​​NAME=ELEMENT_​​REF ELEMENT_​​NAME=ELEMENT_​​REF ...]

換句話說，輸入值列表是以中括號括住並以空格分隔。每個傳遞的值會先定義 ELEMENT_​​NAME，即目標中元素/欄位的名稱。ELEMENT_​​REF 是傳入的值。下一資料欄則指出 ELEMENT_​​REF 的可能值。

範例：

• input=[USER_​​ID=C1]

• input=[USER_​​ID=USER_​​ID]

• input=[input/targetTimeZone=userTimeZone]

output=

這是用來定義從用來植入此資料欄之業務物件、業務服務或服務指令檔中擷取的元素名稱。

elementName

範例：output=personInfo

只有在設定啟用分頁參數之後，才適用此記憶碼。它指出此資料欄是 SQL 陳述式用來協調所有結果之分頁的其中一個索引鍵。只有當 source=SQLCOL 時，才可以指定此記憶碼。

Y

N

這是預設值，也就是說，您完全不需要指示 pagingkey=N 來表示該資料欄不是其中一個分頁索引鍵。

type=

定義資料欄值的格式化方式。

STRING

此類型的資料欄會擷取字串。這是預設值。

DATE

此類型的資料欄會擷取日期，且顯示這些資料欄時，會使用使用者的顯示設定檔來顯示。

TIME

此類型的資料欄會擷取時間 (採用資料庫格式)，且顯示這些資料欄時，會使用使用者的顯示設定檔來顯示。

DATE/TIME

此類型的資料欄會擷取日期和時間 (採用資料庫格式)，且顯示這些資料欄時，會使用使用者的顯示設定檔來顯示。

MONEY

此類型的資料欄會擷取貨幣欄位。此類型的資料欄也可以參考 cur= 記憶碼。如果未指定 cur 記憶碼，則會使用安裝記錄上的幣別代碼。

NUMBER

此類型的資料欄會擷取數值欄位。此類型的資料欄也可以參考 dec= 記憶碼。

label=

定義資料欄的置換標籤。標籤會顯示在資料欄的標題和區域的拖放區中。

如果未定義此記憶碼，系統就會使用資料欄的預設標籤。資料欄預設標籤的來源會依據資料欄的來源而有所不同。請注意，有些來源沒有預設值，省略此記憶碼將導致標籤空白。

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 位小數位數並將剩餘位數截斷。

char=

此記憶碼會將特殊字元套用至資料欄值。

'x[]x'

x 會參考要顯示的文字值，而 [ ] 則定義字元的相對位置 (在值之前或之後)。

如果您想要將字元置於值之前，只需包含 [ ] 即可。例如，char='%' 會將百分比符號放在值後面。如果您想要將 'minutes' 一字放在值之前，請輸入 char='minutes [ ]'。如果您想要輸出類似 BUDGET $123.12 (YTD) 的值，請輸入 char='BUDGET [ ] (YTD)'。

suppress=

這是用來指出不應該顯示某個資料欄。

如果資料欄僅定義來供後續資料欄使用 (例如，如果有公式使用兩個其他資料欄來導出資料欄公式)，系統就會隱藏該資料欄。在此情況下，可以隱藏公式中參考的資料欄。

true

false

這是預設值，也就是說，您完全不需要指示 suppress=false 來表示應該顯示該欄位。

suppressSearch=

這是用來指出以僅搜尋模式叫用區域時，不應該顯示某個資料欄。

true

false

這是預設值，也就是說，您完全不需要指示 suppressSearch=false 來表示應該顯示該欄位。

suppressExport=

這是用來指出匯出時不應下載資料欄。

true

false

這是預設值，也就是說，您完全不需要指示 suppressExport=false 來表示下載時應該包含該欄位。

width=

這是用來置換資料欄寬度 (像素數)。預設值為資料欄中任何儲存格的最大寬度。

n

n 是介於 0 到 999 之間的數字。

color=

這是用來置換資料欄的文字顏色。

有效的 HTML「具名」顏色

例如 color=yellow。

有效的 RGB 顏色模型組合

例如 color=#E0292F 或 color=#CCCCCC。請注意，必須使用 #。

bgcolor=

這是用來置換資料欄的背景顏色。

有效的 HTML「具名」顏色

類似於 color= 記憶碼。

有效的 RGB 顏色模型組合

類似於 color= 記憶碼。

order=

定義資料欄的預設排序順序。

ASC

指出順序為遞增。這是預設值，也就是說，不需要指示 order=ASC。

DESC

指出順序為遞減。

rowHeader=

指定資料欄作為資料列標頭以用於輔助功能。

true

預設會針對輔助功能工具，將資料總管結果的第一個資料欄識別為資料列標頭。如果第一資料欄中的資料不會唯一識別資料列，請使用此記憶碼來明確將不同資料欄或多個資料欄標示為資料列標頭。

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 將使得工作列表圖示出現在資料欄標頭中。如果使用者按一下資料欄，就會將輸出中的所有資料列植入工作列表區域中。

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