Parametry kolumn

Strefy eksploratora danych służą do wybierania danych do wyświetlania przy użyciu jednej lub wielu instrukcji SQL. Dla każdej instrukcji SQL można skonfigurować w strefie maksymalnie 20 kolumn zawierających definicję formatowania na potrzeby wyświetlania danych wyjściowych.

Parametry stosowane w typach stref:

  • Eksplorator danych dotyczących informacji - jedna instrukcja SQL (F1-DE-SINGLE). W parametrach stosowany jest wzorzec opisu Kolumna x.

  • Eksplorator danych dotyczących informacji - wiele instrukcji SQL (F1-DE). W strefie tego typu wykonywane są wszystkie instrukcje SQL, a w strefie wyświetlane są łącznie wszystkie wyniki. W parametrach stosowany jest wzorzec opisu Kolumna x dla SQL y. Istnieją mnemoniki, które nie powinny różnić się w obrębie wierszy tej samej kolumny. Na przykład etykieta kolumny. W przypadku tych mnemoników tylko wartość w polu "SQL 1" jest brana pod uwagę dla tej kolumny. Mnemoniki, których dotyczy ta reguła, przedstawiono w poniższej tabeli.

  • Eksplorator danych dotyczących zapytania - wiele instrukcji SQL (F1-DE-QUERY). W strefie tego typu wykonywana jest tylko jedna instrukcja SQL. Do kontrolowania tej opcji można zastosować parametr Warunek y SQL. Wykonana zostanie pierwsza instrukcja SQL, której warunek jest spełniony (lub dla której nie wypełniono warunku). W parametrach stosowany jest wzorzec opisu Kolumna x dla SQL y.

W kolejnych sekcjach opisano różne typy mnemoników.

Omawiane tematy

Mnemoniki źródłowe

Mnemoniki formatowania

Mnemoniki klikania

Typowe przypadki użycia

Mnemoniki źródłowe

Tabela zawiera opis mnemoników kontrolujących sposób wyznaczania danych w kolumnie.

Mnemonik

Opis

Poprawne wartości

Komentarze

source=

Definiuje sposób wyznaczania wartości kolumny.

SQLCOL

Wskazuje, że źródłem wartości kolumny jest kolumna w instrukcji SQL. Ten typ kolumny musi odwoływać się również do mnemonika sqlcol=.

BO

Wskazuje, że źródłem wartości kolumny jest obiekt biznesowy. Ten typ kolumny musi odwoływać się również do mnemoników bo=, input= i output= w celu zdefiniowania sposobu interakcji z obiektem biznesowym.

BS

Wskazuje, że źródłem wartości kolumny jest usługa biznesowa. Ten typ kolumny musi odwoływać się również do mnemoników bs=, input= i output= w celu zdefiniowania sposobu interakcji z usługą biznesową.

SS

Wskazuje, że źródłem wartości kolumny jest skrypt usługi. Ten typ kolumny musi odwoływać się również do mnemoników ss=, input= i output= w celu zdefiniowania sposobu interakcji ze skryptem biznesowym.

FORMULA

Wskazuje, że źródło wartości kolumny jest obliczane przy użyciu formuły. Ten typ kolumny musi odwoływać się również do mnemonika formula=.

SETFUNC

Wskazuje, że źródło wartości kolumny jest obliczane przy użyciu głównego zestawu wartości z wierszy w instrukcji SQL. Ten typ kolumny musi odwoływać się również do mnemonika setfunc=.

ICON

Wskazuje, że źródło wartości kolumny to odwołanie do ikony wyświetlania (oznacza to, że w kolumnie wyświetlana będzie ikona). Ten typ kolumny musi odwoływać się również do mnemonika icon= w celu zdefiniowania odwołania do ikony.

Uwaga: W przypadku używania tego mnemonika źródła, nie ma zastosowania mnemonik formatowania type=.

FKREF

