UI 확장점 생성 및 추가

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기3분
  • 애플리케이션을 개발할 때 UI 확장점을 생성하여 HTML 확장과 같은 서버측 UI 매크로 또는 기본 애플리케이션 코드의 UI 페이지에 추가합니다.

    UI 확장점을 사용하여 데이터나 객체를 등록된 사용자 지정 UI 매크로로 보낼 수 있고 반환된 결과가 처리되는 특정 위치를 지정합니다.

    UI 확장점 생성

    애플리케이션 코드의 UI 매크로(예: HTML 확장)에 배치할 수 있는 UI 확장점을 만듭니다. UI 확장점을 배치하면 데이터 또는 개체를 커스터마이제이션으로 보낼 수 있고 데이터가 반환되는 애플리케이션 코드의 특정 위치를 지정할 수 있습니다.

    시작하기 전에

    필요한 역할: admin 또는 애플리케이션의 개발자나 관리자를 위한 특정 역할
    주:
    애플리케이션별 관리자 역할 및 위임된 개발에 대한 자세한 내용은 애플리케이션 관리 앱의 액세스 제어 규칙위임된 개발 및 배포를 참조하세요.

    이 태스크 정보

    정의 확장점의 콘텐츠 및 구조입니다. 이 정의는 사용자 지정을 구성하는 방법, 응용 프로그램 코드와 상호 작용하는 방법 및 확장점에서 사용자 지정에 의해 반환되는 데이터가 처리되는 방법을 설명해야 합니다.

    좋은 정의를 만들면 확장 기능의 구조를 제공할 수 있습니다.

    프로시저

    1. 다음으로 이동 모두 > 시스템 확장점 > UI 확장점.
    2. 새로 만들기를 클릭합니다.
    3. 양식의 필드에 내용을 입력합니다.
      표 1. UI 확장점 양식
      필드 설명
      이름 확장점의 고유한 이름입니다. 이름은 특수 문자를 포함하여 최대 100자의 영숫자일 수 있습니다.
      API 이름 적용되는 애플리케이션 범위가 앞에 추가되는 확장점 API의 이름입니다. 시스템에서 할당한 이름이며 변경할 수 없습니다.
      애플리케이션 확장점이 할당되는 애플리케이션 범위입니다. 이는 시스템에서 할당하며 변경할 수 없습니다. 범위 지정을 사용하여 제공되는 보호에 대한 자세한 내용은 다음 문서를 참조하십시오 Application scope.
      이 범위로 제한 확장점을 애플리케이션 범위로만 제한하는 옵션입니다.
      AJAX/REST에 대해 접근 허용 AJAX 또는 REST를 통해 UI 확장점에 대한 액세스를 활성화하거나 비활성화하는 옵션입니다.

      이러한 개발 아키텍처 및 기술에 대한 자세한 내용은 및 REST APIs를 참조하십시오AJAX.

      설명 사용자 지정 스크립트에 대한 요구 사항 UI 매크로, UI 스크립트를 구성하는 방법, 애플리케이션 코드로 작동하는 방법 등이 포함됩니다.
      예제 사용자 지정 UI 매크로 방법의 예 이 확장점과 상호 작용하는 것은 애플리케이션 코드와 함께 작동하도록 구조화되어야 합니다.
    4. 제출을 클릭합니다.

    기본 애플리케이션 코드에 UI 확장점 추가

    기본 애플리케이션 코드의 UI 매크로 또는 HTML 확장에 UI 확장점을 추가합니다. 확장점을 추가하려면 등록된 사용자 지정 아티팩트가 실행되는 위치를 식별하는 API 호출을 배치합니다.

    시작하기 전에

    필요한 역할: admin 또는 애플리케이션의 개발자나 관리자를 위한 특정 역할

    애플리케이션 코드의 UI 매크로 또는 UI 페이지에 추가하려면 먼저 UI 확장점을 만들어야 합니다.

    주:
    애플리케이션별 관리자 역할 및 위임된 개발에 대한 자세한 내용은 애플리케이션 관리 앱의 액세스 제어 규칙위임된 개발 및 배포를 참조하세요.

    프로시저

    1. 애플리케이션 코드에서 스크립팅된 확장점을 추가하거나 새 확장점을 만들려는 기존 UI 매크로에 액세스합니다.
      jelly 태그를 사용하여 UI 매크로를 만드는 방법에 대한 자세한 내용은 및 Jelly 태그를 참조하십시오UI 매크로.
    2. UI 매크로에서 사용자 지정 UI 매크로 출력을 수집하고 처리할 것으로 예상되는 위치에 코드 줄이 있는 jelly 태그를 추가합니다.
      일반적으로 이 코드 줄에는 다음이 포함됩니다.
      • UI 확장점의 이름을 식별하는 call_extension 명령입니다(예: extension="global. KMArticle.ViewHeader")를 사용하여 사용자 지정 UI 매크로를 등록할 수 있습니다.
      • UI 매크로가 렌더링될 때 UI 매크로에 전달되는 인수입니다. 예를 들어 문서의 경우 지식베이스knowledgerecord="${knowledgeRecord}" 가 현재 Knowledge 기록으로 전달됩니다.
      • (선택 사항) 이 확장점의 구현이 여러 개 있는 경우 limit 명령을 사용하면 x개의 구현이 반환되도록 지정합니다(예: limit="1"). 이 그림에서는 이러한 명령이 포함된 UI 매크로를 보여 줍니다.

      애플리케이션 코드에서 call_extension 명령이 있는 UI 확장점