참조서

Net.Data 테이블 처리 변수

Net.Data는 별다른 언급이 없는 한 이들 변수를 REPORT 및 ROW 블록에 사용하도록 정의합니다. 조회 결과 리턴된 값을 참조하려면 이 변수를 사용하십시오.

• Nn
• NLIST
• NUM_COLUMNS
• NUM_ROWS
• ROW_NUM
• TOTAL_ROWS
• V_columnName
• VLIST
• Vn

Nn

목적

컬럼 n에 대한 조회나 함수 호출로부터 리턴된 컬럼명.

REPORT 및 ROW 블록에서 Nn을 참조할 수 있습니다.

예

예 1: 컬럼명에 대한 변수 참조

The name of column 2 is $(N2).

예 2: DET_ASSIGN을 사용하여 REPORT 블록 외부에서 사용할 컬럼명의 값을 저장합니다.

%define col1=""
...
%function (DTW_SQL) myfunc() {
  select * from atable
%report {
     @dtw_assign(col1, N1)
     %row{ %}
  %}
%}
 
%html(report) {
@myfunc()
The column name for the first column is $(col1)
%}

이 예는 DTW_ASSIGN을 사용하여 REPORT 블록의 외부에 이 변수를 사용하는 방법을 보여줍니다. 자세한 내용은 DTW_ASSIGN을 참조하십시오.

예 3: 컬럼명을 정의하기 위한 HTML 테이블내의 Nn

%REPORT{
<H2>Product directory</H2>
<TABLE BORDER=1 CELLPADDING=3>
<TR><TD>$(N1)</TD><TD>$(N2)</TD><TD>$(N3)</TD>
%ROW{
<TR><TD>$(V1)</TD><TD>$(V2)</TD><TD>$(V3)</TD>
%}
</TABLE>
 
%}

NLIST

목적

함수 호출이나 조회의 결과로부터 얻어진 모든 컬럼명의 목록이 들어 있습니다. 생략시 분리문자는 공백입니다.

REPORT 및 ROW 블록에서 NLIST를 참조할 수 있습니다.

예

예 1: ALIGN을 사용한 컬럼명 목록

%DEFINE ALIGN="YES"
...
%FUNCTION (DTW_SQL) myfunc() {
select * from MyTable
  %report{
Your query was on these columns: $(NLIST).
%row {
...
%}
%}
%}

컬럼명 목록은 ALIGN을 YES로 지정하면 컬럼명 사이에 공백을 사용합니다.

예 2: 분리문자를 " | "로 변경하기 위한 %LIST 변수

%DEFINE %LIST " | " NLIST
...
%FUNCTION (DTW_SQL) myfunc() {
select * from MyTable
  %report{
Your query was on these columns: $(NLIST).
%row {
...
%}
%}
%}

NUM_COLUMNS

목적

report 블록에서 Net.Data가 처리되고 있는 테이블 컬럼의 번호. 컬럼은 함수 호출이나 조회에 의해 리턴됩니다.

REPORT 및 ROW 블록에서 NUM_COLUMNS를 참조할 수 있습니다.

예

예 1: NLIST에서 변수 참조로 사용되는 NUM_COLUMNS

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

NUM_ROWS

목적

REPORT 블록에서 Net.Data가 처리되는 테이블의 행 수. 행 수는 자료가 들어 있는 Net.Data 테이블에 정의된 upper limit 매개변수 값의 영향을 받습니다. 예를 들어 upper limit가 30으로 설정되었는데 SELECT 명령문이 1000 행을 리턴하는 경우, NUM_ROWS의 값은 30입니다. 또한, upper limit가 30으로 설정되었고 SELECT 명령문이 20행을 리턴하는 경우, NUM_ROWS는 20입니다. TABLE 명령문과 upper limit 매개변수에 대한 자세한 내용은 TABLE 명령문을 참조하십시오.

NUM_ROWS는 START_ROW_NUM이 언어 환경에 전달되지 않는 한 START_ROW_NUM 값의 영향을 받지 않습니다. 예를 들어 START_ROW_NUM이 5(웹 페이지에 표시되는 테이블이 5행에서 시작됨을 나타냄)로 설정되었고 SELECT 명령문이 25행을 리턴하는 경우, NUM_ROWS는 21이 아닌 25로 설정됩니다. 처음 4행은 테이블에서 없어지지만 NUM_ROWS의 값에 포함됩니다. 그러나 START_ROW_NUM이 환경 변수에 전달되면, NUM_ROWS에는 START_ROW_NUM이 지정한 행 이후의 행들만 포함됩니다. 위 예에서 NUM_ROWS는 21로 설정됩니다.