Wskazuje, że źródło wartości kolumny to odwołanie do klucza obcego (oznacza to, że w kolumnie wyświetlane będzie menu kontekstowe odwołania do klucza obcego i ciąg informacji, a także włączona będzie nawigacja). Ten typ kolumny musi odwoływać się również do mnemoników fkref= i input= w celu zdefiniowania sposobu wywoływania odwołania do klucza obcego.

Uwaga: W przypadku używania tego mnemonika źródła, nie ma zastosowania mnemonik formatowania type=.
Uwaga: Aby pokazać informacje o kluczu obcym bez włączania nawigacji, należy skorzystać z zalecanej techniki opisanej w sekcji Typowe przypadki użycia.

SPECIFIED

Wskazuje, że źródło wartości kolumny jest określane przez połączenie literałów i innych wartości kolumny. Ten typ kolumny musi odwoływać się również do mnemonika spec=.

MSG

Wskazuje, że źródło wartości kolumny to komunikat z tabeli komunikatów (wraz ze zmiennymi podstawianymi). Ten typ kolumny musi odwoływać się również do mnemonika msg=.

sqlcol=

Definiuje kolumnę w instrukcji SQL, gdy mnemonik source=SQLCOL.

COLUMN_​​NAME

Należy wprowadzić nazwę kolumny pobraną z instrukcji SELECT. Jeśli w instrukcji SELECT używany jest alias kolumny, w tym miejscu należy uwzględnić odwołanie do niego.

x

Gdzie x to wartość całkowita odwołująca się do kolumny na podstawie swojej względnej pozycji w instrukcji SELECT. Na przykład wartość sqlcol=3 spowoduje wyświetlenie trzeciej kolumny w instrukcji SELECT.

bo=

Definiuje obiekt biznesowy do wywołania, gdy mnemonik source=BO.

Ten mnemonik musi być używany wraz z mnemonikami input= i output= w celu zdefiniowania sposobu wysyłania/otrzymywania informacji z obiektu biznesowego.

'Kod obiektu biznesowego'

bs=

Definiuje usługę biznesową, gdy mnemonik source=BS.

Ten mnemonik musi być używany wraz z mnemonikami input= i output= w celu zdefiniowania sposobu wysyłania/otrzymywania informacji z usługi biznesowej.

'Kod usługi biznesowej'

ss=

Definiuje skrypt usługi, gdy mnemonik source=SS.

Ten mnemonik musi być używany wraz z mnemonikami input= i output= w celu zdefiniowania sposobu wysyłania/otrzymywania informacji ze skryptu usługi.

'Kod skryptu usługi'

fkref=

Definiuje odwołanie do klucza obcego służącego do pobrania informacji kolumny, gdy mnemonik source=FKREF.

Ten mnemonik musi być używany wraz z mnemonikiem input= w celu zdefiniowania sposobu wysyłania informacji do odwołania do klucza obcego w celu utworzenia informacji.

Cx

Oznacza, że odwołanie do klucza obcego zostało zdefiniowane we wcześniejszej kolumnie. Na przykład, należy zdefiniować C1, jeśli kolumna 1 definiuje wartość odwołania do klucza obcego.

COLUMN_​​NAME

Oznacza, że odwołanie do klucza obcego zostało pobrane przez instrukcję SELECT. Wartość powinna być zgodna z nazwą zdefiniowaną w klauzuli SELECT.

'Kod odwołania do klucza obcego'

Oznacza, że odwołanie do klucza obcego zostało bezpośrednio zdefiniowane. Na przykład: 'F1-ROLE'.

formula=

Definiuje formułę do użycia, gdy mnemonik source=FORMULA.

Przykłady:

  • formula=C1*.90/C2

  • formula=(C1/C2)*100

Formuła może zawierać stałe liczbowe, operatory i odwołania do kolumn.

W przypadku odwołań do kolumn należy zastosować format Cx, gdzie x oznacza numer kolumny.

