변수 정의 및 지정

템플리트를 디자인할 때 값을 계산하거나 데이터 속성을 일반적으로 사용할 수 없는 컨텍스트에서 데이터 속성을 사용할 수 있게 해야 할 수 있습니다. 이 경우 변수를 정의한 후 해당 변수에 값을 지정할 수 있습니다. 값은 정적 데이터이거나 현재 컨텍스트에서 사용 가능한 데이터가 될 수 있습니다.

이 태스크 정보

변수는 런타임 시 계산되는 데이터의 플레이스홀더(변수 지정)로 사용되거나 문서 스펙에서 제공될 수 있습니다. 데이터 속성과는 달리 변수는 마스터 페이지에서도 사용할 수 있습니다.
다음과 같은 두 가지 유형의 변수가 있습니다.
  • 사용자 정의 변수: 사용자 정의 변수는 템플리트 디자이너가 정의합니다. 사용자 정의 변수는 내부 변수 또는 외부 변수가 될 수 있습니다.
    • 내부 사용자 정의 변수: 계산을 수행하거나 정보(예: 데이터를 마스터 페이지로 가져오는 데 사용되는 변수)를 임시로 저장하려면 변수를 내부 변수로 지정하십시오. 내부 변수는 문서 스펙에 표시되지 않으므로 내부 변수에는 값을 제공할 수 없습니다.
    • 외부 사용자 정의 변수: 변수에 값을 제공하는 경우 변수를 외부 변수로 지정하십시오. 외부 변수는 문서 스펙에 표시됩니다. 문서 스펙 작성을 참조하십시오.
  • Rational® Publishing Engine 변수: Rational Publishing Engine 변수는 문서 템플리트에서 사용할 수 있는 내부 변수입니다.
    표 1. Rational Publishing Engine 내부 변수
    변수 설명
    _cell_number 현재 행에서의 셀 번호입니다. 요소가 셀이 아니면 이 값은 0입니다. 데이터 표현식 또는 스크립트 표현식 탭에서 _cell_number를 사용할 수 있습니다.
    _element_id 템플리트 내의 요소 번호입니다. 템플리트에 내부적으로 보관되며 디버깅을 위해 사용됩니다. 데이터 표현식 또는 스크립트 표현식 탭에서 _element_id를 사용할 수 있습니다.
    _element_level 요소의 순환 레벨입니다. 데이터 탭에서 순환 레벨 특성의 요소에 설정된 값이 없는 경우 이 값은 1입니다. 데이터 표현식 또는 스크립트 표현식 탭에서 _element_level을 사용할 수 있습니다.
    _row_number 현재 테이블에서의 행 번호입니다. 요소가 행 요소에 의해 포함되지 않은 경우 이 값은 0입니다. 데이터 표현식 또는 스크립트 표현식 탭에서 _row_number를 사용할 수 있습니다.
    _sessionInfo 템플리트 또는 문서 스펙의 런타임 특성 정보입니다. 스크립트 표현식 탭에서 _sessionInfo 변수를 선택하고 스크립트를 입력하십시오. 내부에서 값이 없는 빈 인용 부호를 사용하여 출력에서 특성에 대한 기본값을 생성하십시오. 스크립트 예:

    _sessionInfo.getDocspecProperty("property", "");
    _sessionInfo.getTemplateProperty("property", "");
    _sessionInfo.getDatasourceProperty("data_source_name","property", "");
    _sessionInfo.getOutputProperty("output_type","property", "");
    _sessionInfo.docspecVersion
    _sessionInfo.templateVersion
    _sessionInfo.engineVersion
    _sessionInfo.buildNumber

    getDocspecProperty의 경우 기존 문서 스펙 특성 또는 사용자 정의 메타데이터 특성을 사용할 수 있습니다.

    _sessionLogger 디버깅 목적으로 TEMP\rpe\rpe.log 파일, 콘솔 보기 또는 문제점 보기에 사용자 정의된 정보, 오류, 경고 또는 디버그 메시지를 표시할 수 있습니다. 메시지는 log4j.properties 파일에 정의된 위치에 표시됩니다.

    기본 설정은 rpe.log 파일이 아니라 콘솔 보기에 정보 메시지를 표시하는 것입니다.

    스크립트 표현식 탭에서 _sessionLogger 변수를 선택하고 스크립트를 입력하십시오. 다음 방법 중 하나를 사용하여 로그 항목을 생성할 수 있습니다.
    1. _sessionLogger.debug(message)
    2. _sessionLogger.info(message)
    3. _sessionLogger.error(message)
    4. _sessionLogger.warn(message)

    스크립트에 message로 입력할 내용을 결정할 때 의미 있는 메시지를 작성하기 위해 템플리트의 변수 사용과 이니셜 또는 사용자 이름과 같은 시각적 콜아웃 사용을 고려하십시오.

    _sessionUtils 스크립트 표현식 탭에서 이 변수를 사용하여 tidyXHTML이라는 스크립트에서 기능을 실행할 수 있습니다. 이 변수는 부적절한 XHTML 코딩으로 작성된 출력에서 공백 블록을 발견한 경우 유용합니다. _sessionUtils 변수를 사용하면 문자열 인수가 처리되고 XHTML이 정리되어 추가 공백이 출력에 표시되지 않습니다.

    예: _sessionUtils.tidyXHTML(text);

    _sessionUtils 변수를 사용하는 경우 스크립트 표현식 탭에서 XHTML 입력XHTML 출력 옵션도 선택하십시오.
    참고: 이 변수를 포함하는 템플리트는 이전 버전의 Rational Publishing Engine으로 로드될 수 있습니다.

