UI 작업 생성

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 5분

    • 새 UI 작업을 만들거나 기존 작업을 편집할 수 있습니다.

    시작하기 전에

    필요한 역할: ui_action_admin 또는 admin

    이 태스크 정보

    UI 작업과 동일한 범위에 있는 테이블 및 데이터베이스 뷰와 다른 애플리케이션 범위의 UI 작업을 실행할 수 있는 테이블에 UI 작업을 추가할 수 있습니다.

    프로시저

    1. 다음으로 이동 모두 > 시스템 정의 > UI 작업.
    2. 새로 만들기를 클릭하거나 기존 기록을 엽니다.
    3. 필드를 완료하여 UI 작업을 정의합니다.
      모든 필드를 볼 수 있도록 양식을 구성해야 할 수 있습니다.
      표 1. UI 작업 필드
      필드 설명
      이름 버튼, 링크 또는 컨텍스트 메뉴 항목에 나타나는 텍스트입니다.
      테이블 UI 작업을 사용할 수 있는 테이블입니다. 기본적으로 UI 동작은 선택한 테이블을 확장하는 테이블에도 표시됩니다(예: 작업 동작은 인시던트 테이블에 나타남).

      모든 테이블에서 작업을 사용할 수 있도록 하려면 전역 을 선택합니다.
      순서 UI 작업이 나타나는 순서입니다. 순서는 버튼에 왼쪽에서 오른쪽으로, 메뉴 작업에 위에서 아래로 적용됩니다.
      작업 이름 스크립트에서 UI 작업을 참조할 때 사용할 고유한 이름입니다.
      활성 선택 시 UI 작업을 활성화하는 옵션입니다. UI 작업을 비활성화하려면 확인란의 선택을 취소합니다.
      삽입 표시 삽입되지 않은 새 기록에 단추를 표시하는 옵션입니다.
      업데이트 표시 기존 기록에 단추를 표시하는 옵션입니다.
      클라이언트 서버가 아닌 사용자의 브라우저에서 스크립트를 실행하는 UI 작업에 대한 옵션입니다. 활성화하면 Onclick 필드가 조건 필드 위에 나타납니다.
      양식 단추 양식에 단추를 추가하는 옵션입니다.
      양식 상황에 맞는 메뉴 양식 컨텍스트 메뉴에 항목을 배치하는 옵션입니다(양식 헤더 오른쪽 클릭).
      양식 링크 양식의 관련 링크 섹션에 링크를 추가하는 옵션입니다.
      양식 스타일
      • 기본(Primary) - UI 작업을 파란색으로 지정합니다.
      • 파괴적(Destructive) - UI 작업을 빨간색으로 지정합니다.
      • 스타일 지정되지 않음 - UI 작업에 색을 지정하지 않습니다.
      목록 배너 단추 목록의 배너에 단추를 넣는 옵션입니다.
      주:
      목록 배너 단추는 기록별 조건을 지원하기 위한 것이 아니므로 조건을 평가할 때 첫 번째 행만 고려하여 목록에 단추가 표시될지 여부를 결정합니다. 목록 배너 버튼 UI 작업에는 기록별 조건(예: current.getValue('state') === 'closed')을 사용하지 마십시오.
      목록 아래쪽 단추 목록 하단에 단추를 배치하는 옵션입니다.
      주:
      목록 아래쪽 버튼은 조건에 관계없이 표시되며 실행 시 기록별로 평가됩니다.
      목록 상황에 맞는 메뉴 목록 필드 컨텍스트 메뉴에 항목을 배치하는 옵션입니다(목록에서 셀 오른쪽 클릭).
      목록 선택 사항 목록 하단의 작업 선택 목록에 항목을 추가하는 옵션입니다.
      주:
      목록 선택 작업과 같은 목록 하단 버튼은 조건에 관계없이 표시되며 실행 시 기록별로 평가됩니다.
      목록 링크 목록 하단의 관련 링크 섹션에 링크를 추가하는 옵션입니다.
      목록 스타일
      • 기본(Primary) - UI 작업을 파란색으로 지정합니다.
      • 파괴적(Destructive) - UI 작업을 빨간색으로 지정합니다.
      • 스타일 지정되지 않음 - UI 작업에 색을 지정하지 않습니다.
      재정의 이 UI 작업이 재정의하는 UI 작업입니다.
      메시지 UI 작업이 메시지 [sys_ui_message] 테이블에서 지역화된 대체 메시지를 조회하기 위한 키로 사용할 수 있는 텍스트 문자열입니다. 각 메시지 키는 메시지 필드에서 별도의 줄에 있습니다.

      인스턴스는 UI 작업에서 msg 문자열이 메시지 필드의 키와 일치하는 getMessage(msg) 호출을 수행할 때마다 현지화된 메시지 문자열을 찾습니다.
      설명 이 UI 작업에 대한 설명이 포함된 컨텐츠입니다.
      힌트 사용자가 UI 작업 컨트롤을 가리킬 때 나타나는 텍스트입니다.
      클릭시 UI 작업이 실행될 때 실행할 JavaScript 함수의 이름입니다. 함수는 스크립트 필드에 정의되어 있습니다.
      조건 UI 작업이 나타나는 시기를 제한하는 JavaScript 조건문입니다. 조건은 항상 서버에서 실행됩니다.
      주:
      • 현재 객체는 목록 컨텍스트 메뉴의 조건에 사용할 수 없습니다. 목록 컨텍스트 메뉴 옵션을 선택하면 이러한 작업에 대한 current 모든 사용이 무시됩니다.
      • 관련 목록 버튼에서 UI 작업 조건의 상위 기록을 참조할 수 있습니다. 예를 들어, 종결된 변경에 대한 영향을 받는 CI 관련 목록에서 새로 만들기 및 편집 버튼을 비활성화하려면 글로벌 m2m UI 작업을 task_ci 테이블에 복사하고 parent.active.
      • 조건문에 지정한 필드 중 하나를 비워 두면 해당 조건이 기본적으로 true로 설정됩니다.
      스크립트 UI 작업이 실행될 때 실행할 스크립트입니다. 함수 이름은 고유해야 합니다.
      작업 공간
      작업 공간 양식 단추 작업 공간의 UI 작업 목록에 UI 작업을 표시하는 옵션입니다.
      작업 공간 양식 메뉴 작업 공간의 UI 작업과 연결된 메뉴에서 UI 작업을 목록 항목으로 표시하는 옵션입니다.
      구성 가능 작업 공간 포맷 구성 가능한 작업 공간에서 UI 작업을 사용하는 옵션입니다. 선택하지 않으면 UI 작업이 레거시 작업 공간에 적용됩니다.
      작업 공간 클라이언트 스크립트 작업 공간에서 UI 작업이 실행될 때 실행할 스크립트입니다.
      역할 필요
      역할 UI 작업을 적용하는 데 필요한 역할입니다. UI 작업을 적용하려면 사용자에게 하나 이상의 역할이 있어야 합니다.
      양식 뷰의 관련 목록
      UI 작업 표시 여부 UI 작업이 적용되는 양식의 뷰입니다. 이 옵션을 사용하여 UI 작업을 지정한 양식 뷰로 제한합니다. 다음 규칙에 따라 지정된 뷰에 대해 UI 작업을 사용할 수 있습니다.
      1. 가시성 규칙이 없으면 작업이 모든 뷰에 나타납니다.
      2. 지정된 뷰에 대한 제외 규칙은 해당 뷰에 작업이 표시되지 않음을 의미합니다.
      3. 하나 이상의 포함 규칙이 있는 경우 작업은 구체적으로 포함된 뷰에만 나타납니다.
      버전 UI 작업의 모든 버전입니다. 이 목록을 사용하여 버전을 비교하거나 이전 버전으로 되돌릴 수 있습니다.
    4. 제출 또는 업데이트를 클릭합니다.
      주:
      UI 작업이 클라이언트 측에서 실행되도록 설정된 경우 함수로 래핑합니다. 그렇지 않으면 페이지가 로드될 때 스크립트 필드의 내용이 실행됩니다.

    예

    UI 작업 스크립트의 일부로 사용자를 URL로 리디렉션할 수 있습니다. 예를 들어, UI 작업에서 양식을 만든 후 양식에 대한 링크를 추가하거나 새 기록을 열 수 있습니다. 사용자를 UI 작업에서 URL로 리디렉션하려면 스크립트 필드에서 다음 구문을 사용하여 리디렉션 링크를 정의합니다.
    action.setRedirectURL ( 'http://www.mysite.com/mypage.htm' );
    사용자를 기록으로 안내하려면 다음 구문을 사용하십시오. 여기서 new_record 는 GlideRecord의 변수 이름입니다.
    action.setRedirectURL (new_record );