Informacje o obsługiwanych funkcjach zawiera sekcja Analizator składni wyrażeń.

setfunc=

Definiuje funkcję do zastosowania w wierszach danej kolumny, gdy mnemonik source=SETFUNC.

function(Cx)

Gdzie Cx oznacza kolumnę, w której wierszach zastosowano jedną z poniższych funkcji:

  • MAX. Służy do wyznaczania maksymalnej wartości wszystkich wierszy w kolumnie.

  • MIN. Służy do wyznaczania minimalnej wartości wszystkich wierszy w kolumnie.

  • TOT. Służy do wyznaczania sumy (łącznej wartości) wszystkich wierszy w kolumnie.

  • ACC. Służy do wyznaczania skumulowanej sumy wszystkich wierszy w kolumnie z uwzględnieniem bieżącego wiersza.

input=

Definiuje jedno lub wiele pól wejściowych i wartości przekazanych do obiektów biznesowych, usług biznesowych, skryptów usług i odwołań do klucza obcego.

Składnia jest następująca: [ELEMENT_​​NAME=ELEMENT_​​REF ELEMENT_​​NAME=ELEMENT_​​REF ...]

Oznacza to, że lista wartości wejściowych powinna zostać umieszczona w nawiasach kwadratowych oddzielanych spacją. Każda przekazana wartość definiuje najpierw ELEMENT_​​NAME, czyli nazwę elementu/pola w wartości docelowej. Przekazywana wartość to ELEMENT_​​REF. W następnej kolumnie zamieszczono możliwe wartości ELEMENT_​​REF.

Cx Gdzie Cx oznacza wartość poprzedniej kolumny. Jeśli wartość do przekazania znajduje się w pierwszej kolumnie, należy zastosować odwołanie do C1.
COLUMN_​​NAME Oznacza, że wartość do przekazania została pobrana przez instrukcję SELECT. Wartość powinna być zgodna z nazwą zdefiniowaną w klauzuli SELECT.
'wartość literału' Oznacza, że należy przekazać wartość literałową w pojedynczych cudzysłowach.
userTimeZone Oznacza, że należy przekazać strefę czasową bieżącego użytkownika. Zwykle jest stosowana z usługą biznesową F1-ShiftDateTime do konwertowania danych w strefie czasowej przechowywania na strefę czasową użytkownika na potrzeby wyświetlania.
installationTimeZone Oznacza, że należy przekazać strefę czasową instalacji. Zwykle jest stosowana z usługą biznesową F1-ShiftDateTime do konwertowania danych w strefie czasowej przechowywania na strefę czasową instalacji na potrzeby wyświetlania.

Przykłady:

  • input=[USER_​​ID=C1]

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

  • input=[input/targetTimeZone=userTimeZone]

output=

Definiuje nazwę elementu pobranego z obiektu biznesowego, usługi biznesowej lub skryptu usługi używanych do wypełnienia tej kolumny.

elementName

Przykład: output=personInfo

pagingkey=

Ten mnemonik ma zastosowanie tylko wtedy, gdy skonfigurowano parametr Włączanie stronicowania. Wskazuje, że dana kolumna jest jednym z kluczy używanych w instrukcji SQL do zorganizowania paginacji wyników. Ten mnemonik można określić tylko wtedy, gdy mnemonik source=SQLCOL.

Szybki dostęp: Więcej informacji można znaleźć w sekcji Konfiguracja stronicowania.

Y

N

Jest to wartość domyślna. Nie jest konieczne wskazywanie wartości pagingkey=N, aby określić, że kolumna nie jest jednym z kluczy paginacji.

Uwaga: Jeśli wiele kolumn ma skonfigurowany ten sam źródłowy obiekt biznesowy, usługę biznesową lub skrypt usługi i takie same dane wejściowe, dane wyjściowe z pierwszego wywołania są przechowywane w systemie w pamięci podręcznej, a wyniki są ponownie wykorzystywane w kolejnych kolumnach.