프로시저

  1. 아웃라인 보기에서 변수 > 삽입 > 새 변수를 클릭하십시오. 새 변수 창이 열립니다.
  2. 다음 필드에 변수 세부사항을 입력하십시오.
    1. 이름: 변수의 이름을 입력하십시오. 변수 이름이 스크립트에서 사용되므로 유효한 Java™ 또는 JavaScript ID를 사용해야 합니다.JavaScript ID에 대한 규칙:
      • 문자, 밑줄(_) 또는 달러 기호($)로 시작해야 합니다.
      • 후속 문자는 숫자(0-9)일 수 있습니다.
      • 문자는 대소문자를 구분합니다.
      • ISO 8859-1 또는 유니코드 문자(예: å 또는 ü)를 사용할 수 있습니다.
      • \uXXXX 유니코드 이스케이프 순서를 문자로 사용할 수 있습니다.
    2. 설명: 변수에 대한 설명을 입력하십시오.
    3. 기본값: 변수의 값을 입력하십시오.
    4. 액세스: 목록에서 변수가 내부 변수인지 아니면 외부 변수인지 선택하십시오.
      • 내부 변수는 문서 스펙에 표시되지 않으므로 내부 변수에는 값을 제공할 수 없습니다.
      • 외부 변수는 문서 스펙에 표시되므로 외부 변수에 값을 제공할 수 있습니다.
  3. 요소에 변수를 지정하려면 다음을 수행하십시오.
    팁: 가능할 때마다 컨테이너 요소에 변수를 지정하십시오. 변수는 컨테이너 요소 내 요소에 적용됩니다. 예를 들어, 각 변수에 대해 하나의 새 행이 작성되도록 하나의 테이블 내에서 하나의 변수를 사용할 수 있습니다. 테이블 요소에 하나의 변수를 지정하면 각 변수에 대해 하나의 테이블이 작성됩니다. 이 연속 테이블은 병합되는 경우도 있지만 별도의 테이블로 표시되는 경우도 있습니다. 테이블 내에 컨테이너 요소를 추가한 후 행을 컨테이너 요소로 끌어온 다음 변수를 컨테이너 요소에 지정하면 각 변수에 대한 행이 포함된 단일 테이블이 작성됩니다.
    컨테이너 요소가 포함된 테이블 요소. 컨테이너 요소 내부에
세 개의 셀 요소가 포함된 행 요소가 있습니다.
    1. 요소를 마우스 오른쪽 단추로 클릭한 후 데이터 > 지정 편집을 클릭하십시오. 지정 편집기 창이 열립니다.
    2. 추가를 클릭하십시오. 변수 선택 창이 열립니다.
    3. 변수의 이름을 입력한 후 확인을 클릭하십시오.
    4. 지정 편집기 창에서 확인을 클릭하십시오.

결과

선택한 변수가 정의되어 현재 요소에 지정됩니다.

요소에 변수를 지정하면 해당 요소는 변수 지정 아이콘 아이콘을 템플리트 컨텐츠 편집기에 표시합니다.

조회 및 변수 지정이 포함된 단락 요소

다음에 수행할 작업

팁: 변수가 지정되는 요소를 마우스 오른쪽 단추로 클릭한 후 검색 > 요소의 변수 참조사항을 선택하여 요소에서 사용되는 변수 지정 목록을 검색할 수 있습니다. 검색 보기가 열리고 변수 지정 목록이 표시됩니다. 결과에서 변수 지정을 두 번 클릭하여 편집할 수 있습니다.

요소를 마우스 오른쪽 단추로 클릭한 후 검색 > 요소의 모든 참조사항을 선택하여 요소에서 사용되는 변수 지정, 속성 및 조회의 목록을 검색할 수 있습니다. 검색 보기가 열리고 목록이 표시됩니다. 결과에서 항목을 두 번 클릭하여 편집할 수 있습니다.


피드백