Net.Data 참조서

내포된 테이블 변수

이 변수는 Net.Data에 의해 정의되며, 별도로 정의되지 않으면 REPORT 및 ROW 블록에서만 인식됩니다. 조회로부터 리턴된 변수를 참조하려면 이 변수를 사용하십시오.

N_columnName
Nn
NLIST
NUM_COLUMNS
RETURN_CODE
ROW_NUM
TOTAL_ROWS
V_columnName
Vn
VLIST

N_columnName

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

지정된 컬럼명의 이름. REPORT 및 ROW 블록에서 유효합니다.

예

예제 1:

%REPORT{
<P>Send e-mail to <a href="mailto:$(N_email)">$(N_name)</a>.
.
.
.
%}

Nn

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

함수 호출이나 컬럼n에 대한 조회로부터 리턴된 컬럼명이 들어 있습니다. REPORT 및 ROW 블록에서 유효합니다.

예

예제 1:

The name of column 2 is $(N2).

예제 2: 이 예제는 DTW_ASSIGN을 사용하여 REPORT 블록 밖에서 이 변수를 사용하는 방법에 대해 설명합니다. 자세한 정보는 DTW_ASSIGN 을 참조하십시오.

...
%ROW{
 @DTW_ASSIGN(col1, N1)
%}

%HTML(report){
@
Column 1 was $(col1).
%}

예제 3:

%REPORT{
<H2>Product directory</H2>
<TABLE BORDER=1 CELLPADDING=3>
<TR><TD>$(N1)</TD><TD>$(N2)</TD><TD>$(N5)</TD>
%ROW{
<TR><TD>$(V1)</TD><TD>$(V2)</TD><TD>$(V3)</TD>
%}
</TABLE>
Found $(ROW_NUM) models matching your description.
%}

NLIST

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

함수 호출 또는 조회 결과로부터 리턴된 모든 컬럼명이 들어 있습니다. 생략시 분리 문자인 널(NULL)은 모든 컬럼명을 함께 수행합니다. 하지만, List 변수를 사용하여 DEFINE 명령문이나 블록에 다른 분리 문자를 지정하거나, ALIGN="YES"를 설정하여 공백을 분리 문자로 사용할 수 있습니다. 자세한 정보는 ALIGN 을 참조하십시오.

예

예제 1: 컬럼명 목록는 ALIGN을 YES로 지정하여 컬럼명 사이에 공백을 사용합니다.

%DEFINE ALIGN="YES"
%REPORT{
Your query was on these columns: $(NLIST).
.
.
.
%}

예제 2: 이 예제에서는 %LIST 변수를 사용하여 분리 문자를 " | "로 변경합니다.

%DEFINE %LIST " | " NLIST
%REPORT{
Your query was on these columns: $(NLIST).
.
.
.
%}

NUM_COLUMNS

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

컬럼 번호는 함수 호출이나 조회로부터 리턴됩니다.

예

예제 1:

%REPORT{
Your query result has $(NUM_COLUMNS) columns: $(NLIST).
...
%}

RETURN_CODE

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

리턴 코드는 함수 호출이나 조회로부터 리턴됩니다. Net.Data는 이 값을 사용하여 MESSAGE 블록을 처리합니다. 이 변수를 사용하여 함수 호출이 성공했는지 실패했는지를 판별할 수 있습니다. 값이 0이면, 함수 호출이 성공적으로 완료되었음을 나타냅니다.

RETURN_CODE 변수는 다음과 같은 컨텍스트에 들어 있을 수 있습니다.

%REPORT
%ROW
%MESSAGE
%HTML
%IF

예

예제 1: 적용업무 사용자에게 함수가 성공적으로 완료되었는지의 여부를 알려주는 메세지가 표시됩니다.

@function1()
%IF ("$(RETURN_CODE)" == "0")
 The function completed successfully.
%ELSE
The function failed with the return code $(RETURN_CODE).
%ENDIF

예제 2: 함수로부터 0이 아닌 리턴 코드가 리턴되면, 생략시 메세지가 표시됩니다.

%MESSAGE{
default: "<h2>Net.Data received return code: $(RETURN_CODE)</h2>" : continue
%}

ROW_NUM

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

