UI 작업 생성

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기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 작업을 빨간색으로 채색합니다.
      • Unstyled(스타일 지정되지 않음) - UI 작업에 색상을 지정하지 않습니다.
      목록 배너 단추 목록의 배너에 버튼을 배치하는 옵션입니다.
      주:
      목록 배너 단추는 기록별 조건을 지원하기 위한 것이 아니므로 조건을 평가하여 목록에 단추를 표시할지 여부를 결정할 때 첫 번째 행만 고려됩니다. 목록 배너 버튼 UI 작업에서 기록별 조건(예: current.getValue('state') === 'closed')을 사용하지 마십시오.
      목록 아래쪽 단추 목록 하단에 버튼을 배치하는 옵션입니다.
      주:
      목록 아래쪽 버튼은 조건에 관계없이 표시되며 실행 시 기록별로 평가됩니다.
      목록 상황에 맞는 메뉴 목록 필드 컨텍스트 메뉴(목록에서 셀 오른쪽 클릭)에 항목을 넣는 옵션입니다.
      목록 선택 사항 목록 하단의 작업 선택 목록에 항목을 넣는 옵션입니다.
      주:
      목록 선택 작업과 같은 목록 아래쪽 버튼은 조건에 관계없이 표시되며 실행 시 기록별로 평가됩니다.
      목록 링크 목록 하단의 관련 링크 섹션에 링크를 넣는 옵션입니다.
      목록 스타일
      • 기본(Primary) - UI 작업을 파란색으로 채색합니다.
      • 파괴적(Destructive) - UI 작업을 빨간색으로 채색합니다.
      • Unstyled(스타일 지정되지 않음) - UI 작업에 색상을 지정하지 않습니다.
      무효화 이 UI 작업이 재정의하는 UI 작업입니다.
      메시지 UI 작업이 메시지 [sys_ui_message] 테이블에서 현지화된 대체 메시지를 조회하기 위한 키로 사용할 수 있는 텍스트 문자열입니다. 각 메시지 키는 메시지 필드의 별도 줄에 있습니다.

      인스턴스는 메시지 문자열이 메시지 필드의 키와 일치하는 getMessage(msg) 호출을 할 때마다 현지화된 메시지 문자열을 찾습니다.
      의견 이 UI 작업에 대한 설명 컨텐츠입니다.
      힌트 사용자가 UI 작업 컨트롤을 가리킬 때 나타나는 텍스트입니다.
      클릭 시 UI 작업이 실행될 때 실행할 JavaScript 함수의 이름입니다. 함수는 스크립트 필드에 정의되어 있습니다.
      조건 UI 동작이 나타나는 시기를 제한하는 JavaScript 조건문입니다. 조건은 항상 서버에서 실행됩니다.
      주:
      • 현재 객체는 목록 컨텍스트 메뉴의 조건에 사용할 수 없습니다. 목록 컨텍스트 메뉴 옵션을 선택하면 이러한 작업에 대한 current 사용이 무시됩니다.
      • 관련 목록 버튼에서 UI 작업 조건에 대한 상위 기록을 참조할 수 있습니다. 예를 들어, 종결된 변경에 대해 영향을 받는 CI 관련 목록에서 새로 만들기 및 편집 버튼을 비활성화하려면 전역 m2m UI 작업을 task_ci 테이블에 복사하고 조건을 parent.active추가합니다.
      • 조건문에 지정한 필드 중 하나를 비워 두면 해당 조건은 기본적으로 true로 설정됩니다.
      스크립트 UI 작업이 실행될 때 실행할 스크립트입니다. 함수 이름은 고유해야 합니다.
      작업 공간
      워크플레이스 양식 단추 작업 공간의 UI 작업 목록에 UI 작업을 표시시키는 옵션입니다.
      워크플레이스 양식 메뉴 워크플레이스의 UI 작업과 연결된 메뉴에 UI 작업을 목록 항목으로 표시시키는 옵션입니다.
      Configurable Workspace 포맷 구성 가능한 작업 공간에서 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 );