Mnemoniki formatowania

Tabela zawiera opis mnemoników kontrolujących sposób formatowania kolumny.

Uwaga: W strefie typu F1-DE wyświetlane są łącznie wszystkie instrukcje SQL.

Mnemonik

Opis

Poprawne wartości

Komentarze

type=

Definiuje sposób formatowania wartości kolumny.

Uwaga: Kolumny Ikona i Klucz obcy. Mnemonik źródłowy source= może służyć do wskazania, że kolumnę należy wyznaczyć na podstawie odwołania do ikony lub odwołania do klucza obcego. Jeśli używana jest jedna z tych wartości, mnemonik type= nie ma zastosowania, ponieważ w kolumnie zostanie wyświetlona ikona lub menu kontekstowe/ciąg informacji.

STRING

W kolumnach tego typu pobierany jest ciąg. Jest to opcja domyślna.

DATE

W kolumnach tego typu pobierana jest data. Są one wyświetlane przy użyciu profilu wyświetlania użytkownika.

TIME

W kolumnach tego typu pobierana jest godzina (w formacie bazy danych). Są one wyświetlane przy użyciu profilu wyświetlania użytkownika.

DATE/TIME

W kolumnach tego typu pobierana jest data i godzina (w formacie bazy danych). Są one wyświetlane przy użyciu profilu wyświetlania użytkownika.

MONEY

W kolumnach tego typu pobierane jest pole danych pieniężnych. Ten typ kolumny może odwoływać się również do mnemonika cur=. Jeśli nie określono mnemonika cur, używany jest kod waluty z rekordu instalacji.

NUMBER

W kolumnach tego typu pobierane jest pole liczbowe. Ten typ kolumny może odwoływać się również do mnemonika dec=.

label=

Definiuje etykietę nadpisania kolumny. Ta etykieta jest wyświetlana w nagłówku kolumny oraz w obszarze czynności przeciągania w strefie.

Jeśli nie zdefiniowano tego mnemonika, używana jest domyślna etykieta kolumny. Źródło domyślnej etykiety kolumny różni się w zależności od źródła kolumny. W niektórych źródłach nie istnieje wartość domyślna, a ominięcie tego mnemonika spowoduje, że wartość etykiety będzie pusta.

Uwaga:

W przypadku strefy typu "Eksplorator danych dot. informacji - wiele instrukcji SQL" (F1-DE) etykiety zostaną zdefiniowane na podstawie definicji kolumn w instrukcji SQL 1.

FIELD_​NAME

Należy wprowadzić prawidłową nazwę pola, którego etykieta zostanie użyta jako etykieta kolumny. Ta opcja powinna być zawsze stosowana, gdy wymagane jest wiele języków.

'text'

Określa tekst w sposób bezpośredni.

cur=

Definiuje kod waluty stosowany, gdy mnemoniktype=MONEY, jeśli nie należy używać waluty zawartej w rekordzie instalacji.

Cx

Oznacza, że wartość kodu waluty jest zdefiniowana we wcześniejszej kolumnie. Na przykład, należy zdefiniować C1, jeśli kolumna 1 definiuje kod waluty.

COLUMN_​NAME

Oznacza, że kod waluty został pobrany przez instrukcję SELECT. Wartość powinna być zgodna z nazwą zdefiniowaną w klauzuli SELECT.

'Kod waluty'

Oznacza, że kod waluty został bezpośrednio zdefiniowany. Na przykład: 'USD'.

dec=

Określa liczbę miejsc dziesiętnych w przypadku, gdy mnemonik type=NUMBER.

Wartość opcjonalna. W przypadku jej określenia należy wprowadzić liczbę całkowitą. Jeśli nie podano tej wartości, zostanie ustawiona domyślna liczba miejsc dziesiętnych zdefiniowana dla kodu waluty określonego w rekordzie instalacji.

