UI 스크립트

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

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

    전역 UI 스크립트

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

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

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

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

    UI 스크립트 생성

    UI 스크립트를 생성하여 재사용 가능한 클라이언트 측 JavaScript 코드를 정의합니다.

    프로시저

    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 태그를 포함하고 매개변수를 name= UI 스크립트 이름 뒤에 .jsdbx 확장자로 지정합니다. 양식 뷰에 포매터를 추가합니다.

    이 코드를 사용하면 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 스크립트 호출Call a UI script from client-side code

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

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