REPORT 및 ROW 블록에서 NUM_ROWS를 참조할 수 있습니다.

예

예 1: REPORT 블록에서 처리되고 있는 이름의 수를 표시합니다.

%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: $(NUM_ROWS)<BR>
Names found: $(TOTAL_ROWS)
%}

ROW_NUM

목적

Net.Data 테이블에서 행이 처리될 때마다 Net.Data가 값을 증가시키는 테이블 변수. 변수는 계수기로 작용하며 이의 값은 처리중인 현재 행의 번호입니다.

RPT_MAX_ROWS는 ROW_NUM의 값에 영향을 줄 수 있습니다. 예를 들어, 테이블에 100 행이 있고 RPT_MAX_ROWS를 20으로 설정하면 20행이 마지막으로 처리된 행이기 때문에 ROW_NUM의 최종 값은 20이 됩니다.

ROW 블록내에서만 ROW_NUM을 참조할 수 있습니다.

예

예 1: 테이블의 각 행에 레이블을 표시하기 위해 ROW_NUM을 사용하여 HTML 출력에 컬럼을 이식합니다.

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

REPORT 블록은 아래와 같은 테이블을 생성합니다.

TOTAL_ROWS

목적

TABLE 언어 구문에 대한 upper_limit 값에 관계없이 조회를 통해 리턴되는 총 행 수. 예를 들어, RPT_MAX_ROWS가 최대 20행을 표시하도록 설정되어 있는데 조회를 통해 100행이 리턴되면, 이 변수는 ROW 처리후에 100으로 설정됩니다.

운영 체제상의 차이:

• OS/400 운영 체제에서, 이 변수는 REPORT 또는 ROW 블록의 임의의 지점에서 참조할 수 있습니다.

• OS/390, OS/2, Windows NT 및 UNIX 운영 체제에서 이 변수는 REPORT 꼬리말에서만 참조할 수 있습니다.

언어 환경 제한사항: 다음의 데이타베이스 언어 환경에서만 이 변수를 사용하십시오.

• SQL

• ODBC

• Oracle

• Sybase

필수: 이 변수를 사용하려면 DTW_SET_TOTAL_ROWS를 YES로 설정해야 합니다. 자세한 내용은 DTW_SET_TOTAL_ROWS를 참조하십시오.

예

예 1: 발견된 총 행 수를 표시합니다.

%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 found: $(TOTAL_ROWS)
%}

V_columnName

목적

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

ROW 블록내에서만 V_columnName을 참조할 수 있습니다.

값

V_columnName

표 1. V_columnName 값

예

예 1: V_columnName을 변수 참조로 사용

%FUNCTION(DTW_SQL) myQuery() {
 SELECT NAME, ADDRESS from $(qtable)
%REPORT{
 
%ROW{
 
 Value of NAME column in row $(ROW_NUM) is $(V_NAME).<BR>
 %}
 %}
 %}

VLIST

목적

ROW 블록내에서 처리중인 현재 행의 모든 필드 값 목록.

ROW 블록내에서만 VLIST를 참조할 수 있습니다. 생략시 분리문자는 공백입니다.

예

예 1: list 태그를 사용하여 조회 결과 표시

%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)
%}
%}

Vn

목적

현재 행에 대해 지정된 컬럼 번호 n의 값.

ROW 블록내에서만 Vn을 참조할 수 있습니다.

Net.Data는 각 필드에 대한 변수를 테이블에 지정하고 그 변수를 변수 참조에 사용하여, 참조하고자 하는 필드의 번호를 지정합니다. 블록 외부에서 이 변수를 사용하려면, Vn의 값을 이전에 정의된 전역 변수나 OUT 또는 INOUT 함수 매개변수 값에 지정하십시오.

예

예 1: 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>
%}

두 번째 컬럼은 전자 메일 주소를 나타냅니다. 링크를 클릭하여 사용자에게 메세지를 송신할 수 있습니다.