nR

Gdzie n to liczba wyświetlanych miejsc po przecinku. Dołączenie przyrostka R do liczby miejsc po przecinku oznacza, że wartości będą zaokrąglane w górę/w dół. Określenie tylko wartości n (bez R), oznacza, że miejsca po przecinku będą obcinane. Na przykład wprowadzenie wartości dec=4 spowoduje wyświetlenie 4 miejsc po przecinku i obcięcie pozostałych.

Uwaga: Tylko formatowanie. Ten mnemonik jest używany tylko na potrzeby formatowania, nie ma natomiast wpływu na dokładność kolejnych obliczeń. Na przykład, jeśli w kolumnie pobranej z bazy danych znajduje się 6 znaczących cyfr i mnemonik dec=0, kolumna będzie pokazywana bez miejsc dziesiętnych (zostaną obcięte), jednak wszystkie odwołania do kolumny w kolejnych obliczeniach będą wyświetlane z 6 miejscami dziesiętnymi. Na przykład, jeśli istnieje odwołanie do kolumny w formule lub funkcji zbioru, używanych będzie wszystkich 6 miejsc dziesiętnych.

char=

Ten mnemonik powoduje zastosowanie specjalnych znaków w wartości kolumny.

'x[]x'

Gdzie x odnosi się do wartości literałowej do wyświetlenia, a [ ] definiuje względną pozycję znaków (przed wartością lub za nią).

Aby umieścić znaki przed wartością, konieczne jest uwzględnienie znaków [ ]. Na przykład: char='%' spowoduje umieszczenie znaku procent za wartością. Aby umieścić przed wartością słowo "minuty", należy wprowadzić wartość char='minutes [ ]'. Aby uzyskać wartość typu BUDGET $123.12 (OPR), należy wprowadzić wartość char='BUDGET [ ] (YTD)'.

suppress=

Wskazuje, że kolumna nie powinna być wyświetlana.

Kolumna będzie ukryta, jeśli zdefiniowano ją tylko do użycia w kolejnych kolumnach, na przykład, gdy istnieje formuła wyznaczająca kolumnę na podstawie dwóch innych kolumn. W takim scenariuszu kolumny, do których odwołuje się formuła, mogą być ukryte.

Uwaga:

W przypadku strefy typu "Eksplorator danych dot. informacji - wiele instrukcji SQL" (F1-DE) ustawienia definicji kolumn w instrukcji SQL 1 zostaną zastosowane do wszystkich kolejnych instrukcji SQL.

true

false

Jest to wartość domyślna. Nie jest konieczne wskazywanie wartości suppress=false w celu określenia, że pole powinno być pokazywane.

suppressSearch=

Wskazuje, że kolumna nie powinna być wyświetlana, gdy strefa jest wywoływana w tylko w trybie wyszukiwania.

Uwaga:

W przypadku strefy typu "Eksplorator danych dot. informacji - wiele instrukcji SQL" (F1-DE) ustawienia definicji kolumn w instrukcji SQL 1 zostaną zastosowane do wszystkich kolejnych instrukcji SQL.

true

false

Jest to wartość domyślna. Nie jest konieczne wskazywanie wartości suppressSearch=false w celu określenia, że pole powinno być pokazywane.

suppressExport=

Wskazuje, że kolumna nie powinna być pobierana do programu Excel.

Uwaga:

W przypadku strefy typu "Eksplorator danych dot. informacji - wiele instrukcji SQL" (F1-DE) ustawienia definicji kolumn w instrukcji SQL 1 zostaną zastosowane do wszystkich kolejnych instrukcji SQL.

true

false

Jest to wartość domyślna. Nie jest konieczne wskazywanie wartości suppressExport=false w celu określenia, że pole powinno być uwzględnione w pobieraniu.

width=

