참조서

Net.Data 보고서 변수

이 변수를 사용하여 보고서를 조정할 수 있습니다. 각 변수에는 기본값이 있습니다. 변수에 새로운 값을 할당하여 기본값을 겹쳐쓸 수 있습니다.

• ALIGN
• DTW_DEFAULT_REPORT
• DTW_HTML_TABLE
• RPT_MAX_ROWS
• START_ROW_NUM

ALIGN

목적

테이블 처리 변수 NLIST 및 VLIST에 사용되는 선행 및 후미 공백을 제어합니다.

성능 향상: ALIGN을 사용하면, Net.Data는 채움 요건을 계산하기 위해 테이블의 모든 컬럼에 대한 최대 컬럼 길이를 파악해야 하므로 필요할 경우에만 ALIGN을 사용하십시오. 이 프로세스는 성능에 영향을 줄 수 있습니다.

YES로 설정되면, ALIGN은 표시장치에 맞춰 테이블 처리 변수를 조정하기 위해 채움 공간을 제공합니다. HTML 링크나 양식 조치에 조회 결과를 내포시키려면, 생략시 값인 NO를 사용하여 Net.Data가 보고서 변수 주변에 선행 및 후미 공백을 두지 않도록 하십시오.

DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

값

ALIGN="YES"|"NO"

표 2. ALIGN 값

예

예 1: ALIGN 변수를 사용하여 공백으로 각 컬럼을 분리

%DEFINE ALIGN="YES"
<P>Your query was on these columns: $(NLIST)

DTW_DEFAULT_REPORT

목적

Net.Data가 REPORT 블록이 없는 함수에 대해 생략시 보고서를 생성할지 여부를 결정합니다. 이 변수가 YES로 설정되면, Net.Data는 생략시 보고서를 생성합니다. NO로 설정되면, Net.Data는 생략시 보고서를 생성하지 않습니다. 테이블 변수로 함수 호출의 결과를 수신하고 그 결과를 다른 함수에 전달하여 처리하는 경우, 이와 같이 생략시 보고서를 생성하지 않는 것이 좋습니다.

DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

값

DTW_DEFAULT_REPORT="YES"|"NO"|"MULTIPLE"

표 3. DTW_DEFAULT_REPORT 값

예

예 1: Net.Data가 생성한 생략시 보고서 대체

%DEFINE DTW_DEFAULT_REPORT="NO"

DTW_HTML_TABLE

목적

텍스트 유형 형식으로 테이블을 표시하는 대신 결과를 HTML 테이블로 표시합니다(즉, PRE 태그 대신 TABLE 태그를 사용).

생성된 TABLE 태그에는 경계와 셀 패딩 스펙이 포함되어 있습니다.

<TABLE BORDER CELLPADDING=2>

DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

값

DTW_HTML_TABLE="YES"|"NO"

표 4. DTW_HTML_TABLE 값

예

예 1: HTML 태그를 사용하여 SQL 함수의 결과를 표시합니다.

%DEFINE DTW_HTML_TABLE="YES"
 
%FUNCTION(DTW_SQL){
SELECT NAME, ADDRESS FROM $(qTable)
%}

RPT_MAX_ROWS

목적

테이블에서 함수 REPORT 블록이나 REPORT 블록이 지정되지 않은 경우에는 기본 보고서의 생성 중에 처리되는 테이블 안에서 행의 수를 지정합니다.

데이타베이스 언어 환경은 이 변수를 사용하여 리턴되는 행의 수를 제한하므로 결과 세트가 큰 경우에 성능을 상당히 향상시킵니다. 결과 세트가 큰 조회들을 각각 자체의 HTML 페이지에 위치하는 보다 작은 테이블들로 나누려면, 이 변수를 START_ROW_NUM과 함께 사용하십시오.

OS/400, Windows NT, OS/2 및 UNIX 사용자: 이 변수를 언어 환경으로 전달하려면, Net.Data 초기화 파일에 있는 데이타베이스 언어 환경의 ENVIRONMENT 명령문에 IN 매개변수로 포함시키십시오. 데이타베이스 언어 환경 명령문에 대해 자세히 알려면, 운영 체제에 대한 Net.Data 관리 및 프로그래밍 안내서의 구성 장을 참조하십시오.

OS/390 사용자: RPT_MAX_ROWS는 매크로에 정의될 때 데이타베이스 언어 환경에 내재적으로 전달됩니다.

DEFINE 명령문이나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

값

RPT_MAX_ROWS="ALL"|"0"|"number"

표 5. RPT_MAX_ROWS 값

예

예 1: DEFINE 명령문에 RPT_MAX_ROWS를 정의합니다.

%DEFINE RPT_MAX_ROWS="20"

위의 방법은 함수가 리턴하는 행의 수를 20행으로 제한합니다.

예 2: HTML 입력을 사용하여 HTML 양식으로 변수를 정의합니다.

Maximum rows to return (0 for no limit):
<INPUT TYPE="text" NAME="RPT_MAX_ROWS" SIZE=3>

위의 예에 있는 행들은 FORM 태그에 배치되어 응용프로그램 사용자가 조회를 통해 리턴하고자 하는 행의 수를 설정할 수 있도록 합니다.

