UI 스크립트

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기3분
  • UI 스크립트는 스크립트에 포함된 저장소 서버측 JavaScript와 유사하게 클라이언트측 JavaScript를 재사용 가능한 양식으로 패키지화하는 방법을 제공합니다. 관리자는 UI 스크립트를 작성하고 클라이언트 스크립트 및 기타 클라이언트측 스크립트 객체와 HTML 코드에서 실행할 수 있습니다.

    UI 스크립트는 모바일에서 지원되지 않습니다.

    전역 UI 스크립트

    UI 스크립트를 생성하고 전역으로 지정하여 시스템의 모든 양식에서 스크립트를 사용할 수 있도록 할 수 있습니다. 범위가 지정된 애플리케이션에서는 전역 UI 스크립트를 만들 수 없습니다.

    UI 스크립트를 전역으로 표시하여 시스템의 모든 양식에서 사용할 수 있습니다. 예를 들어 helloWorld() 함수가 있고 전역 필드가 선택되어 있는 UI 스크립트를 만들 수 있습니다.

    function helloWorld() {
      alert('Hi');
    }

    이 전역 UI 스크립트를 만든 후에는 작성하는 클라이언트 스크립트 또는 UI 정책에서 helloWorld() 함수를 호출할 수 있습니다.

    UI 스크립트 생성

    재사용 가능한 클라이언트 측 JavaScript 코드를 정의하는 UI 스크립트를 만듭니다.

    프로시저

    UI 스크립트를 작성하려면 다음으로 이동하십시오. 시스템 UI > UI 스크립트 기록을 생성하거나 편집합니다(필드 설명은 표 참조).
    표 1. UI 스크립트
    필드 설명
    스크립트 이름 UI 스크립트의 이름입니다. 시스템에서 이름이 고유한지 확인합니다.
    API 이름 범위 및 스크립트 이름을 포함한 UI 스크립트의 API 이름(예: x_custom_app. HelloWorld).
    애플리케이션 UI 스크립트가 포함된 애플리케이션입니다.
    활성 UI 스크립트가 활성 상태인지 여부를 나타내는 표시기입니다. 활성 UI 스크립트만 실행할 수 있습니다.
    전역

    스크립트가 시스템의 모든 페이지에 로드되는지 여부를 나타내는 표시기입니다.

    주:
    성능에 영향을 줄 수 있으므로 전역 UI 스크립트를 생성할 때는 주의하십시오. 범위가 지정된 애플리케이션에서는 전역 UI 스크립트를 만들 수 없습니다.
    설명 스크립트의 목적에 대한 요약입니다.
    스크립트 다른 스크립트에서 호출될 때 실행할 클라이언트 측 스크립트입니다.

    UI 스크립트 실행

    UI 스크립트를 실행할 때 다음 지침을 따르십시오.

    양식에서 UI 스크립트 실행

    양식에서 UI 스크립트를 실행하려면 포매터를 생성하여 양식에 추가하십시오. 연결된 UI 매크로g:requires 태그를 포함하고 매개 변수를 UI 스크립트의 이름 뒤에 .jsdbx 확장명으로 지정합니다 name= . 양식 뷰에 포매터를 추가합니다.

    이 코드는 UI 스크립트의 정의와 결과를 브라우저에서 즉시 사용할 수 있도록 합니다.

    <?xml version="1.0" encoding="utf-8" ?>  
    <j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">  
        <g2:evaluate var="jvar_stamp">  
            var now_GR = new GlideRecord('sys_ui_script');  
            gr.orderByDesc('sys_updated_on');  
            gr.query();  
            gr.next();  
            gr.getValue('sys_updated_on');  
        </g2:evaluate>  
        <g:requires name="<UI SCRIPT NAME>.jsdbx" params="cache=$[jvar_stamp]" />  
    </j:jelly>

    HTML로 UI 스크립트 호출

    HTML 코드에서 UI 스크립트를 실행하려면 ]]> 태그를 사용하고<![CDATA[<script>src= 인수를 UI 스크립트의 API 이름과 .jsdbx 확장자로 지정합니다. 예를 들어 다음 코드와 함께 CoolClock 이라는 UI 스크립트를 포함합니다.

    <script language="javascript" src="CoolClock.jsdbx" />

    클라이언트 측 코드에서 UI 스크립트 호출

    g_ui_scripts 전역 객체를 사용하여 클라이언트 측 코드 내에서 UI 스크립트에 액세스합니다. 자세한 내용은 다음을 참조하십시오. GlideUIScript -클라이언트.

    주:
    이 클래스는 전역 필드가 true로 설정된 UI 스크립트를 지원하지 않습니다.