Umożliwia nadpisanie szerokości kolumny (liczby pikseli). Domyślna wartość to maksymalna szerokość dowolnej komórki w kolumnie.

n

Gdzie n to liczba z zakresu od 0 do 999.

Uwaga:

W przypadku braku dostępnego punktu podziału danych kolumna będzie dłuższa od określonej liczby pikseli.

Długość etykiety kolumny (wyświetlanej w nagłówku kolumny) może również spowodować, że szerokość będzie większa od określonej.

W przypadku strefy typu "Eksplorator danych dot. informacji - wiele instrukcji SQL" (F1-DE) szerokość zostanie ustawiona na podstawie definicji kolumn w instrukcji SQL 1.

color=

Umożliwia nadpisanie koloru tekstu w kolumnie.

Prawidłowy "nazwany" kolor HTML

Na przykład color=yellow.

Uwaga: Informacje na temat wykorzystania koloru czerwonego z języka HTML i jego wpływu na dostępność zawiera sekcja Kontrast koloru.

Prawidłowa kombinacja modelu kolorów RGB

Na przykład: color=#E0292F lub color=#CCCCCC. Uwaga: Symbol # jest wymagany.

bgcolor=

Umożliwia nadpisanie koloru tła w kolumnie.

Prawidłowy "nazwany" kolor HTML

Podobne do mnemonika color=.

Prawidłowa kombinacja modelu kolorów RGB

Podobne do mnemonika color=.

order=

Definiuje domyślny porządek sortowania w kolumnie.

ASC

Wskazuje porządek rosnący. Jest to wartość domyślna. Nie jest konieczne wskazywanie wartości order=ASC.

DESC

Wskazuje porządek malejący.

rowHeader=

Służy do oznaczania kolumny jako nagłówka wiersza do celów dostępności.

true

Domyślnie, jako nagłówek wiersza na potrzeby narzędzi dostępności określona jest pierwsza kolumna danych w wynikach eksploratora danych. Jeżeli dane w pierwszej kolumnie nie umożliwiają unikatowej identyfikacji wiersza, należy użyć tego mnemoniku do wyraźnego oznaczenia innej kolumny lub wielu kolumn jako nagłówka wiersza.

Uwaga: W przypadku strefy typu "Eksplorator danych dot. informacji - wiele instrukcji SQL" (F1-DE) uwzględniane będą tylko te kolumny w instrukcji SQL 1, które mają zdefiniowany ten mnemonik, i zostanie on zastosowany do wszystkich wyników w tych kolumnach.

Mnemoniki klikania

Tabela zawiera opis mnemoników, które definiują, czy można kliknąć wartość kolumny oraz jakie działanie zostanie uruchomione po kliknięciu.

Mnemonik

Opis

Poprawne wartości

Komentarze

navopt=

Definiuje opcję nawigacji odwołującą się do docelowych transakcji lub skryptu po kliknięciu kolumny przez użytkownika.

Uwaga: Tego mnemonika należy używać wraz z mnemonikiem context= w celu zdefiniowania informacji wysyłanych do docelowej transakcji opcji nawigacji.

Ten mnemonik jest pomijany, gdy source=FKREF, ponieważ w kodzie odwołania do klucza obcego zdefiniowane jest miejsce docelowe hiperłącza.

Cx

Oznacza, że kod opcji nawigacji został zdefiniowany we wcześniejszej kolumnie. Na przykład, należy zdefiniować C1, jeśli kolumna 1 definiuje opcję nawigacji.

COLUMN_​NAME

Oznacza, że opcja nawigacji została pobrana przez instrukcję SELECT. Wartość powinna być zgodna z nazwą zdefiniowaną w klauzuli SELECT.

Przykład: navopt=MAIN_​PORTAL

'Kod opcji przechodzenia'

Oznacza, że opcja nawigacji została bezpośrednio zdefiniowana. Na przykład: navopt='userMaint'.

context=

