독립 실행형 클라이언트 메서드

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 4분
  • 독립 실행형 클라이언트 메서드는 reflistOpen과 같은 클라이언트 JavaScript 내에서 사용할 수 있는 메서드이지만 클래스나 API의 일부는 아닙니다.

    사용하기 전에 생성자나 다른 유형의 인스턴스화 없이 클라이언트 스크립트 내에서 이러한 메서드에 직접 액세스할 수 있습니다.

    독립 실행형 - reflistOpen (String target, String elementName, String refTableName, String dependent, String useQBE, String refQualElements, String additionalQual, String parentID, String forceReference, String ignoreTargetValue)

    표준 팝업 창에 참조 필드 데이터를 표시합니다. 이 방법은 일반적으로 UI 16 양식에서 참조 필드 옆에 있는 돋보기 아이콘을 선택할 때 사용됩니다.

    예를 들어, 이 방법을 사용하면 다음과 같이 특정 쿼리 기준 세트에 대한 참조 필드 데이터를 표시할 수 있습니다.

    팝업 창의 참조 데이터

    마찬가지로 이 방법을 사용하여 사용자가 표시할 참조 필드 데이터를 선택하기 위한 고유한 쿼리 기준 집합을 입력할 수 있는 검색 양식을 표시할 수 있습니다.

    팝업 창에서 검색

    표준 팝업에서 URL을 열 때 URL 길이가 TinyURL 길이(기본적으로 1024)보다 크면 URL은 다음과 같이 TinyURL로 변환됩니다.

    "sys_user_list.do?sysparm_tiny=7ea02c4ff8a8b510f877c74d78b60460"입니다.

    주:

    reflistOpen() 은 작업 공간 클라이언트 스크립트에서 지원되지 않습니다. 대신 g_modal.showFrame() 메서드를 사용합니다.

    표 1. 매개변수
    이름 유형 설명
    대상 문자열 양식 대상 참조 필드 ID입니다.

    예를 들어 caller_id 매개변수의 대상 참조 필드 ID는 incident.caller_id입니다.

    elementName 문자열 양식 참조 필드 요소 이름입니다.

    예: caller_id

    refTableName 문자열 양식 참조 필드에 매핑할 참조 테이블입니다.

    예를 들어 참조 필드 caller_id의 경우 sys_user 참조 테이블입니다. 이 경우 sys_user 값을 전달합니다.

    종속의 문자열 지정된 target 요소에 대해 구성된 종속 필드입니다.

    자세한 내용은 Make a field dependent 문서를 참조하십시오.

    큐베 사용 문자열 팝업 창에서 반환할 정보의 유형을 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 검색 버튼이 있는 쿼리 양식을 표시합니다.
    • false: 쿼리 결과를 표시합니다.

    기본값: false

    refQualElements 문자열 지정된 target 요소에 대해 구성된 참조 한정자입니다. 이 함수는 지정된 참조 한정자를 URL에 추가하고 필터링된 결과만 팝업 창에 표시합니다. 참조 한정자를 포함하지 않으려면 빈 문자열을 전달합니다.

    참조 한정자에 대한 자세한 내용은 다음 문서를 참조하십시오 Reference qualifiers.

    additionalQual 문자열 옵션입니다. 팝업 창에 표시되는 결과를 필터링하는 데 사용할 추가 한정자 쿼리입니다.

    예를 들어 인시던트의 caller_id 참조 필드의 경우 사용자의 sys_id sys_id=62826bf03710200044e0bfc8bcbe5df1을 전달할 수 있습니다.

    이 함수는 사용자 [sys_user] 테이블을 필터링하고 필터링된 결과를 팝업 창에 표시합니다.
    상위 ID 문자열 옵션입니다. 현재는 내부 매개변수만 있으므로 값을 전달할 필요가 없습니다.
    forceReference 문자열 옵션입니다. 현재는 내부 매개변수만 있으므로 값을 전달할 필요가 없습니다.
    ignoreTargetValue 문자열 옵션입니다. 현재는 내부 매개변수만 있으므로 값을 전달할 필요가 없습니다.
    표 2. 반환
    유형 설명
    팝업 창 반환된 참조 필드 데이터를 표준 팝업 창에 표시합니다.

    다음 예제에서는 이 메서드를 호출하여 인시던트 테이블(위의 첫 번째 이미지)에 대한 팝업 창에 호출자 필드 데이터를 표시하는 방법을 보여 줍니다.

    function onChange(control, oldValue, newValue, isLoading, isTemplate) {
       if (isLoading || newValue === '') {
          return;
       }
    
       reflistOpen('incident.caller_id', 'caller_id', 'sys_user','company', 'false', '');
    }

    다음 예제에서는 동일한 클라이언트 스크립트를 호출하는 방법을 보여 주지만 useQBE = true를 사용하여 팝업 창(위의 두 번째 이미지) 내에 검색 단추와 연결된 검색 조건을 표시합니다.

    function onChange(control, oldValue, newValue, isLoading, isTemplate) {
       if (isLoading || newValue === '') {
          return;
       }
    
       //  Type appropriate comment here, and begin script below
       reflistOpen('incident.caller_id', 'caller_id', 'sys_user','company', 'true', '');
    }