START_ROW_NUM

목적

테이블에서 함수 REPORT 블록이나 REPORT 블록이 지정되지 않은 경우에는 기본 보고서의 생성 중에 처리되는 시작 행 수를 지정합니다.

데이타베이스 언어 환경은 처리하기 위해 이 변수를 사용하여 결과 세트에서 시작 행을 판별합니다. 큰 결과 세트의 경우에 성능을 상당히 향상시키려면, 이 변수를 RPT_MAX_ROWS와 함께 사용하여 큰 결과 세트가 있는 조회들을 보다 작은 테이블로 나누십시오.

OS/400, Windows NT, OS/2 및 UNIX 사용자: 이 변수를 언어 환경으로 전달하려면, Net.Data 초기화 파일에 있는 데이타베이스 언어 환경의 ENVIRONMENT 명령문에 IN 매개변수로 포함시키십시오. 데이타베이스 언어 환경 명령문에 대해 자세히 알려면, 운영 체제에 대한 Net.Data 관리 및 프로그래밍 안내서의 구성 장을 참조하십시오.

OS/390 사용자: START_ROW_NUM은 매크로에 정의될 때 데이타베이스 언어 환경에 내재적으로 전달됩니다.

DEFINE문을 사용하거나 @DTW_ASSIGN() 함수를 사용하여 이 변수의 값을 지정하십시오.

값

START_ROW_NUM="number"

표 6. START_ROW_NUM 값

예

예 1: 다음 및 이전 버튼으로 HTML 양식 화면이동

%define {
  DTW_HTML_TABLE      = "YES"
  START_ROW_NUM       = "1"
  RPT_MAX_ROWS        = "10"
  totalSize           = ""
  includeNext         = "YES"
  includePrev         = "YES"
  includeLast         = "YES"
  includeFirst        = "YES"
%}
 
%function(DTW_SQL) myQuery(){
  select * from NETDATADEV.CUSTOMER
%}
 
%function(DTW_SQL) count(OUT size){
  select count(*) from NETDATADEV.CUSTOMER
  %report{
    %row{
      @DTW_ASSIGN(size,V1)
    %}
  %}
%}
 
%html(report) {
  %{ get the total number of records if we haven't already %}
  %if (totalSize == "")
    @count(totalSize)
%endif
 
  %{ set START_ROW_NUM based on the button user clicked %}
  %if (totalSize <= RPT_MAX_ROWS)
    %{ there's only one page of data %}
    @DTW_ASSIGN(START_ROW_NUM, "1")
    @DTW_ASSIGN(includeFirst, "NO")
      @DTW_ASSIGN(includeLast, "NO")
    @DTW_ASSIGN(includeNext, "NO")
    @DTW_ASSIGN(includePrev, "NO")
  %elif (submit == "First Page" || submit == "")
    %{ first time through or user selected "First Page" button %}
    @DTW_ASSIGN(START_ROW_NUM, "1")
    @DTW_ASSIGN(includePrev, "NO")
    @DTW_ASSIGN(includeFirst, "NO")
  %elif (submit == "Last Page")
    %{ user selected "Last Page" button %}
    @DTW_SUBTRACT(totalSize, RPT_MAX_ROWS, START_ROW_NUM)
    @DTW_ADD(START_ROW_NUM, "1", START_ROW_NUM)
      @DTW_ASSIGN(includeLast, "NO")
    @DTW_ASSIGN(includeNext, "NO")
  %elif (submit == "Next")
    %{ user selected "Next" button %}
    @DTW_ADD(START_ROW_NUM, RPT_MAX_ROWS, START_ROW_NUM)
    %if (@DTW_rADD(START_ROW_NUM, RPT_MAX_ROWS) > totalSize)
      @DTW_ASSIGN(includeNext,"NO")
      @DTW_ASSIGN(includeLast, "NO")
%endif
  %elif (submit == "Previous")
    %{ user selected "Previous" button %}
    @DTW_SUBTRACT(START_ROW_NUM, RPT_MAX_ROWS, START_ROW_NUM)
    %if (START_ROW_NUM <= "1" )
      @DTW_ASSIGN(START_ROW_NUM,"1")
      @DTW_ASSIGN(includePrev,"NO")
      @DTW_ASSIGN(includeFirst,"NO")
%endif
%endif
 
  %{ run the query to get the data %}
  @myQuery()
 
  %{ output the correct buttons at the bottom of the report %}
  <center>
  <form method="POST" action="report">
  <input name="START_ROW_NUM" type="hidden" value="$(START_ROW_NUM)">
  <input name="totalSize" type="hidden" value="$(totalSize)">
  %if (includeFirst == "YES" )
  <input name="submit" type="submit" value="First Page">
%endif
  %if (includePrev == "YES" )
  <input name="submit" type="submit" value="Previous">
%endif
  %if (includeNext == "YES" )
  <input name="submit" type="submit" value="Next">
%endif
  %if (includeLast == "YES" )
  <input name="submit" type="submit" value="Last Page">
%endif
</form>
  </center>
%}