UI 확장점 생성 및 추가

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기3분
  • 애플리케이션을 개발할 때 UI 확장점을 만들어 HTML 확장과 같은 서버측 UI 매크로나 기본 애플리케이션 코드의 UI 페이지에 추가합니다.

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

    UI 확장점 생성

    애플리케이션 코드에서 HTML 확장과 같은 UI 매크로에 배치할 수 있는 UI 확장점을 만듭니다. UI 확장점을 배치하면 응용 프로그램 코드에서 데이터나 개체를 사용자 지정으로 보낼 수 있는 위치와 데이터가 반환되는 특정 위치를 지정할 수 있습니다.

    시작하기 전에

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

    이 태스크 정보

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

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

    프로시저

    1. 다음으로 이동 모두 > 시스템 확장점 > UI 확장점.
    2. 새로 만들기를 클릭합니다.
    3. 양식의 필드에 내용을 입력합니다.
      표 1. UI 확장점 양식
      필드 설명
      이름 확장점의 고유한 이름입니다. 이름은 특수 문자를 포함하여 최대 100자의 영숫자일 수 있습니다.
      API 이름 확장점 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 매크로가 렌더링될 때 전달되는 인수입니다. 예를 들어 문서의 경우 지식베이스knowledgerecord="${knowledgeRecord}" 가 현재 지식 기록에 전달됩니다.
      • (선택 사항) 이 확장점의 구현이 여러 개 있는 경우 limit 명령을 사용하면 x개의 구현이 반환되도록 지정됩니다(예: limit="1"). 이 그림은 이러한 명령을 포함하는 UI 매크로를 보여줍니다.

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