ROW_NUM은 ROW 블록내에서만 유효하며, 이는 마지막 행이 처리될 때까지 증가되는 계수기입니다. 예를 들어, 테이블에 100행이 있을 경우에 RPT_MAX_ROWS을 20으로 설정하면, 이것이 처리된 마지막 행이기 때문에 ROW_NUM의 최종 값은 20이 됩니다.

예

예제 1:

%REPORT{
<TABLE BORDER=1>
<TR><TD> Row Number </TD> <TD> Customer </TD>
%ROW{
<TR><TD> $(ROW_NUM) </TD> <TD> $(V_custname) </TD>
%}
</TABLE>
%}

TOTAL_ROWS

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT

X

RPT_MAX_ROWS의 값에 관계없이 조회로부터 리턴되는 총 행의 수. 예를 들어, RPT_MAX_ROWS 가 최대 20행을 표시하도록 설정되어 있는데 조회로부터 100행이 리턴되면, 이 변수는 ROW 처리후에 100으로 설정됩니다. 이 변수를 사용하기 위해서는 DTW_SET_TOTAL_ROWS를 YES 로 설정해야 합니다. 자세한 내용은 DTW_SET_TOTAL_ROWS 를 참조하십시오.

예

%DEFINE DTW_SET_TOTAL_ROWS="YES"

%REPORT{
<H2>E-mail directory</H2>
<UL>
%ROW{
<LI>Name: <a href="mailto:$(V1)">$(V2)</a><BR>
Location: $(V3)
%}
</UL>
Names displayed: $(ROW_NUM)<BR>
Names found: $(TOTAL_ROWS)
%}

V_columnName

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

현재 행에 대해 지정된 컬럼의 값으로 ROW 블록내에서만 유효합니다. 지정되지 않은 컬럼명에 대한 변수는 존재하지 않습니다. 동일한 이름을 가진 두개의 컬럼명이 들어 있는 조회에서는 예상치 않은 결과가 나타납니다. 중복된 컬럼명의 이름을 변경하려면 SQL에 AS 절을 사용하도록 하십시오.

예

You have selected $(V_destcity).

Vn

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

함수 호출이나 SQL 조회에 의해 리턴된 각 행의 필드 1에서 n까지의 모든 필드에 대한 값이 들어 있습니다. 이 변수는 ROW 블록내에서만 인식됩니다. 이 변수를 블록 밖에서 사용하려면, DTW_ASSIGN 을 사용하십시오.

예

예제 1: 이 REPORT 블록은 HTML 테이블을 표시합니다. 두번째 컬럼은 전자 메일 주소를 나타냅니다. 링크를 클릭하여 사람에게 메세지를 전달할 수 있습니다.

%REPORT{
<H2>E-mail directory</H2>
<TABLE BORDER=1 CELLPADDING=3>
<TR><TD>Name</TD><TD>E-mail address</TD><TD>Location</TD>
%ROW{
<TR><TD>$(V1)</TD>
<TD><a href="mailto:$(V2)">$(V2)</a></TD>
<TD>$(V3)</TD>
%}
</TABLE>
Found $(ROW_NUM) models matching your description.
%}

VLIST

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

ROW 블록내에서 처리중인 현재 행의 모든 필드에 대한 값이 들어 있으며, 이는 ROW 블록내에서만 유효합니다. 생략시 분리 문자인 널(NULL)은 모든 값을 함께 수행합니다. 하지만, List 변수를 사용하여 DEFINE 명령문이나 블록에 list 분리 문자를 지정하거나, ALIGN="YES"를 설정하여 공백을 분리 문자로 사용할 수 있습니다. 자세한 정보는 ALIGN 을 참조하십시오.

함수 호출이나 조회로부터 리턴된 각 테이블 행의 필드 값. 생략시 분리 문자는 공백이지만, List 변수를 사용하여 DEFINE 블록이나 명령문에 다른 분리 문자를 지정할 수 있습니다.

예

예제 1:

%DEFINE ALIGN="YES"

%REPORT{
Here are the results of your query:
<OL>
%ROW{
<LI>$(VLIST)
%}
</OL>
%}

예제 2: 이 예제에서는 LIST 변수를 사용하여 분리 문자를 <P>로 변경합니다.

%DEFINE %LIST "<P>" VLIST

%REPORT{
Here are the results of your query:
%ROW{
<HR>$(VLIST)
%}
%}

[ 페이지의 맨 위 | 이전 페이지 | 다음 페이지 | 목차 | 색인 ]