Definiuje jedno lub wiele pól kontekstowych i wartości przekazanych do docelowej opcji nawigacji w celu zastosowania wraz z mnemonikiem navopt=.

Składnia jest następująca: [FIELD_​NAME=FIELD_​REF FIELD_​NAME=FIELD_​REF ...]

Oznacza to, że lista wartości wejściowych powinna zostać umieszczona w nawiasach kwadratowych oddzielanych spacją. Każda przekazana wartość definiuje najpierw FIELD_​NAME, czyli nazwę pola kontekstowego w opcji nawigacji. Przekazywana wartość to FIELD_​REF. W następnej kolumnie zamieszczono możliwe wartości FIELD_​REF.

Cx

Gdzie Cx oznacza wartość poprzedniej kolumny. Na przykład, jeśli wartość do przekazania znajduje się w pierwszej kolumnie, należy zastosować odwołanie do C1.

COLUMN_​NAME

Oznacza, że wartość do przekazania została pobrana przez instrukcję SELECT. Wartość powinna być zgodna z nazwą zdefiniowaną w klauzuli SELECT.

'wartość literału'

Oznacza, że należy przekazać wartość literałową w pojedynczych cudzysłowach.

bpa=

Wskazuje, że skrypt APB powinien być wykonany po kliknięciu kolumny przez użytkownika i wskazaniu skryptu APB do wykonania.

Uwaga: Tego mnemonika należy używać wraz z mnemonikiem tempstorage= w celu zdefiniowania wartości tymczasowego przechowywania, które zostaną uruchomione po wykonaniu skryptu.

Ten mnemonik jest pomijany, gdy source=FKREF, ponieważ w kodzie odwołania do klucza obcego zdefiniowane jest miejsce docelowe hiperłącza.

Cx

Wskazuje, że skrypt APB został zdefiniowany w poprzedniej kolumnie.

COLUMN_​NAME

Oznacza, że skrypt APB do wykonania został pobrany przez instrukcję SELECT. Wartość powinna być zgodna z nazwą zdefiniowaną w klauzuli SELECT.

'Kod skryptu APB'

Oznacza, że skrypt APB do wykonania został bezpośrednio zdefiniowany.

tempstorage=

Definiuje sposób uruchamiania zmiennych tymczasowego przechowywania, gdy używany jest mnemonik bpa=.

Składnia jest następująca: [FIELD_​NAME=FIELD_​REF FIELD_​NAME=FIELD_​REF ...]

Oznacza to, że lista wartości wejściowych powinna zostać umieszczona w nawiasach kwadratowych oddzielanych spacją. Każda przekazana wartość definiuje najpierw FIELD_​NAME, czyli nazwę pola w pamięci tymczasowej. Przekazywana wartość to FIELD_​REF. W następnej kolumnie zamieszczono możliwe wartości FIELD_​REF.

Cx

Gdzie Cx oznacza wartość poprzedniej kolumny. Na przykład, jeśli wartość do przekazania znajduje się w pierwszej kolumnie, należy zastosować odwołanie do C1.

COLUMN_​NAME

Oznacza, że wartość do przekazania została pobrana przez instrukcję SELECT. Wartość powinna być zgodna z nazwą zdefiniowaną w klauzuli SELECT.

'wartość literału'

Oznacza, że należy przekazać wartość literałową w pojedynczych cudzysłowach.

list=

Powoduje włączenie funkcji listy roboczej w kolumnie.

Opcjonalnie można wypełnić mnemonik listdesc= w celu nadpisania tekstu umieszczanego w strefie listy roboczej.

true

Ustawienie wartości list=true spowoduje wyświetlenie ikony listy roboczej w nagłówku kolumny. Po kliknięciu kolumny przez użytkownika wszystkie wiersze w pliku wyjściowym zostaną wypełnione w strefie listy roboczej.

Uwaga: W strefie typu "Eksplorator danych dot. informacji - wiele instrukcji SQL" (F1-DE) w pliku wynikowym może być wyświetlana grupa wyników wielu instrukcji SQL. W tym przypadku, jeśli niektóre instrukcje SQL konfigurują daną kolumnę za pomocą wartości list=true (jednak nie wszystkie), wówczas tylko dane w komórkach odnoszących się do instrukcji konfigurujących ten mnemonik zostaną umieszczone na liście roboczej po kliknięciu ikony przez użytkownika. Należy również pamiętać, że przy ustalaniu, które kolumny powinny zawierać ikonę listy roboczej podczas tworzenia strefy, analizowana jest wyłącznie konfiguracja kolumn w instrukcji SQL 1.

listdesc=

Mnemonik opcjonalny używany wraz z mnemonikiem list=. Można go zastosować w celu nadpisania tekstu umieszczanego w strefie listy roboczej.

Cx

Gdzie Cx oznacza wartość poprzedniej kolumny. Na przykład, jeśli tekst do użycia znajduje się w pierwszej kolumnie, należy zastosować odwołanie do C1.

listbroadcast=

Wskazuje, że informacje o rozsyłaniu dotyczące kolumny mają zostać również udostępnione w strefie listy roboczej. Oznacza to, że można użyć listy roboczej do rozsyłania informacji do portalu w taki sam sposób, jak do eksploratora danych.

true

Ustawienie służące do włączenia cechy.

Typowe przypadki użycia

W tej sekcji przedstawiono niektóre typowe konfiguracje, które można kopiować i wklejać w nowo utworzonych strefach.

Przypadek użycia

Snippet kodu

Wyświetlanie opisu wartości wyszukiwania, która została pobrana w instrukcji SQL. Usługa biznesowa sprawdza, czy istnieje nadpisanie etykiety.

source=BS

bs='F1-GetLookupDescription'

label=FLD_​NAME

input=[fieldName='FLD_​NAME' fieldValue=FLD_​NAME]

output=description

Wyświetlanie klucza obcego wraz z informacjami o nim, ale z pominięciem nawigacji. (Jest to przydatne, gdy dany klucz obcy jest dodatkową informacją w strefie, ale włączenie nawigacji mogłoby spowodować problemy. W celu wyświetlenia odwołania do klucza obcego wraz z informacjami o nim oraz z włączoną nawigacją należy skorzystać ze źródła FKREF, w sposób opisany powyżej.)

W pierwszym przykładzie przyjmuje się, że użytkownik zna odwołanie do klucza obcego. W drugim przykładzie używana jest usługa biznesowa, której dane wejściowe stanowi obiekt obsługi.

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

Wyświetlanie klucza obcego, w tym odpowiedniego łącza nawigacji, dla obiektów ogólnych, dla których może, ale nie musi istnieć odwołanie do klucza obcego. Jeśli istnieje odwołanie do klucza obcego, wyświetlane są jego informacje, w przeciwnym razie nie są one wyświetlane.

W standardowych usługach klucza obcego zakłada się, że wszystkie wiersze zawierają szczegóły klucza obcego. Skrypt usługi F1FKInfoOpt zawiera te same szczegóły klucza obcego, ale nie powoduje błędu, gdy szczegóły klucza obcego nie istnieją. Aby utworzyć opis i łącze klucza obcego, należy użyć skryptu dwa razy; w jednej kolumnie pobierane są szczegóły nawigacji, a w drugiej - opis. Ten ostatni odwołuje się do kolumny szczegółów nawigacji i wywołuje skrypt APB w celu wykonania dynamicznej nawigacji.

Ta kolumna zawiera szczegóły nawigacji:

source=SS

ss='F1FKInfoOpt'

input=[input/fkReference=C9 input/fkValue1=C6 input/fkValue2=C7]

output=output/navigationOption

suppress=true

W tej kolumnie tworzony jest opis i łącze klucza obcego:

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